Official agent skill

Add Educational Comments

by github in github/awesome-copilot

Add educational comments to the file specified, or prompt asking for file to comment if one is not provided.

OfficialMITAuto-check passed

Install Add Educational Comments

skills CLI
$ npx skills add github/awesome-copilot --skill add-educational-comments -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install github/awesome-copilot add-educational-comments --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/github/awesome-copilot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/add-educational-comments .claude/skills/add-educational-comments && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
add-educational-comments
GitHub stars
40k
Used in
2 other repos
Token cost
~1.6k tokens
SKILL.md length
761 words
Files
1
Skills in repo
417
Repo updated
First seen
Licence
MIT

At a glance

Add educational comments to the file specified, or prompt asking for file to comment if one is not provided.

  • Works in 3 steps: Transform the provided file by adding… → Maintain the file's structure, encoding,… → Increase the total line count by 125%…
  • SKILL.md covers Role, Objectives, Educational Commenting Rules and Workflow, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Add Educational Comments is an agent skill from github/awesome-copilot, published by the product's own GitHub organization. Add educational comments to the file specified, or prompt asking for file to comment if one is not provided.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Community-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot. The licence is MIT.

Example prompts

  • “/add-educational-comments”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Transform the provided file by adding educational comments aligned with the configuration.
  2. Maintain the file's structure, encoding, and build correctness.
  3. Increase the total line count by 125% using educational comments only (up to 400 new lines). For files already processed with this prompt…

What it can do on your machine

Read from SKILL.md and the folder at commit 727ff2e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • peps.python.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Add Educational Comments loads about 1.6k tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 761 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~33
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from github/awesome-copilot at commit 727ff2e, republished under its MIT licence (© github). 761 words, ~1,556 tokens.

Download SKILL.mdSave it as .claude/skills/add-educational-comments/SKILL.md (or your agent's skills folder).
name
add-educational-comments
description
Add educational comments to the file specified, or prompt asking for file to comment if one is not provided.

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

Objectives

  1. Transform the provided file by adding educational comments aligned with the configuration.
  2. Maintain the file's structure, encoding, and build correctness.
  3. Increase the total line count by 125% using educational comments only (up to 400 new lines). For files already processed with this prompt, update existing notes instead of reapplying the 125% rule.
Line Count Guidance
  • Default: add lines so the file reaches 125% of its original length.
  • Hard limit: never add more than 400 educational comment lines.
  • Large files: when the file exceeds 1,000 lines, aim for no more than 300 educational comment lines.
  • Previously processed files: revise and improve current comments; do not chase the 125% increase again.

Educational Commenting Rules

Encoding and Formatting
  • Determine the file's encoding before editing and keep it unchanged.
  • Use only characters available on a standard QWERTY keyboard.
  • Do not insert emojis or other special symbols.
  • Preserve the original end-of-line style (LF or CRLF).
  • Keep single-line comments on a single line.
  • Maintain the indentation style required by the language (Python, Haskell, F#, Nim, Cobra, YAML, Makefiles, etc.).
  • When instructed with Line Number Referencing = yes, prefix each new comment with Note <number> (e.g., Note 1).
Content Expectations
  • Focus on lines and blocks that best illustrate language or platform concepts.
  • Explain the "why" behind syntax, idioms, and design choices.
  • Reinforce previous concepts only when it improves comprehension (Repetitiveness).
  • Highlight potential improvements gently and only when they serve an educational purpose.
  • If Line Number Referencing = yes, use note numbers to connect related explanations.
Safety and Compliance
  • Do not alter namespaces, imports, module declarations, or encoding headers in a way that breaks execution.
  • Avoid introducing syntax errors (for example, Python encoding errors per PEP 263).
  • Input data as if typed on the user's keyboard.
Show full SKILL.md (361 more words)Show less

Workflow

  1. Confirm Inputs – Ensure at least one target file is provided. If missing, respond with: Please provide a file or files to add educational comments to. Preferably as chat variable or attached context.
  2. Identify File(s) – If multiple matches exist, present an ordered list so the user can choose by number or name.
  3. Review Configuration – Combine the prompt defaults with user-specified values. Interpret obvious typos (e.g., Line Numer) using context.
  4. Plan Comments – Decide which sections of the code best support the configured learning goals.
  5. Add Comments – Apply educational comments following the configured detail, repetitiveness, and knowledge levels. Respect indentation and language syntax.
  6. Validate – Confirm formatting, encoding, and syntax remain intact. Ensure the 125% rule and line limits are satisfied.

Configuration Reference

Properties
  • Numeric Scale: 1-3
  • Numeric Sequence: ordered (higher numbers represent higher knowledge or intensity)
Parameters
  • File Name (required): Target file(s) for commenting.
  • Comment Detail (1-3): Depth of each explanation (default 2).
  • Repetitiveness (1-3): Frequency of revisiting similar concepts (default 2).
  • Educational Nature: Domain focus (default Computer Science).
  • User Knowledge (1-3): General CS/SE familiarity (default 2).
  • Educational Level (1-3): Familiarity with the specific language or framework (default 1).
  • Line Number Referencing (yes/no): Prepend comments with note numbers when yes (default yes).
  • Nest Comments (yes/no): Whether to indent comments inside code blocks (default yes).
  • Fetch List: Optional URLs for authoritative references.

If a configurable element is missing, use the default value. When new or unexpected options appear, apply your Educational Role to interpret them sensibly and still achieve the objective.

Default Configuration
  • File Name
  • Comment Detail = 2
  • Repetitiveness = 2
  • Educational Nature = Computer Science
  • User Knowledge = 2
  • Educational Level = 1
  • Line Number Referencing = yes
  • Nest Comments = yes
  • Fetch List:

Examples

Missing File
text
[user]
> /add-educational-comments
[agent]
> Please provide a file or files to add educational comments to. Preferably as chat variable or attached context.
Custom Configuration
text
[user]
> /add-educational-comments #file:output_name.py Comment Detail = 1, Repetitiveness = 1, Line Numer = no

Interpret Line Numer = no as Line Number Referencing = no and adjust behavior accordingly while maintaining all rules above.

Final Checklist

  • Ensure the transformed file satisfies the 125% rule without exceeding limits.
  • Keep encoding, end-of-line style, and indentation unchanged.
  • Confirm all educational comments follow the configuration and the Educational Commenting Rules.
  • Provide clarifying suggestions only when they aid learning.
  • When a file has been processed before, refine existing comments instead of expanding line count.

© github, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/add-educational-comments of github/awesome-copilot.

Open the folder on GitHubat commit 727ff2e

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in github/awesome-copilot, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Add Educational Comments next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Add Educational Comments compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Add Educational Comments this skillgithub/awesome-copilot40k2 repos~1.6kAutomated safety check: PassMIT
Ask Advisor RoutingYeachan-Heo/oh-my-claudecode40k—~572Automated safety check: PassMIT
No Commentscursor/plugins10k7 repos~640Automated safety check: PassNone
Commentsanthropics/claude-for-legal9.6k1 repos~1kAutomated safety check: PassApache-2.0
AskSeemSeam/claude_codex_bridge3.5k—~1.2kAutomated safety check: PassCustom licence
AskSeemSeam/claude_codex_bridge3.5k—~221Automated safety check: PassCustom licence

Similar skills

  • Ask Advisor Routing

    Yeachan-Heo/oh-my-claudecode

    Sends a question or task to another locally installed agent CLI, such as Codex or Gemini, through omc ask and saves the answer as a file.

    40k GitHub stars~572 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • No Comments

    cursor/plugins

    Official

    Spawn Comment Sicko, fix accepted findings, and offer encodings for claimed constraints.

    10k GitHub starsUsed in 7 repos~640 tokens
    Auto-check passed
  • Comments

    anthropics/claude-for-legal

    Official

    Review open NPRM comment periods, log decisions, track deadlines.

    9.6k GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Ask

    SeemSeam/claude_codex_bridge

    Delegate work or request information from another CCB-managed agent using ask.

    3.5k GitHub stars~1.2k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Ask

    SeemSeam/claude_codex_bridge

    Send a request to another CCB agent with ask. An agent skill from SeemSeam/claude_codex_bridge.

    3.5k GitHub stars~221 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Clean Up Comments

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing templates, rendered HTML, or shared components related to Remove comments and debug code in production.

    74k GitHub stars~435 tokensUpdated yesterday
    Auto-check passed

More from github/awesome-copilot

All 417 skills in this repo
  • Acquire Codebase Knowledge

    github/awesome-copilot

    Official

    Maps an unfamiliar codebase into seven evidence-backed documents in docs/codebase/, using a scan script and templates, for onboarding or architecture write-ups.

    40k GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Azure Architecture Autopilot

    github/awesome-copilot

    Official

    Designs Azure infrastructure from a natural-language description, or diagrams an existing resource group, then refines the design through conversation and deploys it with Bicep.

    40k GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Draw.io Diagram Generator

    github/awesome-copilot

    Official

    Generates, edits and validates draw.io files with correct mxGraph XML, covering flowcharts, architecture, sequence, ER and UML class diagrams.

    40k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed
  • Credit Risk Data Cleaning

    github/awesome-copilot

    Official

    Cleans raw credit data and screens variables before loan modeling, dropping unstable, noisy or redundant features and writing an Excel report of every step.

    40k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Daily Focus Board

    github/awesome-copilot

    Official

    Builds a warm, browser-based daily focus board the user updates by talking to their agent, with Eisenhower priorities, a brain-dump box and kind not-today carryover.

    40k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Python Pypi Package Builder

    github/awesome-copilot

    Official

    End-to-end skill for building, testing, linting, versioning, and publishing a production-grade Python library to PyPI.

    40k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed

Questions about Add Educational Comments

What does Add Educational Comments do?

Add educational comments to the file specified, or prompt asking for file to comment if one is not provided. Add Educational Comments is an agent skill from github/awesome-copilot, published by the product's own GitHub organization. Add educational comments to the file specified, or prompt asking for file to comment if one is not provided.

How do I install Add Educational Comments in Claude Code?

Run `npx skills add github/awesome-copilot --skill add-educational-comments -a claude-code`. Or copy the skill folder (skills/add-educational-comments in github/awesome-copilot) into .claude/skills/add-educational-comments in your project. Claude Code loads it when a task matches its description.

How do I install Add Educational Comments in Codex?

Run `npx skills add github/awesome-copilot --skill add-educational-comments -a codex`. Or copy the skill folder (skills/add-educational-comments in github/awesome-copilot) into .agents/skills/add-educational-comments in your project. Codex loads it when a task matches its description.

Can I use Add Educational Comments in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add github/awesome-copilot --skill add-educational-comments -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add-educational-comments, .gemini/skills/add-educational-comments, .github/skills/add-educational-comments and .opencode/skills/add-educational-comments in your project.

What does Add Educational Comments need to run?

SKILL.md names no scripts, command-line tools or credentials: Add Educational Comments is instructions for the agent only. Our summary lists: Python 3.

Does Add Educational Comments access the network?

SKILL.md names 1 domain. As links in the text: peps.python.org. This is read from the text; nothing was executed.

Is Add Educational Comments safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Add Educational Comments use?

Add Educational Comments is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Add Educational Comments use?

About 1.6k tokens (SKILL.md is roughly 6.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Add Educational Comments?

Skills that share tags, products or a category with Add Educational Comments: Ask Advisor Routing (Yeachan-Heo/oh-my-claudecode, 40k stars), No Comments (cursor/plugins, 10k stars), Comments (anthropics/claude-for-legal, 9.6k stars) and Ask (SeemSeam/claude_codex_bridge, 3.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Add Educational Comments?

github (a GitHub organization, an official publisher) maintains it in github/awesome-copilot, which has 39,748 GitHub stars. The repository holds 417 skills in this directory. The repository was last updated on October 7, 2026.

Source: github/awesome-copilot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.