brain-to-docs – Other skill for AI agents
Interview the user to turn project vision and decisions into README and ADR documentation.
Install the brain-to-docs skill with one command
Pick the tool you use, copy the command and paste it in your terminal. The skill lands in that tool's skills folder and is ready in your next session.
Claude Code
mkdir -p ~/.claude/skills && curl -fsSL https://skill.dn1nguoi.com/z/brain-to-docs-ec1c9.tgz | tar xz -C ~/.claude/skills
Call it in Claude Code: /brain-to-docs – then describe the task you want done.
Codex
mkdir -p ~/.codex/skills && curl -fsSL https://skill.dn1nguoi.com/z/brain-to-docs-ec1c9.tgz | tar xz -C ~/.codex/skills
Call it in Codex: $brain-to-docs – then describe the task you want done.
Hermes Agent
mkdir -p ~/.hermes/skills && curl -fsSL https://skill.dn1nguoi.com/z/brain-to-docs-ec1c9.tgz | tar xz -C ~/.hermes/skills
Call it in Hermes Agent: /brain-to-docs – then describe the task you want done.
DeepSeek
mkdir -p ~/.deepcode/skills && curl -fsSL https://skill.dn1nguoi.com/z/brain-to-docs-ec1c9.tgz | tar xz -C ~/.deepcode/skills
Call it in DeepSeek: /brain-to-docs – then describe the task you want done.
SKILL.md content
brain-to-docs
When to Use
- Use when the user wants to extract project vision, decisions, or preferences into durable docs.
- Use when README and ADRs should be built through a back-and-forth interview.
The whole purpose: extract as much of the user's taste, judgment, knowledge, vision,
preferences, and decisions as possible into text — saved as clear, concise
markdown docs for the project. README holds the vision; docs/adr/ holds the
decisions.
The loop
1. Check docs first, every time. Read docs/adr/ (and README.md) before
doing anything — other agents and people add/edit ADRs constantly.
2. Ask a small set of focused questions through the host's supported question interface or plain text — default 2–3
unless the user asks for a different number. Make them high-variety: a wide,
creative spectrum of unique angles, not all the same type (e.g. not all "tech
stack" or all "product" or all "monetization"). Exception: if the user asks for a
specific focus area, follow it. The user answers whichever they find most useful.
3. Integrate confirmed answers into the authorized docs. Preserve unanswered questions and distinguish tentative ideas from accepted decisions. You decide whether it
updates README.md or becomes a new ADR — whatever makes sense.
4. Repeat until the user says "we're done" (or similar).
Rules
- All answers & responses during this "brain to docs" process must be VERY
CONCISE, all sentences should be SHORT, and everything should be written in
the user's requested language.
- ADRs: short, numbered
NNNN-slug.md, Status + Context + Decision + Consequences. - README: preserve existing installation, usage, and contributor sections. Add vision where it fits; detailed decisions go in ADRs.
- Don't challenge the user's thinking unless they ask, or they're making a severe mistake.
Example
User request:
> Extract project vision, decisions, or preferences into durable docs.
Limitations
- Adapted from
davidondrej/skills; verify local paths, tools, credentials, and agent features before acting. - For commands, remote access, scheduling, browser automation, or file-changing workflows, get explicit user approval and confirm the target environment first.
Related skills
- founder-coach – Personal leadership development for founders and first-time CEOs. Covers founder…
- neuroskill-bci – Use live BCI cognitive and mood state from NeuroSkill.
- broken-link-finder – Broken Link Finder. Use when working with page URL, HTML or a list of links.
- full-page-screenshot – Use when the user asks to capture a full-page screenshot, long screenshot, or complete…
- buddy-program-manager – Buddy programme register: new hire, assigned buddy, department, start and end dates…
- budget-cash-flow – Budget against actual by department, category and period, with budget and actual…
- obsidian – Read, search, create, and edit notes in the Obsidian vault.
- busabase – Use when managing Busabase workspace records, knowledge, apps, or skills through…