skills.rest
baekenough
baekenoughCOMMUNITY
Explore all skills by this author →
GitHub

update-docs

Synchronize AGENT.md, SKILL.md, index.yaml, and CLAUDE.md across Claude Code projects.

34|5|Updated Jan 25, 2026
Search Tags:#automation#documentation#validation#project-structure#docs-sync#agent-skill
One-click install
npx skills add https://github.com/baekenough/oh-my-customcode --skill update-docs-baekenough
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-docs
Source: https://github.com/baekenough/oh-my-customcode/tree/main/templates/.claude/skills/update-docs
Command: npx skills add https://github.com/baekenough/oh-my-customcode --skill update-docs-baekenough

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Syncs and validates documentation across the Claude Code project to ensure agent and skill references remain accurate and cohesive as the codebase evolves.

Core Features & Use Cases

  • Scan project structure to detect AGENT.md, SKILL.md, index.yaml, and CLAUDE.md drift.
  • Validate consistency of agent-to-skill and command references, and update inter-agent mappings.
  • Generate or update documentation to reflect current state, improving onboarding and collaboration.

Quick Start

Run the update-docs skill to synchronize all documentation with the current project structure and references.

Frequently Asked Questions about update-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep Claude Code project documentation in sync with my codebase?▼

Synchronizing project documentation requires scanning the .claude/ directory to detect drift across AGENT.md, SKILL.md, index.yaml, and CLAUDE.md files. This validation process updates inter-agent mappings and cross-references to reflect the current codebase state.

What is documentation drift in a multi-agent project structure?▼

Documentation drift occurs when project files like AGENT.md and SKILL.md become outdated as the codebase evolves. Validating consistency of agent-to-skill and command references ensures onboarding guides and inter-agent mappings remain accurate and cohesive.

How do I validate cross-references between agents, skills, and commands?▼

Validating cross-references involves scanning .claude/agents, .claude/skills/*/SKILL.md, guides/, and commands/ directories. This process checks consistency of agent-to-skill and command references, then updates documentation mappings accordingly.

Does this docs synchronization approach require a specific project structure?▼

Yes, this documentation synchronization applies specifically to Claude Code projects using the .claude/ structure. It requires scanning .claude/agents, .claude/skills/*/SKILL.md, guides/, and commands/ to ensure cross-house validation and organic integration.

What's the best way to automate documentation updates for Claude Code agents?▼

Automating documentation updates for Claude Code agents involves running a synchronization scan across the .claude/ directory structure. This detects documentation drift and regenerates references to reflect the current project state, improving onboarding and collaboration.

Why does my AGENT.md file have outdated skill references after renaming components?▼

Outdated skill references in AGENT.md occur due to documentation drift when the codebase evolves without syncing references. Running a documentation synchronization scan detects this drift and updates agent-to-skill mappings to restore consistency.

Related Skills

Explore More Content & Communication Skills→
sandrusidoltst-a11ysandrusidoltst-a11y

sync-context

Synchronize project documentation files with the actual codebase state.

Community
Intermediate
Xza85hrfXza85hrf

impact-analysis

Identify downstream impacts across hooks, scripts, and installed components after kit infrastructure changes.

Community
Advanced
ysgdepaulaysgdepaula

validate-all

Run all validators to verify X-DEEP architecture health and detect drift.

Community
Intermediate
mifunedevmifunedev
17

doc-drift

Detect and score documentation drift between the docs wiki and live application.

Official
Advanced