What documentation files does this skill handle?

It manages README.md, ARCHITECTURE.md, CLAUDE.md, Architecture Decision Records (ADRs), and per-module documentation guides.

How does the update-docs skill identify documentation gaps?

The skill audits the directory structure and codebase to find modules without READMEs, undocumented stateful components, and non-obvious logic flows that lack explanation.

Does it support visual documentation?

Yes, it specifically includes an agent dedicated to creating Mermaid diagrams to visualize state machines and complex data flows.

Will it overwrite my manual documentation?

The skill follows a review-and-approve workflow, providing a summary of created or updated items and flagging specific areas that require manual user input.

Automated Documentation Architect

Name: Automated Documentation Architect
Author: phrazzld

byphrazzld

•

Content Management

Audits and generates comprehensive codebase documentation using specialized parallel agents to maintain architectural clarity.

The update-docs skill automates the critical but often neglected task of technical documentation by deploying four specialized parallel agents. It performs a deep audit of your codebase to identify documentation gaps, updates stale READMEs, generates Architecture Decision Records (ADRs) based on git history, and creates Mermaid state diagrams for complex components. By focusing on high-level abstractions and architectural intent rather than just implementation details, this skill ensures your documentation reduces cognitive load and makes complex systems feel manageable and well-organized.

Key Features

01Creation of Mermaid state and flow diagrams for complex logic

02Parallel agent execution for high-level and module-level documentation

03Automated deep vs shallow module detection for targeted navigation guides

04Stale documentation detection and removal of misleading content

05Automatic generation of Architecture Decision Records (ADRs) from git history

065 GitHub stars

Use Cases

01Standardizing documentation standards across a monorepo after a major implementation phase

02Onboarding new developers to a complex codebase with missing or outdated documentation

03Visualizing stateful system logic to clarify architectural flows for stakeholders

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add phrazzld/claude-config update-docs

For use in Claude.ai and ChatGPT

Download Skill