Automates documentation maintenance for changelogs, architecture intent, and portal synchronization.
Install
mkdir -p .claude/skills/ai-docs && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/9546" && unzip -o skill.zip -d .claude/skills/ai-docs && rm skill.zipInstalls to .claude/skills/ai-docs
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Manages the documentation lifecycle: CHANGELOG, README, solution-intent architecture docs, external docs portals, and documentation quality gates. Auto-invoked by /ai-pr. Trigger for 'update the changelog', 'the README is stale', 'document this feature', 'docs portal needs updating', 'did we document all changes'. Not for blog or pitch content; use /ai-prose instead. Not for marketing collateral; use /ai-marketing instead.Key capabilities
- →Update changelog
- →Refresh README
- →Sync solution intent
- →Verify doc quality
How it works
Dispatches subagents to update specific documentation files based on project state.
Inputs & outputs
When to use ai-docs
- →Updating changelog
- →Refreshing README
- →Synchronizing solution intent
- →Validating doc quality
About ai-docs
Coordinates documentation updates, including changelog generation, README refreshes, and managing architectural decision documentation (solution intent).
Manages the documentation lifecycle: CHANGELOG, README, solution-intent architecture docs, external docs portals, and documentation quality gates. Auto-invoked by /ai-pr. Trigger for 'update the changelog', 'the README is stale', 'document this feature', 'docs portal needs updating', 'did we documen
When not to use it
- →Blog or pitch content
- →Marketing collateral
Prerequisites
Limitations
- →Never invent data
- →Sync updates data but never removes user-authored content
How it compares
Automates documentation lifecycle management based on semantic diffs rather than manual editing.
Compared to similar skills
ai-docs side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| ai-docs (this skill) | 0 | 2mo | No flags | Intermediate |
| write-rfc | 0 | 4mo | No flags | Intermediate |
| architecture-decision-records | 54 | 5mo | Review | Beginner |
| docs-write | 22 | 6mo | No flags | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by arcasilesgroup
View all by arcasilesgroup →You might also like
write-rfc
yifancong
Draft or revise a design RFC that explains architecture from first principles — why the system exists, how layers interact, what trade-offs were made, and where it's headed. Use when writing or improving technical design documents, RFCs, or architecture overviews.
architecture-decision-records
wshobson
Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes.
docs-write
metabase
Write documentation following Metabase's conversational, clear, and user-focused style. Use when creating or editing documentation files (markdown, MDX, etc.).
content-research-writer
ComposioHQ
Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section. Transforms your writing process from solo effort to collaborative partnership.
doc-coauthoring
anthropics
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.
research-grants
davila7
Write competitive research proposals for NSF, NIH, DOE, and DARPA. Agency-specific formatting, review criteria, budget preparation, broader impacts, significance statements, innovation narratives, and compliance with submission requirements.