make-documentation — Claude Code skill: use and install
This skill writes READMEs, architecture notes, changelogs, runbooks, and install docs. It helps choose a document workflow and review the result.
npx skills add Callicrate/skills --skill make-documentation -a claude-codeWhat make-documentation does
The skill creates or updates project documentation for READMEs, architecture notes, changelogs, release notes, runbooks, install guides, security articles, and notebook explanations. It also covers agent operation manuals and AI-readable workflow documents. API reference work and AGENTS.md belong outside this skill.
For a large rewrite, a moved document, or an unclear structure, it runs scripts/audit_documentation.py before drafting. It then routes the work to a matching guide, such as references/guide-readme.md, references/guide-install-runbook.md, or references/guide-changelog.md. Notebook work is checked against executable cells, imports, widgets, SQL, configuration, and outputs. The final pass uses references/review-checklist.md. Diagram work is opt-in, so this skill does not generate diagram files by default.
What it helps with
- draft a project README
- audit an existing documentation tree
- write a local or Docker install runbook
- update a changelog and release notes
- explain a notebook from its executable content
Example prompts for the agent
- Write a README for this project and inspect the documentation structure first.
- Update
CHANGELOG.md, choose the right documentation guide, then review the result. - Create a Docker installation runbook from the project files.
How to install make-documentation
1Skills CLI (Vercel)
npx skills add Callicrate/skills --skill make-documentation -a claude-code2Manually: put the files in place
~/.claude/skills/make-documentation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/make-documentation/
1Skills CLI (Vercel)
npx skills add Callicrate/skills --skill make-documentation -a codex2Manually: put the files in place
.agents/skills/make-documentation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Callicrate/skills --skill make-documentation -a cursor2Manually: put the files in place
.cursor/skills/make-documentation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Callicrate/skills make-documentation2Manually: put the files in place
.github/skills/make-documentation/SKILL.md1Skills CLI (Vercel)
npx skills add Callicrate/skills --skill make-documentation -a gemini-cli2Platform CLI
gemini skills install https://github.com/Callicrate/skills --path make-documentationManually: put the files in place
.devin/skills/make-documentation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Callicrate/skills --skill make-documentation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about make-documentation
How do I install make-documentation in Claude Code?
Run npx skills add Callicrate/skills --skill make-documentation -a claude-code, then check ~/.claude/skills/make-documentation/SKILL.md.
What does make-documentation do?
It helps draft project docs, audits the documentation structure, selects a guide for the document type, and reviews the finished work.
Can make-documentation write API docs or AGENTS.md?
No. API reference writing is outside its scope, and AGENTS.md should use agents-md instead.
