| name | enrich-skill |
| description | Improve existing skills by researching best practices from skills.sh, GitHub, and wshobson/agents. Use when asked to 'enrich', 'improve', or 'upgrade' a skill, or compare yours with others. |
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)
gh api repos/wshobson/agents/contents/plugins/<plugin-name>/skills | jq -r '.[] | .name'
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
gh search repos "<topic> skill agent" --stars ">50" --json fullName,description,stargazersCount
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
wc -c ~/.pi/agent/skills/<skill-name>/SKILL.md
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
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
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
npx skills find python
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
cat ~/.pi/agent/skills/<name>/SKILL.md | head -50
npx skills find <topic>
gh api repos/wshobson/agents/contents/plugins | jq -r '.[] | .name'
gh api repos/wshobson/agents/contents/plugins/<plugin>/skills | jq -r '.[] | .name'
curl -s "https://raw.githubusercontent.com/wshobson/agents/main/plugins/<plugin>/skills/<skill>/SKILL.md"
gh api repos/anthropics/skills/contents/skills | jq -r '.[] | .name'