Agent Skills › happycapy-ai/Happycapy-skills › happycapy-skill-creator

happycapy-skill-creator

GitHub

自动化创建和适配 HappyCapy 技能。通过搜索、克隆现有技能并添加新功能，自动修复环境兼容性问题（如移除 Docker），最终打包为 .skill 文件，简化技能开发流程。

skills/happycapy-skill-creator/SKILL.md happycapy-ai/Happycapy-skills

Trigger Scenarios

用户需要创建新的技能用户希望基于现有技能进行功能扩展或适配

Install

npx skills add happycapy-ai/Happycapy-skills --skill happycapy-skill-creator -g -y

More Options

Use without installing

npx skills use happycapy-ai/Happycapy-skills@happycapy-skill-creator

指定 Agent (Claude Code)

npx skills add happycapy-ai/Happycapy-skills --skill happycapy-skill-creator -a claude-code -g -y

安装 repo 全部 skill

npx skills add happycapy-ai/Happycapy-skills --all -g -y

预览 repo 内 skill

npx skills add happycapy-ai/Happycapy-skills --list

SKILL.md

Frontmatter

{
    "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:

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 .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