sync-dev-guide-claude

Rebuild CLAUDE.md sections from .claude directories and MCP server list.

Updated Jan 16, 2026
One-click install
npx skills add https://github.com/dezverev/AnimalAL-v1 --skill sync-dev-guide-claude
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-dev-guide-claude
Source: https://github.com/dezverev/AnimalAL-v1/tree/main/.claude/skills/sync-dev-guide-claude
Command: npx skills add https://github.com/dezverev/AnimalAL-v1 --skill sync-dev-guide-claude

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CLAUDE.md often becomes out of date as skills, agents, and MCP servers are added or removed. This Skill automates the synchronization to ensure the dev guide always reflects the current ecosystem.

Core Features & Use Cases

  • Discovery & synchronization: scans .claude/skills/, .claude/agents/, and MCP server state to rebuild the Skills & Agents and MCP Servers sections.
  • Automated updates: updates CLAUDE.md whenever new skills or MCP servers are introduced, or when old ones are removed.
  • Use Case: a maintainer runs this Skill after adding a new skill under .claude/skills/ to refresh the documentation for users.

Quick Start

Use the sync-dev-guide-claude skill to refresh CLAUDE.md so its Skills, Agents, and MCP Server sections match the current repository.

Frequently Asked Questions about sync-dev-guide-claude

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

FAQPage Schema
Why does CLAUDE.md become outdated after removing MCP servers or agents?

CLAUDE.md becomes outdated when manual edits fail to reflect removed agents or MCP servers. Synchronizing CLAUDE.md rebuilds the documentation sections by scanning active directories and running MCP list commands to match the current ecosystem.

How to sync CLAUDE.md with current agents and MCP servers?

To sync CLAUDE.md, trigger the synchronization command to scan .claude/skills/ and .claude/agents/ directories, query MCP server states, and rebuild the corresponding documentation sections for users.

Does updating CLAUDE.md require manually editing skills and agents sections?

Updating CLAUDE.md does not require manual edits. The synchronization process automatically discovers and rebuilds the skills, agents, and MCP servers sections by reading the current repository state.

What is the best way to automate CLAUDE.md documentation for Claude agents?

Automating CLAUDE.md documentation is best achieved through synchronization skills that detect ecosystem changes, scan active agent and skill directories, and rebuild the dev guide sections automatically.

Can I refresh MCP server documentation in CLAUDE.md without rewriting the entire file?

Refreshing MCP server documentation targets specific sections of CLAUDE.md. The synchronization process identifies the MCP Servers, Skills, and Agents blocks and rebuilds only those segments while preserving the rest of the file.