/happycapy-skill-creator

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

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:**

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_KEY` environment 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`