writing-lean — Claude Code skill: what it does, how to install
The writing-lean Claude Code skill guides concise code and project writing. It applies to edits in comments, docs, issues, pull requests, reviews, and commit messages.
no license 769 installs updated 2026-11-16
npx skills add clhbid/agent-context --skill writing-lean -a claude-codeWhat writing-lean does
The skill sets out how to keep code and its surrounding text clear: improve a name, function, or spec before adding explanation. It also calls for one consistent project term per concept. Short and direct.
Comments are for constraints, traps, citations, or reasons a reader cannot infer. README covers the common path; decisions and history belong with the related issue, pull request, or commit. Each sentence faces a deletion test: if removing it costs the reader nothing, the code already carries the information. A code link to an issue belongs there only when that issue affects later changes.
Install it in Claude Code with npx skills add clhbid/agent-context --skill writing-lean -a claude-code. The skill file is at ~/.claude/skills/writing-lean/SKILL.md.
What it helps with
- trim comments that merely restate the code
- keep terminology consistent across a project
- place decision history in the relevant issue or pull request
- write a review comment around one finding and its fix
Example prompts for the agent
- Edit this comment so it keeps only the constraint and the reason readers cannot infer.
- Rewrite the README around the usual usage path and where to go next.
- Draft a pull request message that explains the change and its reason.
How to install writing-lean
1Skills CLI (Vercel)
npx skills add clhbid/agent-context --skill writing-lean -a claude-code2Manually: put the files in place
~/.claude/skills/writing-lean/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/writing-lean/
1Skills CLI (Vercel)
npx skills add clhbid/agent-context --skill writing-lean -a codex2Manually: put the files in place
.agents/skills/writing-lean/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add clhbid/agent-context --skill writing-lean -a cursor2Manually: put the files in place
.cursor/skills/writing-lean/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install clhbid/agent-context skills/writing-lean2Manually: put the files in place
.github/skills/writing-lean/SKILL.md1Skills CLI (Vercel)
npx skills add clhbid/agent-context --skill writing-lean -a gemini-cli2Platform CLI
gemini skills install https://github.com/clhbid/agent-context --path skills/writing-leanManually: put the files in place
.devin/skills/writing-lean/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add clhbid/agent-context --skill writing-lean -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about writing-lean
How do I install writing-lean in Claude Code?
Run npx skills add clhbid/agent-context --skill writing-lean -a claude-code. The skill file is at ~/.claude/skills/writing-lean/SKILL.md.
What does writing-lean do?
It gives an agent guidance for concise code and project writing, including consistent terminology and where to put explanations or decision history.
How does writing-lean decide whether a sentence belongs?
Apply a deletion test: if removing the sentence costs a competent reader nothing, the code or spec already conveys the point.