cognitive-doc-design

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/martinhg-cognitive-doc-design

About

Use cases: documents, design, writing

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.

Tools

No tools found

Secrets

None asked for

Install scripts

None found

What's inside

Skill name

cognitive-doc-design

Description

Write docs that reduce cognitive load. Trigger: writing READMEs, guides, RFCs, or architecture docs.

License

MIT

Instructions

21 lines in SKILL.md · view on GitHub

## Goal

A reader should get what they need with the least effort. Optimize for scanning
and for the reader's question, not for completeness.

## How

- **Lead with the conclusion.** Put the answer first, details after.
- **One idea per section**; use headings the reader can scan to find their question.
- Prefer a **concrete example** over abstract prose. Show the command, the output,
  the file.
- Use tables for comparisons; lists for steps; short paragraphs for the rest.
- Cut hedging and filler. If a sentence doesn't help the reader act, remove it.
- Name things consistently with the code (`internal/sdd`, `copilot-instructions.md`).

## Structure for a guide

What it is → why it matters → how to use it (steps) → gotchas. Mirror the
parity doc and the SDD skills in this repo.

Signals

Stars

2

Forks

0

Open issues

1

Last commit (this folder)

Jun 6, 2026 (4 months ago)

Last release

Oct 13, 2026 (16 days ago)

From GitHub (fetched Oct 24, 2026).

Details

License

MIT

Repository

github.com/martinhg/capiko-ai

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

GitHubgithub-graphql