Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add clhbid/agent-context --skill writing-lean -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/writing-lean/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/writing-lean/

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.

Similar skills

All skills for Writing and docs →

From the same set8

Project sponsors

Companies that keep this analytics open