HappyCapy Skill Creator
Automate skill creation through adaptation rather than building from scratch.
Workflow
python scripts/create_skill.py "Your requirement here" --name skill-name
Process:
- •Search anthropics/skills for similar skills (semantic + LLM)
- •Clone the closest match
- •Add requested features using LLM
- •Auto-fix HappyCapy compatibility (remove Docker, adapt dependencies)
- •Package as
.skillfile
Core Scripts
create_skill.py
Main orchestrator - runs full workflow end-to-end
semantic_search.py
LLM-powered semantic search of anthropics/skills repository
clone_skill.py
Clone skill from GitHub (anthropics/skills)
integrate_feature.py
Add new features using LLM fine-tuning
check_compatibility.py
Scan for HappyCapy incompatibilities (Docker, unsupported runtimes, memory issues)
auto_fix.py
Auto-fix compatibility issues with LLM rewrites
package_skill.py
Create distributable .skill file (zip format)
Examples
Compress PDFs:
python scripts/create_skill.py "I need to compress PDF files" # Finds pdf skill → Clones → Adds compress function → Packages
Extract video frames:
python scripts/create_skill.py "Extract frames from videos every second" # Finds video-frames skill → Clones → Adds interval parameter → Packages
Environment Constraints
HappyCapy provides:
- •✅ Python 3.11, Node.js 24
- •✅ pandoc, ImageMagick, jq
- •✅ 4GB RAM, 2 CPU cores
HappyCapy does NOT support:
- •❌ Docker, Java, Ruby, Go
The tool automatically fixes incompatibilities.
Requirements
- •Python 3.11+
- •
AI_GATEWAY_API_KEYenvironment variable (auto-configured in HappyCapy) - •Internet connection (to clone from anthropics/skills)
Advanced
Use improved auto-fix with batching:
from scripts.auto_fix_improved import fix_compatibility_issues
fix_compatibility_issues(
skill_path=path,
issues=issues,
batch_size=5, # Process 5 issues per batch
max_retries=2 # Retry failed fixes up to 2 times
)
Troubleshooting: See references/bugfixes.md for known issues and solutions
Environment details: See references/happycapy-environment.md