happycapy-skill-creator — Claude Code skill: how to install and use
happycapy-skill-creator adapts existing skills from anthropics/skills for HappyCapy environments. It strips Docker dependencies and bundles the result into a .skill archive.
MIT ★ 138 updated 2026-09-03
npx skills add happycapy-ai/Happycapy-skills --skill happycapy-skill-creator -a claude-codeWhat happycapy-skill-creator does
This skill adapts public tools instead of building them from scratch. The main script, create_skill.py, searches the anthropics/skills repository using semantic matching, clones the closest candidate, and writes requested features with an LLM.
The core mechanism handles platform limitations. While HappyCapy includes Python 3.11, Node.js 24, pandoc, ImageMagick, and jq, it lacks Docker, Java, Ruby, and Go. The check_compatibility.py script scans code for these unsupported runtimes or high memory demands, and auto_fix.py modifies the files before packaging everything into a .skill zip archive.
Running this requires Python 3.11+, internet access, and the AI_GATEWAY_API_KEY environment variable. The scripts will fail without this key.
What it helps with
- search the anthropics/skills repository for relevant tools
- rewrite existing skills to run without Docker
- append custom features to an existing skill via an LLM
- package tool files into a distributable .skill zip archive
Example prompts for the agent
- Create a skill to compress PDF files using
python scripts/create_skill.py "I need to compress PDF files" - Adapt a skill to extract video frames every second via
scripts/create_skill.py
How to install happycapy-skill-creator
1Skills CLI (Vercel)
npx skills add happycapy-ai/Happycapy-skills --skill happycapy-skill-creator -a claude-code2Manually: put the files in place
~/.claude/skills/happycapy-skill-creator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/happycapy-skill-creator/
1Skills CLI (Vercel)
npx skills add happycapy-ai/Happycapy-skills --skill happycapy-skill-creator -a codex2Manually: put the files in place
.agents/skills/happycapy-skill-creator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add happycapy-ai/Happycapy-skills --skill happycapy-skill-creator -a cursor2Manually: put the files in place
.cursor/skills/happycapy-skill-creator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install happycapy-ai/Happycapy-skills skills/happycapy-skill-creator2Manually: put the files in place
.github/skills/happycapy-skill-creator/SKILL.md1Skills CLI (Vercel)
npx skills add happycapy-ai/Happycapy-skills --skill happycapy-skill-creator -a gemini-cli2Platform CLI
gemini skills install https://github.com/happycapy-ai/Happycapy-skills --path skills/happycapy-skill-creatorManually: put the files in place
.devin/skills/happycapy-skill-creator/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about happycapy-skill-creator
How to install happycapy-skill-creator in Claude Code?
Run npx skills add happycapy-ai/Happycapy-skills --skill happycapy-skill-creator -a claude-code in your terminal.
What does happycapy-skill-creator do?
It finds Anthropic skills, rewrites them to fit HappyCapy environment limits, and bundles them into .skill zip files.
What runtime constraints does it enforce?
It fixes code to run on Python 3.11 or Node.js 24 with 4GB RAM and 2 CPUs, removing dependencies on Docker, Go, Java, or Ruby.
Source text
SKILL.md · MIT
---
name: happycapy-skill-creator
description: "Automate HappyCapy skill creation by finding and adapting existing skills from anthropics/skills repository. Handles environment constraints (Python 3.11, Node.js 24, no Docker). Use when user wants to create or adapt skills for specific tasks."
---
# 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`
© happycapy-ai · MIT · happycapy-ai/Happycapy-skills