
Lean comments
Audits, writes, and refines maintained first-party source-code comments and declaration-level documentation across languages
- Scripts
- None
- Platforms
- Claude Code, Codex, Cursor
- GitHub stars
- 41.3K
- Last commit
- 1 day ago
- License
- MIT
- Listing updated
- today
When your agent uses it
Audits, writes, and refines maintained first-party source-code comments and declaration-level documentation across languages. Use when adding, editing, reviewing, cleaning up, or auditing comments, doc comments, docstrings, TODO, FIXME, NOTE, suppressions, or other source commentary, including while modifying code and deciding whether a comment is warranted at all. Defaults to no comment unless it preserves meaningful, non-obvious information that cannot reasonably be recovered from the code or nearby repository context.
From the skill's SKILL.md. Your agent reads this description to decide when to load the skill.
What it can access
From a static check of its 1 file (21 KB) on GitHub on 17 November 2026. Nothing was run. Read the files before you install a skill: it can tell your agent to run anything its tools allow.
Install
Copy the skill folder to ~/.claude/skills/lean-comments to use it in all your projects:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/lean-comments &&
cp -R "$tmp/skills/lean-comments" ~/.claude/skills/lean-comments &&
rm -rf "$tmp"For one project only, put the folder in .claude/skills/lean-comments inside it instead.
Copy the skill folder to ~/.agents/skills/lean-comments to use it in every repository:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/lean-comments &&
cp -R "$tmp/skills/lean-comments" ~/.agents/skills/lean-comments &&
rm -rf "$tmp"For one repository only, put the folder in .agents/skills/lean-comments inside it instead.
Copy the skill folder to ~/.cursor/skills/lean-comments to use it in every project:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/lean-comments &&
cp -R "$tmp/skills/lean-comments" ~/.cursor/skills/lean-comments &&
rm -rf "$tmp"For one project only, put the folder in .cursor/skills/lean-comments inside it instead.
Run in a terminal (add --scope workspace to install it for the current workspace only):
gemini skills install https://github.com/github/awesome-copilot.git --path skills/lean-commentsOr copy the folder to ~/.gemini/skills/lean-comments yourself.
For GitHub Copilot in VS Code, copy the skill folder to ~/.copilot/skills/lean-comments:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/lean-comments &&
cp -R "$tmp/skills/lean-comments" ~/.copilot/skills/lean-comments &&
rm -rf "$tmp"For one project only, put the folder in .github/skills/lean-comments inside it instead.
Get the folder:
git clone --depth 1 https://github.com/github/awesome-copilot.gitThen copy awesome-copilot/skills/lean-comments into your agent's skills folder as lean-comments. Agents that support SKILL.md read one folder per skill.
Lean comments FAQ
How do I install Lean comments in Claude Code?
Copy the skill folder from GitHub to ~/.claude/skills/lean-comments to use it in all your projects, or to .claude/skills/lean-comments in one project.
Does Lean comments run scripts?
No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.
Which AI agents can use Lean comments?
Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.
More from github/awesome-copilot

Design or review infrastructure, deployment, CI/CD, Docker, Kubernetes, health checks, rollback, feature flags, production readiness, and mo
- Open source
- 41.3K GitHub stars
- Cloud and infrastructure


Cross-references C# Web API controllers/DTOs against their TypeScript/JavaScript consumers (React, Angular, Vue, Svelte, Node.js, or hand-wr
- Open source
- 41.3K GitHub stars

Instrument a webapp to send useful telemetry data to Azure App Insights
- Open source
- 41.3K GitHub stars

Serves as a reviewer of the codebase with instructions on looking for Apple App Store optimizations or rejection reasons.
- Open source
- 41.3K GitHub stars

Triage and resolve Arch Linux issues with pacman, systemd, and rolling-release best practices.
- Open source
- 41.3K GitHub stars