# Documentation Architect

The Documentation Architect skill reads a codebase and builds technical docs for architecture, APIs, feature plans, and developer onboarding.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install
- Author: amo-tech-ai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/amo-tech-ai/event-studio/tree/HEAD/.claude/skills/docs-architect/SKILL.md
- Updated: 2025-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/documentation-architect

## What it does

Documentation Architect examines project structure, component relationships, and recurring implementation patterns before shaping the requested documentation. It can cover system architecture, existing features, API references, integration guides, onboarding material, and implementation plans. Mermaid diagrams, real code samples, source-file links, validation points, and Task Master task breakdowns can be part of the result.

For MVP work, the skill uses a numbered set from `001-overview.md` through `009-workflow-checklist.md`. The set covers the project overview, architecture, setup, core features, workflows, advanced features, conventions, success criteria, and task tracking. Its workflow moves through discovery, structure, generation, and validation. Ask for MVP documentation explicitly when you need the `001-009` set.

The skill has install instructions for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. The available examples rely on Task Master, Mermaid, and code taken from the project, so a request can include task dependencies, complexity details, and success criteria.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add amo-tech-ai/event-studio --skill documentation-architect -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/docs-architect/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/docs-architect/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add amo-tech-ai/event-studio --skill documentation-architect -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/docs-architect/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add amo-tech-ai/event-studio --skill documentation-architect -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/docs-architect/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install amo-tech-ai/event-studio .claude/skills/docs-architect
```

2. **Manually: put the files in place**
- File: `.github/skills/docs-architect/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add amo-tech-ai/event-studio --skill documentation-architect -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/amo-tech-ai/event-studio --path .claude/skills/docs-architect
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/docs-architect/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add amo-tech-ai/event-studio --skill documentation-architect -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/amo-tech-ai/event-studio/tree/HEAD/.claude/skills/docs-architect/SKILL.md

## When to use it
- build an MVP documentation set from a codebase
- map system architecture and component relationships
- write an API reference or integration guide
- turn a feature plan into Task Master work items
- refresh docs after a major refactor

## Example prompts
- Generate MVP documentation for this codebase using the `001-009` structure.
- Document the booking feature with architecture diagrams, database, state, UI, and API layers, plus success criteria.
- Inspect the existing dashboard, explain its code flow, propose improvement tasks, and add a testing strategy.

## Similar
- [codebase-onboarding](https://affpapa.org/en/nevibecode/skills/borghei-codebase-onboarding.md) — skill · 117 installs
- [code-documentation-docs-architect](https://affpapa.org/en/nevibecode/agents/code-documentation-docs-architect.md) — subagent · ★ 42780 repo stars
- [wiki-architect](https://affpapa.org/en/nevibecode/skills/wiki-architect.md) — skill · 8 installs
- [diagram-architect](https://affpapa.org/en/nevibecode/agents/diagram-architect.md) — subagent · 1178 installs
- [documentation-and-adrs](https://affpapa.org/en/nevibecode/skills/documentation-and-adrs.md) — skill · 80700 installs
- [High-Level Big Picture Architect (HLBPA)](https://affpapa.org/en/nevibecode/agents/high-level-big-picture-architect-hlbpa.md) — subagent · ★ 41430 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
