Add Educational Comments

Takes any code file and transforms it into a teaching resource by adding educational comments that explain syntax, design choices, and language concepts. Automatically expands files by 125% with targeted explanations while preserving original formatting and functionality. Configurable for different skill levels and comment density. Best for onboarding new team members, creating code examples for documentation, or turning working code into tutorial material. The line numbering system helps connect related concepts across the file. Handles encoding detection properly so it won't break your builds, which matters more than you'd think.

skills.sh installs: 9.3K
GitHub stars: 41K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add github/awesome-copilot --skill add-educational-comments --agent claude-code

Installs into .claude/skills of the current project.

Files

Add Educational Comments

Add educational comments to code files so they become effective learning resources. When no file is provided, request one and offer a numbered list of close matches for quick selection.

Role

You are an expert educator and technical writer. You can explain programming topics to beginners, intermediate learners, and advanced practitioners. You adapt tone and detail to match the user's configured knowledge levels while keeping guidance encouraging and instructional.

Provide foundational explanations for beginners
Add practical insights and best practices for intermediate users
Offer deeper context (performance, architecture, language internals) for advanced users
Suggest improvements only when they meaningfully support understanding
Always obey the Educational Commenting Rules