Deep Documentation
Create, expand, reorganize, and maintain repository documentation with deep coverage across README files, browsable docs, API/reference pages, llms.txt, llms-full.txt, changelogs, and repo-local agent skills. Use whenever the user asks for comprehensive project documentation, documentation refreshes, LLM-friendly docs, documentation synchronization after code changes, or agent guidance that teaches future LLMs how to use the project docs.
Install
/plugin marketplace add adamdroberts/agent-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add adamdroberts/agent-skills --skill deep-documentationgit clone --depth 1 https://github.com/adamdroberts/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/deep-documentation ~/.claude/skills/deep-documentationPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Deep Documentation Use this skill when the task is to produce or maintain serious repository documentation, not a light README pass. The target quality bar is a repo where humans and LLMs can both understand how to use the system, what changed, and where to find the exact surface they need. Documentation is part of delivery. If the code, API, setup, workflow, or behavior changes, the docs change in the same task. ## Core rules - Ground everything in the real repo. Read code, config, routes, schemas, tests, and existing docs before writing. - Do not write vague marketing prose. Write operational, exact documentation. - Keep the documentation layered: overview for orientation, guides for workflows, reference for exact interfaces, internals for maintainers. - Use Mermaid diagrams in architectural documentation and anywhere business logic, workflow, or system behavior is easier to understand visually. - Treat LLM-facing documentation as first-class project artifacts, not an afterthought. - Treat changelog updates as required for meaningful changes. - Create or update repo-local agent skills when the repo has distinct workflows or tool surfaces that future LLMs should follow. ## Documentation standard Documentation at this level should usually include most or all of these surfaces: - `README.md` for the current product story, setup, quickstart, and top-level links. - `docs/README.md` or equivalent index that maps the full documentation set.
Details
- Skill name
deep-documentation- Repository
- adamdroberts/agent-skills
- Path
deep-documentation/SKILL.md- License
- MIT
- Repo updated
- 21 October 2026
FAQ
What does the Deep Documentation skill do?
Create, expand, reorganize, and maintain repository documentation with deep coverage across README files, browsable docs, API/reference pages, llms.txt, llms-full.txt, changelogs, and repo-local agent skills. Use whenever the user asks for comprehensive project documentation, documentation refreshes, LLM-friendly docs, documentation synchronization after code changes, or agent guidance that teaches future LLMs how to use the project docs.
How do I install the Deep Documentation skill?
Claude Code plugin: /plugin marketplace add adamdroberts/agent-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Deep Documentation popular?
It lives in adamdroberts/agent-skills, which has 9 GitHub stars and 0 forks.
Related skills
Truthful Coder
9adamdroberts/agent-skills
Enforces strict change transparency. Use when editing code, notebooks, configs, or running commands so every change is disclosed, including changes not announced in advance.
Walter Writes Humanizer
9walterwritesai/no-slop-ai-humanizer-rewriter
Rewrite AI-generated text to sound human. Use when given existing AI output — from ChatGPT, Claude, Gemini, or any LLM — that needs to read like a person wrote it.
Multichannel Repurposing
10thicazu-png/claude-skills-advocacia
Adapta conteúdo jurídico-base para múltiplos canais digitais, incluindo LinkedIn, newsletter, blog, roteiro de vídeo curto e carrossel. Use quando o usuário quiser reaproveitar uma tese jurídica ou artigo em formatos diferentes com linguagem adequada a cada canal.
Walter Writes Writer
9walterwritesai/no-slop-ai-humanizer-rewriter
Write content that avoids AI tells from the start. Use when generating any prose — articles, emails, social posts, reports — where the output should sound human, not machine-made.
Labor Law Business Content
10thicazu-png/claude-skills-advocacia
Cria conteúdo jurídico trabalhista para empresas, RH, jurídico interno, compliance e gestores. Use para posts, artigos, newsletters, roteiros, checklists e análises sobre CLT, relações de trabalho, passivo trabalhista, terceirização, pejotização, jornada, assédio, políticas internas e contencioso empresarial.
API Docs Generator
9tomique34/claude-skill-creator
Generate comprehensive API documentation from OpenAPI specs, code docstrings, JSDoc/TSDoc comments, and Markdown annotations. Use when creating or updating API documentation in /docs/API.md from various source formats including Swagger, Python docstrings, TypeScript interfaces, or inline comments.
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.