How do I trigger the synchronization?

Synchronization is triggered automatically when Claude detects tool-related code changes, such as new decorators or registry edits, or you can manually prompt it with 'tool-sync'.

Does it overwrite manual content in instructions.py?

No, it is specifically programmed to update only the tool list blocks, preserving manually written content like search strategies and logical instructions.

What does the Tool Sync skill do?

It automates the process of updating documentation, tool counts, and system instructions whenever an MCP tool is added, removed, or renamed in your code.

Which files are updated by this skill?

It targets six key files: tool_registry.py, tools/__init__.py, instructions.py, .github/copilot-instructions.md, SKILL.md, and your project's README files.

Why is the verification step important?

The verification step ensures that your internal TOOL_CATEGORIES mapping perfectly matches the actual tools available in the FastMCP runtime, preventing documentation errors.

MCP Tool Documentation Sync

Name: MCP Tool Documentation Sync
Author: u9401066

byu9401066

•

생산성 및 워크플로

Automatically synchronizes MCP tool documentation, instructions, and counts across multiple files to ensure code-to-doc consistency.

The Tool Sync skill streamlines the maintenance of MCP (Model Context Protocol) servers by ensuring that any changes to tool definitions are instantly reflected in documentation. It monitors for tool registrations, category updates, and renaming events, then triggers an automated script to update README files, system instructions, Copilot configurations, and tool reference guides. This prevents stale documentation and ensures that Claude always has the most up-to-date understanding of available tools and their capabilities without manual intervention.

주요 기능

01Tool category and registry verification against runtime

025 GitHub stars

03Multi-language support for README and documentation updates

04Automated multi-file synchronization (README, SKILL.md, instructions.py)

05Seamless integration with GitHub Copilot and Claude instructions

06Dynamic tool count updates and status badges

사용 사례

01Refactoring tool categories and ensuring the AI agent's system prompt reflects the changes.

02Verifying that the TOOL_CATEGORIES registry matches the actual FastMCP runtime.

03Adding new search tools to an MCP server and updating all reference docs instantly.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add u9401066/pubmed-search-mcp tool-sync

For use in Claude.ai and ChatGPT

Download Skill