skill-forge-convertlisted
Install: claude install-skill lovepixel-git/skill-forge
# Skill Conversion — Multi-Platform
Convert Claude Code skills to work on OpenAI Codex, Google Gemini CLI, Google
Antigravity, and Cursor while maintaining quality and following each platform's
best practices.
## Process
### Step 1: Read Source Skill
1. Read the source `SKILL.md` and parse frontmatter
2. Detect skill complexity tier (1-4)
3. Inventory all files: scripts/, references/, agents/, sub-skills
4. Identify MCP config (`.mcp.json`) if present
### Step 2: Analyze Platform Compatibility
Run dry-run analysis first:
```bash
python scripts/convert_skill.py <path> --dry-run --target all
```
Review the compatibility report:
- **Portable fields**: Transfer directly (name, description, license)
- **Adaptable fields**: Need platform-specific handling
- **Claude-only fields**: Will be stripped with warnings
### Step 3: Convert to Target Platforms
Run the conversion:
```bash
python scripts/convert_skill.py <path> --target codex,gemini,antigravity,cursor --output dist/
```
For MCP config conversion:
```bash
python scripts/convert_skill.py <path> --target all --output dist/ --include-mcp
```
### Step 4: Handle Claude-Only Features
Features that need manual adaptation per platform:
| Claude Feature | Codex | Gemini/Antigravity | Cursor |
|---------------|-------|-------------------|--------|
| `allowed-tools` | Supported | Remove; all tools available | Remove; no equivalent |
| `context: fork` | No equivalent | No equivalent | No equivalent |
| `hooks` | 1 event (notif