@skill-kit/convert

Format converter for Skill Kit - convert between Claude Code, Codex CLI, Cursor, and Continue formats.

Installation

npm install @skill-kit/convert
# or
pnpm add @skill-kit/convert

Usage

CLI

# Convert a skill file to Codex format
skill-convert convert ./SKILL.md --to codex

# Convert to all formats
skill-convert convert ./SKILL.md --to all

# Detect format
skill-convert detect ./SKILL.md

# Batch convert directory
skill-convert convert ./skills/ --to cursor -r --output ./converted/

Programmatic API

import {
  parseClaudeSkill,
  convert,
  convertWithWarnings,
  detectFormat,
} from '@skill-kit/convert';

// Parse a Claude Code skill
const skill = parseClaudeSkill(content);

// Convert to Codex format
const codexContent = convert(skill, 'claude', 'codex');

// Convert with warnings
const { content, warnings } = convertWithWarnings(skill, 'claude', 'codex');

// Detect format
const result = detectFormat(content);
console.log(result.format, result.confidence);

Supported Formats

| Format | Source | Target | File Pattern | |--------|--------|--------|--------------| | Claude Code | Yes | Yes | SKILL.md | | Codex CLI | Yes | Yes | agents/*.md | | Cursor | Yes | Yes | .cursorrules | | Continue | Yes | Yes | config.json |

Conversion Matrix

| From / To | Claude | Codex | Cursor | Continue | |-----------|--------|-------|--------|----------| | Claude | - | Yes | Yes | Yes | | Codex | Yes | - | Via Claude | Via Claude | | Cursor | Yes | Via Claude | - | Via Claude | | Continue | Yes | Via Claude | Via Claude | - |

Field Mapping

Claude -> Codex

• name -> name (converted to kebab-case)
• description -> description
• version -> (removed, warning)
• triggers -> (removed, warning)
• ## Core Workflow -> ## Workflow

Claude -> Cursor

• name -> # Title
• description -> (removed)
• ## Core Workflow -> ## Workflow Rules
• ## Prerequisites -> ## Constraints

Claude -> Continue

• name -> customCommands[].name (kebab-case)
• description -> customCommands[].description
• All sections -> customCommands[].prompt

License

MIT