About

Imported from sickn33/agentic-awesome-skills (plugins/agentic-awesome-skills-claude/skills/brain-to-docs/SKILL.md). Install upstream with npx skills add sickn33/agentic-awesome-skills --skill brain-to-docs. Copyright stays with the author (MIT).

brain-to-docs

Name: brain-to-docs
Author: sickn33

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

Check docs first, every time. Read docs/adr/ (and README.md) before doing anything — other agents and people add/edit ADRs constantly.
Ask 5 different questions in plain text (never a questions UI) — default 5 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.
Update docs after EVERY answer — no exceptions. You decide whether it updates README.md or becomes a new ADR — whatever makes sense.
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 PLAIN ENGLISH.
ADRs: short, numbered NNNN-slug.md, Status + Context + Decision + Consequences.
README: vision only. 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.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/sickn33-agentic-awesome-skills-brain-to-docs/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

sickn33-agentic-awesome-skills-brain-to-docs.ocm.jsonjson

{
  "ocm": "1",
  "id": "sickn33-agentic-awesome-skills-brain-to-docs",
  "kind": "skill",
  "name": "brain-to-docs",
  "description": "Interview the user to turn project vision and decisions into README and ADR documentation.",
  "publisher": "sickn33",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "documentation",
      "adr",
      "planning",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Interview the user to turn project vision and decisions into README and ADR documentation."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/sickn33/agentic-awesome-skills",
      "path": "plugins/agentic-awesome-skills-claude/skills/brain-to-docs/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/sickn33/agentic-awesome-skills/blob/HEAD/plugins/agentic-awesome-skills-claude/skills/brain-to-docs/SKILL.md",
      "key": "sickn33/agentic-awesome-skills/plugins/agentic-awesome-skills-claude/skills/brain-to-docs/SKILL.md"
    },
    "license": "MIT"
  },
  "instructions": "# brain-to-docs\n\n## When to Use\n\n- Use when the user wants to extract project vision, decisions, or preferences into durable docs.\n- Use when README and ADRs should be built through a back-and-forth interview.\n\nThe whole purpose: extract as much of the user's taste, judgment, knowledge, vision,\npreferences, and decisions as possible into text — saved as clear, concise\nmarkdown docs for the project. README holds the vision; `docs/adr/` holds the\ndecisions.\n\n## The loop\n\n1. **Check docs first, every time.** Read `docs/adr/` (and `README.md`) before\n   doing anything — other agents and people add",
  "cost": {
    "context_tokens": 507
  }
}

Fetch it by URL: GET /api/v1/registry/sickn33-agentic-awesome-skills-brain-to-docs/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.