cognitive-doc-design

by Gentleman-Programming7.8k

Developer Tools

Design docs that reduce cognitive load. Trigger: writing guides, READMEs, RFCs, onboarding, architecture, or review-facing docs.

Install

The skill file stays in the publisher's repository.

Paste the copied command in a terminal. It installs this SKILL.md into that agent.

npx skills add Gentleman-Programming/gentle-ai --skill cognitive-doc-design -a cursor -y

How do I install cognitive-doc-design?: Download internal/assets/skills/cognitive-doc-design/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
Where does cognitive-doc-design live?: The publisher keeps it at https://github.com/Gentleman-Programming/gentle-ai.
Which agents can use cognitive-doc-design?: Claude, Cursor, and Codex can read a SKILL.md you add from the publisher's repository.

Load this skill when creating or editing documentation that people need to understand quickly, retain, or use during review.

Use it especially for:

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.