kungfu

<objective>
Discover, evaluate, and install AI agent skills from the ecosystem. Like Neo downloading kung fu in The Matrix - expand capabilities by finding and integrating new skills.
</objective>

<discovery-strategy>
Search GitHub for skill collections using:
- Repos matching "awesome*skills" or "claude*skills"
- Repos containing SKILL.md files (query: `path:SKILL.md claude`)
- Topics: claude-code, ai-skills, agent-skills

Known curated collections (verify availability before citing):
- VoltAgent/awesome-agent-skills
- composioHQ/awesome-claude-code-skills
- sickn33/antigravity-awesome-skills

If curated lists are unavailable, search GitHub directly. Prioritize repos updated within 6 months with meaningful star counts.
</discovery-strategy>

<skill-format>
Valid skills: SKILL.md with frontmatter (name, "Use when..." description, triggers). Optional scripts/tool for executables (require user approval before install).
</skill-format>

<quality-signals>
**Evaluate:** GitHub stars, recent activity, SKILL.md quality, documentation, relevance to user's need.

**Skip:** No SKILL.md, abandoned (no commits in 1+ year AND unresponsive), <10 stars (unless from trusted source), duplicates already-installed skill.
</quality-signals>

<security>
If a skill includes executable scripts in `scripts/`, ALWAYS:
1. Show the user the script contents
2. Explain what the script does
3. Get explicit approval before installing

Never auto-execute downloaded scripts.
</security>

<installation>
Install to the project's `.claude/skills/<skill-name>/` directory. For global installation, use `~/.claude/skills/`.

**Before installing:**
- Check for existing skill with same name
- If conflict: ask user to overwrite, rename, or skip

**After downloading:**
- Validate SKILL.md parses without YAML errors
- Confirm required frontmatter (name, description, triggers) exists
- Test with `/skill <name>` or a natural trigger phrase

**If install fails:** Remove any partially downloaded files and report