How to use the Python Script Tutorial Maker agent skill

What the skill makes the agent do

The skill asks the agent to do three things to a Python script. First, it refactors the code: it applies standard Python best practices, makes sure the code follows the PEP 8 style guide, and renames unclear variables and functions. Second, it adds comments throughout the code, written in a beginner-friendly tone that explains what each part does and why it matters, focusing on logic and reasoning rather than syntax. Third, it generates a README.md tutorial.

• Refactor: best practices, PEP 8 style, clearer names
• Comments: instructional, explain reasoning, avoid superficial comments
• README.md sections: Project Overview, Setup Instructions, How It Works, Example Usage, and optional Sample Output

Install the skill from the ZIP download

Download the ZIP for this skill from this page and unzip it. The skill is a single file, SKILL.md, so the unzipped folder should contain that file. Place the folder in one of two locations. For a personal install available across your projects, put it in ~/.claude/skills/. For a single project, put it in that project's .claude/skills/ folder.

If you use the Claude apps instead, you can upload the ZIP under Settings → Capabilities → Skills rather than copying files by hand.

• Personal: ~/.claude/skills/comment-code-generate-a-tutorial/
• Project: .claude/skills/comment-code-generate-a-tutorial/ inside your project
• Claude apps: Settings → Capabilities → Skills, then upload the ZIP

Trigger the skill with a natural request

You do not need a special command. Give the agent your Python script and ask in plain language for it to be turned into a tutorial project. The skill's description is about transforming a Python script into a polished, beginner-friendly project with comments and a markdown tutorial, so requests that describe that goal are the ones that match it.

Useful phrasings include asking the agent to refactor and comment a script for beginners, to make a script ready to share on GitHub, or to write a README.md explaining how a script works.

• "Refactor and comment this Python script so a beginner can follow it, then write a README.md."
• "Tidy up my script for GitHub: apply PEP 8, rename unclear names, and explain how it works."
• "Turn this Python file into a sample project for my students with a setup guide and example usage."

Check the output before you rely on it

The source states that refactoring can change behaviour. Run your original script and the refactored version on the same inputs and compare the results before you share or submit the code. Read the generated comments too, since they describe the reasoning the agent inferred from the code.

The README includes Sample Output only if the script returns visible results, so expect that section to be optional.

• Run the original and refactored scripts on the same inputs and compare results
• Confirm the README's setup steps actually work on a clean machine
• Edit any comment that describes logic incorrectly

Safety notes: scripts and network access

This skill is a set of written instructions only. It contains no scripts of its own, does not run scripts, and does not use the network. It has no listed requirements. The main risk is the code change itself: refactoring large or security-sensitive codebases is not recommended without careful review and testing.

• Runs scripts: no
• Uses network: no
• Requires: nothing listed
• Not suited to large or security-sensitive codebases, or non-Python code