skill-index

Synchronize skill documentation with installed Claude Code skills.

6|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/withpiper/pipekit --skill skill-index-withpiper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-index
Source: https://github.com/withpiper/pipekit/tree/main/skills/skill-index
Command: npx skills add https://github.com/withpiper/pipekit --skill skill-index-withpiper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps skill documentation in sync with the actual installed skills, reducing drift and ensuring users always see current capabilities.

Core Features & Use Cases

  • Automatically scans the .claude/skills/ directory to detect additions, removals, or changes.
  • Updates README.md and CLAUDE_SKILLS_GUIDE.md to reflect the current skill inventory.
  • Preserves user customizations while applying updates.

Quick Start

Run the skill-index to refresh the documentation index after adding or updating skills.

Frequently Asked Questions about skill-index

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

FAQPage Schema
How do I automatically sync skill documentation with installed Claude Code skills?

To sync skill documentation, this automation scans the .claude/skills/ directory, parses YAML frontmatter in each skill.md, and updates README.md and CLAUDE_SKILLS_GUIDE.md to reflect the current inventory while preserving user customizations.

What is the best way to update a README.md index after adding new skills?

The best way to update a README.md index is to run an automated synchronization process that enumerates currently installed skills and applies updates to the documentation files, ensuring the index reflects recent additions or modifications without losing custom content.

Does syncing a skill index preserve my custom markdown modifications in CLAUDE_SKILLS_GUIDE.md?

Yes, syncing a skill index preserves custom markdown modifications in CLAUDE_SKILLS_GUIDE.md. The synchronization process specifically detects changes in the .claude/skills/ directory and applies documentation updates while retaining your existing user customizations.

How does YAML frontmatter parsing work for generating a skill inventory?

YAML frontmatter parsing for generating a skill inventory works by reading the metadata headers in each skill.md file located under .claude/skills/. The automation extracts this data to enumerate installed skills and accurately update the documentation index.

When do I need to run a skill documentation synchronization?

You need to run a skill documentation synchronization during skill creation or modification. Triggering the sync after adding, updating, or removing skills under .claude/skills/ ensures your README.md and CLAUDE_SKILLS_GUIDE.md files do not drift from actual capabilities.

Can I use this documentation sync for projects without a .claude/skills/ directory?

No, this documentation sync applies specifically to projects using Claude Code skills stored under .claude/skills/. The automation relies on parsing YAML frontmatter from skill.md files within this directory structure to detect changes and update the index.