comment-code-generate-a-tutorial

comment-code-generate-a-tutorial is an agent skill from the github/awesome-copilot collection that turns a Python script into a polished, beginner-friendly project with a markdown tutorial. It works in three steps. It refactors the code, applying standard Python practices and PEP 8 style, and renaming unclear variables and functions where that helps understanding. It adds instructional comments throughout the code that explain the logic and the reasoning behind it, in a beginner-friendly tone, focusing on why each part matters rather than repeating what the syntax says, and it avoids redundant or superficial comments. It then generates a complete markdown tutorial that walks a reader through the project. The result is a version of the script that a learner can read and follow, and that a teacher can use as course material. The skill is useful for educators, for people turning a personal script into something a colleague can understand, and for building a learning resource around existing code. Refactoring changes the code, so the team should run the tests or try the script before and after the change to confirm its behavior is the same. The comments and tutorial should be checked for accuracy, since the agent explains code that it may have misread. The skill is installed with the skills CLI from the github/awesome-copilot repository. Its skills.sh page showed about 8.9K installs and passing results from three security audits at the time of the scan.…