snqb/enrich-skill

Enrich Skill

Systematically improve local skills by researching and incorporating best patterns from the ecosystem.

Workflow

Step 1: Read Current Skill

cat ~/.pi/agent/skills/<skill-name>/SKILL.md

Identify:

• Current focus/strengths
• Gaps in coverage
• Structure and style

Step 2: Research Ecosystem

Skills.sh (Community Skills)

npx skills find <topic>

wshobson/agents (Comprehensive Plugins)

# List all skills in a plugin
gh api repos/wshobson/agents/contents/plugins/<plugin-name>/skills | jq -r '.[] | .name'

# Get skill content
curl -s "https://raw.githubusercontent.com/wshobson/agents/main/plugins/<plugin>/skills/<skill>/SKILL.md"

Known plugins:

• python-development — 16 Python skills
• backend-development — API, security, observability
• code-refactoring — Refactoring patterns
• cicd-automation — CI/CD patterns

Anthropic Official Skills

gh api repos/anthropics/skills/contents/skills | jq -r '.[] | .name'

GitHub Search

# Quality-filtered search
gh search repos "<topic> skill agent" --stars ">50" --json fullName,description,stargazersCount

# Claude skills specifically
gh search repos "claude skill <topic>" --json fullName,description

Step 3: Gap Analysis

Compare your skill against found skills:

| Your Skill Has | Your Skill Missing | |----------------|-------------------| | ✅ Feature A | ❌ Pattern X | | ✅ Feature B | ❌ Pattern Y |

Step 4: Enrich

Add missing patterns while:

• Preserving original style and focus
• Keeping content concise
• Avoiding redundancy
• Maintaining the skill's unique angle

Step 5: Verify

# Check file size (aim for <15KB unless comprehensive)
wc -c ~/.pi/agent/skills/<skill-name>/SKILL.md

# Verify structure
head -50 ~/.pi/agent/skills/<skill-name>/SKILL.md

---

Research Sources

Primary Sources

| Source | Command | Best For | |--------|---------|----------| | skills.sh | npx skills find <query> | Community skills, quick discovery | | wshobson/agents | gh api repos/wshobson/agents/contents/plugins | Comprehensive patterns | | anthropics/skills | gh api repos/anthropics/skills/contents/skills | Official, document-focused | | badlogic/pi-skills | gh api repos/badlogic/pi-skills/contents | Pi-specific skills |

wshobson/agents Plugin Index

# List all plugins
gh api repos/wshobson/agents/contents/plugins | jq -r '.[] | .name' | head -30

Known comprehensive plugins:

• python-development — testing, design, types, performance, async
• backend-development — API design, security, databases
• application-performance — profiling, optimization
• code-documentation — docstrings, READMEs
• comprehensive-review — code review patterns

Quick Skill Fetch

# Fetch and display a wshobson skill
PLUGIN="python-development"
SKILL="python-testing-patterns"
curl -s "https://raw.githubusercontent.com/wshobson/agents/main/plugins/$PLUGIN/skills/$SKILL/SKILL.md" | head -100

---

Example: Enriching Python Skill

1. Read Current

cat ~/.pi/agent/skills/python/SKILL.md

Found: Astral stack (uv, ruff, ty), refactoring Missing: Testing, design patterns, error handling

2. Research

# Skills.sh
npx skills find python

# wshobson Python skills
gh api repos/wshobson/agents/contents/plugins/python-development/skills | jq -r '.[] | .name'

Found 16 skills:

• python-testing-patterns
• python-design-patterns
• python-type-safety
• python-error-handling
• python-performance-optimization
• ...

3. Fetch Best Patterns

for skill in python-testing-patterns python-design-patterns python-error-handling; do
  curl -s "https://raw.githubusercontent.com/wshobson/agents/main/plugins/python-development/skills/$skill/SKILL.md"
done

4. Gap Analysis

| Has | Missing | |-----|---------| | ✅ Astral stack | ❌ pytest fixtures/mocking | | ✅ rope-refactor | ❌ KISS/SRP patterns | | ✅ Type checking | ❌ Generics/Protocols | | | ❌ Error handling | | | ❌ Performance profiling |

5. Enrich

Add sections for:

• Testing patterns (fixtures, parametrize, mocking)
• Design principles (KISS, SRP, composition)
• Type safety (generics, protocols)
• Error handling (fail fast, parse don't validate)
• Performance (profiling, common optimizations)

---

Enrichment Principles

Do

• ✅ Keep original skill's unique focus
• ✅ Add complementary patterns
• ✅ Maintain concise style
• ✅ Include practical examples
• ✅ Preserve working commands/configs

Don't

• ❌ Replace unique content with generic
• ❌ Bloat beyond necessity
• ❌ Copy verbatim without adaptation
• ❌ Add rarely-used patterns
• ❌ Duplicate what other skills cover

Size Guidelines

| Skill Type | Target Size | |------------|-------------| | Focused tool | 3-5 KB | | Language/framework | 10-15 KB | | Comprehensive guide | 15-25 KB |

---

Quick Commands

# Check your skill
cat ~/.pi/agent/skills/<name>/SKILL.md | head -50

# Search skills.sh
npx skills find <topic>

# List wshobson plugins
gh api repos/wshobson/agents/contents/plugins | jq -r '.[] | .name'

# List skills in plugin
gh api repos/wshobson/agents/contents/plugins/<plugin>/skills | jq -r '.[] | .name'

# Fetch skill content
curl -s "https://raw.githubusercontent.com/wshobson/agents/main/plugins/<plugin>/skills/<skill>/SKILL.md"

# Check Anthropic skills
gh api repos/anthropics/skills/contents/skills | jq -r '.[] | .name'