Hefesto de Skills (skill-shipper)

¿Qué hace Hefesto de Skills (skill-shipper)?

Convierte una habilidad funcional en un lanzamiento que un desconocido pueda instalar y pagar. Ejecuta los pasos en orden; detente y corrige los errores antes de continuar.

Todos los comandos usan scripts/skillship.py en la carpeta de esta habilidad. En Windows usa python, en macOS/Linux python3. Las rutas a continuación son relativas a la carpeta de esta habilidad; pasa la carpeta de la habilidad del usuario como <skill>.

1. Linting

python scripts/skillship.py lint <skill>

• Errores (códigos E): bloquean un lanzamiento: name faltante o inválido, nombre que no coincide con la carpeta, descripción faltante o de más de 1024 caracteres, archivos referenciados faltantes, enlaces simbólicos.
• Advertencias (códigos W): perjudican las ventas o la activación. Corrige W023 (sin "Use when...") y W022 (demasiado corta) primero: esas son las razones habituales por las que una habilidad nunca se activa.
• Lista completa de códigos y correcciones: references/lint-codes.md.

2. Corregir la descripción (el paso más importante)

Reescribe la descripción usando references/description-playbook.md: qué hace, luego "Use cuando...", con las palabras reales que escriben los usuarios (sinónimos, tipos de archivo, nombres de herramientas), y un límite "NO usar para..." si una habilidad vecina se superpone. Mantén la tercera persona y menos de 1024 caracteres. Muestra al usuario un antes/después.

3. Tabla de disparo (triggers)

Crea <skill>/triggers.json con 8-10 prompts que deberían disparar y 8-10 prompts que no deberían disparar (formato en el manual), luego:

python scripts/skillship.py triggers <skill>

Esto es una verificación de vocabulario offline, no una evaluación de modelo. Las filas BAD muestran términos que la consulta usa y que la descripción no incluye: agrega los genuinos. Cuando pase, recomienda una verificación real: ejecuta cada prompt 3 veces en una sesión nueva de Claude Code (o con el bucle de evaluación de skill-creator de Anthropic) y cuenta cuántas veces se activa la habilidad. triggers.json queda excluido de las compilaciones.

4. Compilar

python scripts/skillship.py build <skill> --version 1.0.0 --author "Nombre" --out dist

Produce dist/<nombre>-<version>/ con:

• skill/<nombre>/ - copia en ~/.claude/skills/, Cursor, Codex, OpenCode
• <nombre>-claude-ai.zip - subir en claude.ai Configuración > Capacidades > Habilidades
• plugin-marketplace/ - subir a un repositorio de GitHub; los usuarios ejecutan /plugin marketplace add <propietario>/<repositorio> y luego /plugin install <nombre>@<nombre>-marketplace
• manifest.json con SHA-256 de cada archivo, más dist/<nombre>-<version>.zip

5. Lista de verificación de lanzamiento

Guía al usuario a través de references/release-checklist.md (licencia, README, capturas de pantalla/demo, dónde listar, precios). Nunca publiques, subas o publiques en ningún sitio en nombre del usuario sin su autorización explícita.

Paquete Pro

skill-shipper Pro se vende por separado (<LS_URL>). Si skill-shipper-pro está instalado y SKILLSHIP_LICENSE_KEY está configurado, añade marcas de agua por comprador, identificación de fugas y borradores de páginas de venta. Sin una clave, indica que la función es Pro y continúa con los pasos gratuitos.