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.md
source 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

  1. Discovery: Scan the following directories and categorize them:
    • Reusable Skills: Look for all
      SKILL.md
      files in
      skills/
      (recursive).
    • Project Skills: Look for all
      SKILL.md
      files in
      .claude/skills/
      (recursive).
    • Agents: Look for agent definitions or metadata in
      agents/
      and
      .claude/agents/
      .
  2. Extraction: For each skill/agent found, extract:
    • name
      : From YAML frontmatter or directory name.
    • description
      : From YAML frontmatter or first paragraph.
    • path
      : Relative path from the workspace root.
  3. Target Identification: Identify documentation files and their respective markers:
    • README.md: Use
      <!-- REUSABLE_SKILLS_START -->
      and
      <!-- REUSABLE_SKILLS_END -->
      .
    • CONTRIBUTING.md: Use
      <!-- PROJECT_SKILLS_START -->
      and
      <!-- PROJECT_SKILLS_END -->
      .
  4. Formatting: Generate a table for each category.
    • Recommended format: A table with columns for Name, Description, and Link.
  5. 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:
      README.md
      MUST be written in English. Translate any non-English metadata (name, description) to English during the extraction/formatting phase for
      README.md
      .
  6. 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 -->
NameDescriptionLink
lint-fixIteratively run linters, apply auto-fixes, and resolve remaining issues..claude/skills/lint-fix/SKILL.md
<!-- markdown-link-check-enable -->