Topic · Code and Developer
Documentation and READMEs skills for Claude Code and Codex
Skills for technical documentation: READMEs, API and SDK docs, OpenAPI specs, architecture decision records, code comments, changelogs, Diataxis-structured guides and agent instruction files such as AGENTS.md and CLAUDE.md. They help an agent write docs that match the code and keep them current.
Highest-scoring documentation skills in the October 22, 2026 snapshot: diataxis-writer from tronghieu/agent-skills (87/100), openapi-spec-generator from LambdaTest/agent-skills (82/100) and provider-docs from hashicorp/agent-skills (80/100). Scores come from the Suede Skill Check.
- 42 listed skills
- 20 repositories
- 8 with full pages
25 from official publishers. 3 bundle scripts. 1 connect to an outside service. Listed in Writing and Editing (16), Developer Tools and Frameworks (12), Code Review and Code Quality (6), AI Agents and LLM Engineering (3), Testing and QA (2), Frontend and Design (2), Security (1).
All 42 documentation skills
No matching skills. Try fewer words or clear your search.
| Skill | Repository | What it does |
|---|---|---|
| codebase-documenter 75/100 · C | mhattingpete/claude-skills-marketplace | Generates documentation explaining how a codebase works, including architecture, key components, data flow, and development guidelines, for understanding unfamiliar code and onboarding. |
| dart-write-documentation 77/100 · C | flutter/skills | Provides rules and formatting guidelines for writing Dart /// API documentation and doc comments, following Effective Dart for libraries, classes, methods, and variables. |
| diataxis-writer 87/100 · B | tronghieu/agent-skills | Writes, restructures, classifies, and reviews documentation of any kind with the Diataxis framework, including knowledge bases, help centers, manuals, runbooks, tutorials, and references. |
| doc-coauthoring 78/100 · C | getsentry/skills | Guides users through a structured workflow for co-authoring documentation, proposals, technical specs, and decision docs, including context transfer, iteration, and reader checks. |
| documentation 80/100 · B | mcollina/skills | Creates, structures, and reviews technical documentation using the Diátaxis framework of tutorials, how-to guides, reference, and explanation pages. |
| openapi-spec-generator 82/100 · B | LambdaTest/agent-skills | Generates OpenAPI 3.x and Swagger 2.0 specifications from natural language descriptions, code, or partial specs, as lintable YAML or JSON with schemas and examples. |
| provider-docs 80/100 · B | hashicorp/agent-skills | Creates, updates, and reviews Terraform provider documentation for the Terraform Registry using HashiCorp-recommended patterns and tfplugindocs templates. |
| technical-doc-creator 78/100 · C | mhattingpete/claude-skills-marketplace | Creates HTML technical documentation with code blocks, API workflows, system architecture diagrams, and syntax highlighting for API references and developer documentation. |
| agents-md 75/100 · C | getsentry/skills | Creates and maintains concise AGENTS.md and CLAUDE.md project instruction files. Use when asked to create AGENTS.md, update AGENTS.md, maintain… |
| agents-md 87/100 · B | mblode/agent-skills | Audits and edits agent instruction files, verifies repository commands, and migrates repositories to AGENTS.md as the single shared source. Use when… |
| api-docs-quality-report 70/100 · C | infrasity-labs/dev-gtm-claude-skills | Audits any API documentation site by crawling every endpoint page and scoring each one across 5 checks: description quality, OpenAPI spec presence… |
| api-documentation 79/100 · C | LambdaTest/agent-skills | Generate comprehensive, professional API documentation from API designs, endpoint definitions, OpenAPI/Swagger specs, route lists, or raw endpoint… |
| aspnet-minimal-api-openapi 59/100 · D | github/awesome-copilot | Create ASP.NET Minimal API endpoints with proper OpenAPI documentation |
| claude-md-improver 84/100 · B | anthropics/claude-plugins-official | Audit and improve CLAUDE.md files in repositories. Use when user asks to check, audit, update, improve, or fix CLAUDE.md files. Scans for all… |
| code-documenter 84/100 · B | jeffallan/claude-skills | Generates, formats, and validates technical documentation — including docstrings, OpenAPI/Swagger specs, JSDoc annotations, doc portals, and user… |
| code-tour 80/100 · B | github/awesome-copilot | Use this skill to create CodeTour .tour files — persona-targeted, step-by-step walkthroughs that link to real files and line numbers. Trigger for… |
| comment-code-generate-a-tutorial 63/100 · D | github/awesome-copilot | Transform this Python script into a polished, beginner-friendly project by refactoring the code, adding clear instructional comments, and generating… |
| copilot-instructions-blueprint-generator 77/100 · C | github/awesome-copilot | Technology-agnostic blueprint generator for creating comprehensive copilot-instructions.md files that guide GitHub Copilot to produce code… |
| create-architectural-decision-record 62/100 · D | github/awesome-copilot | Create an Architectural Decision Record (ADR) document for AI-optimized decision documentation. |
| create-tldr-page 67/100 · D | github/awesome-copilot | Create a tldr page from documentation URLs and command examples, requiring both URL and command name. |
| csharp-docs 65/100 · D | github/awesome-copilot | Ensure that C# types are documented with XML comments and follow best practices for documentation. |
| cypress-docs 70/100 · C | cypress-io/ai-toolkit | Search and extract Cypress information from official documentation (docs.cypress.io, cypress.io); prefer LLM markdown under /llm/* and refuse… |
| dart-use-doc-examples 69/100 · D | flutter/skills | How to inject external code examples into Dartdoc using the {@example} directive, and how to filter those files using #hide, #region, and #endregion… |
| develop-adr 83/100 · B | product-on-purpose/pm-skills | Creates an Architecture Decision Record following the Nygard format to document significant technical decisions, their context, and consequences… |
| docs-auditor 78/100 · C | infrasity-labs/dev-gtm-claude-skills | Audits any developer documentation site across 33 checks in 7 categories and produces a scored report (out of 100) with Pass / Warn / Fail status… |
| docs-sync-audit 79/100 · C | github/awesome-copilot | Run a read-only documentation drift audit for a feature, PR, branch, release, API, configuration change, workflow, CLI, package, or repository area… |
| documentation-template 58/100 · D | infrasity-labs/dev-gtm-claude-skills | Generate structured documentation templates for components, patterns, or guidelines within a design system. |
| documentation-writer 66/100 · D | github/awesome-copilot | Diátaxis Documentation Expert. An expert technical writer specializing in creating high-quality software documentation, guided by the principles and… |
| generate-custom-instructions-from-codebase 69/100 · D | github/awesome-copilot | Migration and code evolution instructions generator for GitHub Copilot. Analyzes differences between two project versions (branches, commits, or… |
| go-documentation 95/100 · A | eduardo-sl/go-agent-skills | Go documentation conventions: godoc comments, package docs, testable Example functions, deprecation notices, doc links, and project docs (README… |
| go-openapi 90/100 · A | eduardo-sl/go-agent-skills | Spec-first REST development in Go with OpenAPI: generating server interfaces and clients with oapi-codegen, request validation middleware, RFC 9457… |
| java-docs 61/100 · D | github/awesome-copilot | Ensure that Java types are documented with Javadoc comments and follow best practices for documentation. |
| mkdocs-translations 65/100 · D | github/awesome-copilot | Generate a language translation for a mkdocs documentation stack. |
| nemo-rl-docs 76/100 · C | NVIDIA/skills | Documentation conventions for NeMo-RL. Covers docs/index.md updates and docstring format. Do NOT use for: bug fixes, test fixes, dependency bumps… |
| oo-component-documentation 70/100 · C | github/awesome-copilot | Create or update standardized object-oriented component documentation using a shared template plus mode-specific guidance for new and existing docs. |
| readme-blueprint-generator 66/100 · D | github/awesome-copilot | Intelligent README.md generation prompt that analyzes project documentation structure and creates comprehensive repository documentation. Scans… |
| review-claudemd 65/100 · D | ykdojo/claude-code-tips | Review recent conversations to find improvements for CLAUDE.md files. |
| sdk-docs-auditor 78/100 · C | infrasity-labs/dev-gtm-claude-skills | Audits any SDK documentation site and produces a fully scored, downloadable HTML report. Use this skill whenever a user provides a documentation URL… |
| shipping-artifacts 81/100 · B | phuryn/pm-skills | The durable documentation set that makes an AI-built (vibe-coded) app reviewable before shipping. A small core every app needs — architecture… |
| spec-to-code-compliance 86/100 · B | trailofbits/skills | Check code against the documentation that specifies it - which requirements hold, which the code contradicts, which are absent, and what the code… |
| technical-documentation 76/100 · C | wondelai/skills | Audit, write, and improve developer documentation using Google's Developer Documentation Style Guide and Technical Writing courses. Use this skill… |
| utility-pm-changelog-curator 80/100 · B | product-on-purpose/pm-skills | Draft CHANGELOG entries from git log via the pm-changelog-curator sub-agent, applying the repo hygiene rules (describe what changed, public paths… |
How to choose documentation skills
Pick by document type. README and API-doc skills write from the code, ADR skills record a decision, and docs-audit skills compare existing docs against the source.
Agent instruction skills (AGENTS.md, CLAUDE.md, Copilot instructions) shape how every later agent session behaves, so review their output as you would a config change.
Most documentation skills are plain Markdown with no scripts or keys, so they are quick to try on one module first.
Ranked documentation shortlists
Related topics
Technical Writing and Documentation 33Claude Code Setup and Hooks 31REST APIs and OpenAPI 31.NET and C# 31Flutter and Dart 29Go 34Code Assistants 21Code Review 50
Find your next useful skill
Explore Rising Skills with quality scores and source reports, or search from inside your agent.
Get Rising Skills by email · Read Rising Skills · Install the finder · State of Agent Skills