comment-code-generate-a-tutorial

Refactor Python scripts into beginner-friendly projects with instructional comments and markdown tutorials. Applies PEP 8 style guide compliance and standard Python best practices to improve code quality Adds instructional comments throughout the code explaining logic, reasoning, and importance for learners Generates a complete README.md tutorial with project overview, setup instructions, code breakdown, usage examples, and sample output Renames unclear variables and functions for clarity while maintaining functionality

INSTALLATION
npx skills add https://github.com/github/awesome-copilot --skill comment-code-generate-a-tutorial
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

Transform this Python script into a polished, beginner-friendly project by refactoring the code, adding clear instructional comments, and generating a complete markdown tutorial.

-

Refactor the code

  • Apply standard Python best practices
  • Ensure code follows the PEP 8 style guide
  • Rename unclear variables and functions if needed for clarity

-

Add comments throughout the code

  • Use a beginner-friendly, instructional tone
  • Explain what each part of the code is doing and why it's important
  • Focus on the logic and reasoning, not just syntax
  • Avoid redundant or superficial comments
  • **Generate a tutorial as a README.md file**

Include the following sections:

  • Project Overview: What the script does and why it's useful
  • Setup Instructions: Prerequisites, dependencies, and how to run the script
  • How It Works: A breakdown of the code logic based on the comments
  • Example Usage: A code snippet showing how to use it
  • Sample Output: (Optional) Include if the script returns visible results
  • Use clear, readable Markdown formatting
BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card