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.

9 starsWriting & Content Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add adamdroberts/agent-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add adamdroberts/agent-skills --skill deep-documentation
Manual install
git 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-documentation

Personal 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.
Read the full skill on GitHub

Details

Skill name
deep-documentation
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

9

adamdroberts/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.

Software Development

Walter Writes Humanizer

9

walterwritesai/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.

Writing & Content

Multichannel Repurposing

10

thicazu-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.

Writing & Content

Walter Writes Writer

9

walterwritesai/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.

Writing & Content

Labor Law Business Content

10

thicazu-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.

Writing & Content

API Docs Generator

9

tomique34/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.

Writing & Content

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.