happycapy skill creator
- Repo stars 122
- License MIT
- Author repo Happycapy-skills
- Domain
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 94 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @happycapy-ai · MIT
- Token usage
- Lean
- Setup complexity
- Manual integration
- External API key
- Required · Vendor-specific
- Operating systems
- Docker
- Runtime requirements
- Node.js · Python >=3.11 · Docker
- Detected file/system behavior
-
- Read-only
- Write / modify
- Env read
- Network behavior
- External requests
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# HappyCapy Skill Creator
Automate skill creation through **adaptation** rather than building from scratch.
## Workflow
```bash
python scripts/create_skill.py "Your requirement here" --name skill-name
```
**Process:**
1. Search anthropics/skills for similar skills (semantic + LLM)
2. Clone the closest match
3. Add requested features using LLM
4. Auto-fix HappyCapy compatibility (remove Docker, adapt dependencies)
5. Package as `.skill` file
## 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:**
```bash
python scripts/create_skill.py "I need to compress PDF files"
# Finds pdf skill → Clones → Adds compress function → Packages
```
**Extract video frames:**
```bash
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_KEY` environment variable (auto-configured in HappyCapy)
- Internet connection (to clone from anthropics/skills)
## Advanced
**Use improved auto-fix with batching:**
```python
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`
Sections and files
Listed in source order.
sections -> Workflow → Core Scripts → createskill.py → semanticsearch.py → cloneskill.py → integratefeature.py
terms -> adaptation · Process · Compress PDFs · Extract video frames · Use improved auto-fix with batching · Troubleshooting · Environment details
files/cmd -> .skill · AI_GATEWAY_API_KEY · references/bugfixes.md · references/happycapy-environment.md
body sha256 -> ba2921344daa
Workflow
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)
createskill.py
Main orchestrator - runs full workflow end-to-end
semanticsearch.py
LLM-powered semantic search of anthropics/skills repository
cloneskill.py
Clone skill from GitHub (anthropics/skills)
integratefeature.py
Add new features using LLM fine-tuning