Claude-skill-registry-data mend-docs
Maintain and synchronize documentation files with the actual codebase (agents and skills).
install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry-data
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry-data "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/mend-docs" ~/.claude/skills/majiayu000-claude-skill-registry-data-mend-docs && rm -rf "$T"
manifest:
data/mend-docs/SKILL.mdsource content
Mend Docs
This skill enables the automatic synchronization of documentation files with the available agents and skills in the repository.
Purpose
To ensure that
README.md, CONTRIBUTING.md, and other public documentation files accurately list the capabilities of the agent without manual updates.
Instructions
- Discovery: Scan the following directories and categorize them:
- Reusable Skills: Look for all
files inSKILL.md
(recursive).skills/ - Project Skills: Look for all
files inSKILL.md
(recursive)..claude/skills/ - Agents: Look for agent definitions or metadata in
andagents/
..claude/agents/
- Reusable Skills: Look for all
- Extraction: For each skill/agent found, extract:
: From YAML frontmatter or directory name.name
: From YAML frontmatter or first paragraph.description
: Relative path from the workspace root.path
- Target Identification: Identify documentation files and their respective markers:
- README.md: Use
and<!-- REUSABLE_SKILLS_START -->
.<!-- REUSABLE_SKILLS_END --> - CONTRIBUTING.md: Use
and<!-- PROJECT_SKILLS_START -->
.<!-- PROJECT_SKILLS_END -->
- README.md: Use
- Formatting: Generate a table for each category.
- Recommended format: A table with columns for Name, Description, and Link.
- Synchronization: Replace the content between the specific markers in the target documentation files.
- Reusable skills go into
.README.md - Project skills go into
.CONTRIBUTING.md - CRITICAL:
MUST be written in English. Translate any non-English metadata (name, description) to English during the extraction/formatting phase forREADME.md
.README.md
- Reusable skills go into
- Verification: Ensure that the formatting is correct and all discovered skills are included in the correct file.
Markers
Reusable Skills (README.md)
<!-- REUSABLE_SKILLS_START --> <!-- REUSABLE_SKILLS_END -->
Project Skills (CONTRIBUTING.md)
<!-- PROJECT_SKILLS_START --> <!-- PROJECT_SKILLS_END -->
Example Table Format
<!-- markdown-link-check-disable -->| Name | Description | Link |
|---|---|---|
| lint-fix | Iteratively run linters, apply auto-fixes, and resolve remaining issues. | .claude/skills/lint-fix/SKILL.md |