gentleman-programming/gentle-pi/cognitive-doc-design
Claude Code and agent skill by gentleman-programming/gentle-pi
- community
Checking that the SKILL.md file is still in the repository.
Design docs that reduce cognitive load. Trigger: writing guides, READMEs, RFCs, onboarding, architecture, or review-facing docs.
Install
npx vskill@latest install gentleman-programming/gentle-pi/cognitive-doc-designSKILL.md
The same SKILL.md was published earlier as gentleman-programming/gentle-pi/cognitive-doc-design.
When to Use
Load this skill when creating or editing documentation that people need to understand quickly, retain, or use during review.
Use it especially for:
- PR descriptions and review notes.
- Contributor or maintainer guides.
- Architecture, workflow, or onboarding docs.
- Any doc that currently feels long, dense, or hard to scan.
Critical Patterns
| Pattern | Rule | |
|---|---|---|
| Lead with the answer | Put the decision, action, or outcome first. Context comes after. | |
| Progressive disclosure | Start with the happy path, then add details, edge cases, and references. | |
| Chunking | Group related information into small sections. Keep flat lists short. | |
| Signposting | Use headings, labels, callouts, and summaries so readers know where they are. | |
| Recognition over recall | Prefer tables, checklists, examples, and templates over prose that must be remembered. | |
| Review empathy | Design docs so reviewers can verify intent without reconstructing the whole story. |
Documentation Shape
Use this default structure unless the repo already provides a stronger template:
PR and Review Docs
When documenting a PR, reduce reviewer burnout by making the review path explicit:
- State what to review first.
- State what is intentionally out of scope.
- Link the previous and next PR when work is chained.
- Keep each section focused on one decision or unit of work.
- Use checklists for acceptance criteria and verification.
Commands
Security
- Security scanPassed, 93 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/cognitive-doc-design/SKILL.md
Popularity
- Repository stars
- 154
- Repository forks
- 31
- 7-day trend score
- 25
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/gentleman-programming/gentle-pi/cognitive-doc-design)