Brain to Docs
Use when David wants to extract project vision, decisions, and preferences from his head into clear documentation (README + ADRs) through a back-and-forth Q&A loop. Triggers on "brain-to-docs", "build out the docs", "extract the vision", "let's document this project".
Install
npx skills add adriannoes/awesome-agentic-ai --skill brain-to-docsgit clone --depth 1 https://github.com/adriannoes/awesome-agentic-ai.git /tmp/awesome-agentic-ai
mkdir -p ~/.claude/skills
cp -r /tmp/awesome-agentic-ai/cursor-claude-codex/skills/david-ondrej/thinking-and-docs/brain-to-docs ~/.claude/skills/brain-to-docsPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# brain-to-docs The whole purpose: extract as much of David'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 5 different questions** in plain text (never a questions UI) — default 5 unless David 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 David asks for a specific focus area, follow it. David answers whichever he finds most useful. 3. **Update docs after EVERY answer** — no exceptions. You decide whether it updates `README.md` or becomes a new ADR — whatever makes sense. 4. Repeat until David 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 PLAIN ENGLISH. - ADRs: short, numbered `NNNN-slug.md`, Status + Context + Decision + Consequences. - README: vision only. Decisions go in ADRs. - Don't challenge David's thinking unless he asks, or he's making a severe mistake.
Details
- Skill name
brain-to-docs- Repository
- adriannoes/awesome-agentic-ai
- Path
cursor-claude-codex/skills/david-ondrej/thinking-and-docs/brain-to-docs/SKILL.md- License
- MIT
- Repo updated
- 2 November 2026
FAQ
What does the Brain to Docs skill do?
Use when David wants to extract project vision, decisions, and preferences from his head into clear documentation (README + ADRs) through a back-and-forth Q&A loop. Triggers on "brain-to-docs", "build out the docs", "extract the vision", "let's document this project".
How do I install the Brain to Docs skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add adriannoes/awesome-agentic-ai --skill brain-to-docs. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Brain to Docs popular?
It lives in adriannoes/awesome-agentic-ai, which has 100 GitHub stars and 27 forks, and is included in 2 curated skill lists.
Related skills
Browserstack
100adriannoes/awesome-agentic-ai
Run tests on BrowserStack. Use when user mentions "browserstack", "cross-browser", "cloud testing", "browser matrix", "test on safari", "test on firefox", or "browser compatibility".
Coverage
100adriannoes/awesome-agentic-ai
Analyze test coverage gaps. Use when user says "test coverage", "what's not tested", "coverage gaps", "missing tests", "coverage report", or "what needs testing".
Fix
100adriannoes/awesome-agentic-ai
Fix failing or flaky Playwright tests. Use when user says "fix test", "flaky test", "test failing", "debug test", "test broken", "test passes sometimes", or "intermittent failure".
D2 Diagram Creator
100adriannoes/awesome-agentic-ai
Create d2 diagram creator operations. Auto-activating skill for Visual Content. Triggers on: d2 diagram creator, d2 diagram creator Part of the Visual Content skill category. Use when working with d2 diagram creator functionality. Trigger with phrases like "d2 diagram creator", "d2 creator", "d2".
Auditing Uefi Firmware with Chipsec
100adriannoes/awesome-agentic-ai
Use Intel CHIPSEC to assess platform firmware configuration, SPI flash write protection, BIOS lock, SMM/SMRR, and Secure Boot variable state, dump SPI flash, and triage UEFI variables for firmware-level threats.
Dev to Hashnode
88jonathimer/devmarketing-skills
When the user wants to publish on Dev.to, Hashnode, or other developer blogging platforms. Trigger phrases include "Dev.to," "Hashnode," "developer blog," "cross-posting," "technical blogging," "canonical URL," or "developer content platform.
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.