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:

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

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

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

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'