Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add happycapy-ai/Happycapy-skills --skill happycapy-skill-creator -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/happycapy-skill-creator/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/happycapy-skill-creator/

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

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set41

The whole set →
weather Fetches current conditions and forecasts for a city or airport. It works for quick answers and JSON-based weather requests. CX Codex +1 ★ 138repo stars oss-contributor-swarm oss-contributor-swarm deploys an autonomous 9-agent swarm to discover simple GitHub issues, write fixes, and submit pull requests. CX Codex +1 ★ 138repo stars llm-council llm-council is a Claude Code skill that sends one prompt to several AI models and displays their replies side by side, with shared-answer synthesis and anonymous voting. CX Codex +1 ★ 138repo stars capy-cortex capy-cortex keeps a local base of rules, anti-patterns and preferences, then feeds the matching ones into context through hooks. Useful when an agent keeps repeating the same mistakes. CX Codex +1 ★ 138repo stars youtube-music Search YouTube Music by track or artist, then open a result in the default browser. It needs an API key and MCP configuration. CX Codex +1 ★ 138repo stars agent-4-code-writer agent-4-code-writer — a Claude Code subagent that implements fixes or features within an open-source contributor swarm using an existing issue plan and codebase map. CX Codex ★ 138repo stars agent-3-codebase-explorer agent-3-codebase-explorer explores a repository before a fix or feature, locating relevant files and documenting the project structure for the next agents. CX Codex ★ 138repo stars agent-2-issue-analyst agent-2-issue-analyst is a Claude Code subagent that turns a chosen GitHub issue into a spec with complexity, files to touch and an ordered fix plan. CX Codex ★ 138repo stars

Project sponsors

Companies that keep this analytics open