name: skill-index description: "Auto-scan all installed skills, generate a categorized INDEX.md, and keep it in sync via git hooks. Triggers: skill index, scan skills, update index, skill catalog, manage skill list, skill inventory."

Skill Index

Auto-scan every SKILL.md under skills/, extract metadata, categorize, and produce a single searchable INDEX.md. Git hooks keep the index fresh on every commit and pull.

Problem It Solves

As skill count grows past 20+, finding the right one becomes painful — especially for the AI agent that must read descriptions at startup. Manual lists go stale fast.

Skill Index solves this by:

• One command → complete, up-to-date inventory
• Zero maintenance → git hooks auto-update on commit/pull
• Instant lookup → AI reads INDEX.md instead of crawling the whole directory

Quick Start

Manual scan

bash skills/skill-index/register.sh

Install git hooks (one-time)

bash skills/skill-index/install-hooks.sh
小蔥技能站7w4.net，專業的AI技能分享平臺。

After that, INDEX.md updates automatically whenever you commit or pull.

How It Works

1. Scan — Recursively find all SKILL.md files under skills/
2. Extract — Parse YAML frontmatter: name, description, relative path
3. Categorize — Smart matching by directory structure + description keywords
4. Generate — Write skills/INDEX.md as a categorized Markdown table

Output Format

# Skills Index
> Auto-generated. Run `bash skills/skill-index/register.sh` to update.

## Category Name
| Skill | Path | Trigger |
|-------|------|---------|
| my-skill | path/to/SKILL.md | Description preview... |

Customization

Adding categories

Edit the categorize() function in register.sh to add your own rules:

    *your-keyword*) echo "Your Category"; return ;;

Excluding skills

Add the skill's directory to the find exclusion list in register.sh:

find "$SKILLS_DIR" -name "SKILL.md" -not -path "*/skill-index/*" -not -path "*/your-private-skill/*"

Requirements

• Bash 4+
• Git (for hooks)
• OpenClaw workspace with skills/ directory

License

MIT

這是一款實用的元工具，能自動整理 skill 目錄並生成索引，省去手動維護的麻煩。Git hooks 讓索引始終保持最新，用起來很省心。不過安裝配置稍顯複雜，對新手不太友好；某些細節處理偶爾會出問題。總體質量不錯，是管理大量 skill 的好幫手，但還有改進空間。