diseñador-habilidades/tradermonty

Skill Designer

Descripción general

Genera un prompt completo para la CLI de Claude a partir de una especificación de idea estructurada. El prompt instruye a Claude para crear un directorio de habilidad completo siguiendo las convenciones del repositorio: SKILL.md con frontmatter YAML, documentos de referencia, scripts auxiliares y andamiaje de pruebas.

Cuándo utilizarlo

• El pipeline de autogeneración de habilidades selecciona una idea del backlog y necesita un prompt de diseño para claude -p
• Un desarrollador desea arrancar una nueva habilidad a partir de una especificación de idea en JSON
• La revisión de calidad de las habilidades generadas requiere conocimiento de la rúbrica de puntuación

Prerrequisitos

• Python 3.9+
• No se requieren claves API externas
• Los archivos de referencia deben existir en references/

Flujo de trabajo

Paso 1: Preparar la especificación de la idea

Acepta un archivo JSON (--idea-json) que contenga:

• title: Nombre de la idea legible para humanos
• description: Qué hace la habilidad
• category: Categoría de la habilidad (por ejemplo, trading-analysis, developer-tooling)

Acepta un nombre de habilidad normalizado (--skill-name) que se utilizará como nombre del directorio y campo name: del frontmatter YAML.

Paso 2: Construir el prompt de diseño

Ejecuta el constructor del prompt:

python3 skills/skill-designer/scripts/build_design_prompt.py \
  --idea-json /tmp/idea.json \
  --skill-name "my-new-skill" \
  --project-root .

El script:

1. Carga el JSON de la idea
2. Lee los tres archivos de referencia (guía de estructura, lista de verificación de calidad, plantilla)
3. Enumera las habilidades existentes (hasta 20) para evitar duplicados
4. Muestra un prompt completo en la salida estándar

Paso 3: Alimentar el prompt a la CLI de Claude

El pipeline que realiza la llamada canaliza el prompt hacia claude -p:

python3 skills/skill-designer/scripts/build_design_prompt.py \
  --idea-json /tmp/idea.json \
  --skill-name "my-new-skill" \
  --project-root . \
| claude -p --allowedTools Read,Edit,Write,Glob,Grep

Paso 4: Validar la salida

Después de que Claude cree la habilidad, verifica:

• Que skills/<skill-name>/SKILL.md exista con el frontmatter correcto
• Que la estructura del directorio siga las convenciones
• Que la puntuación con dual-axis-skill-reviewer cumpla el umbral

Formato de salida

El script genera un prompt en texto plano en la salida estándar. Código de salida 0 en caso de éxito, 1 si faltan archivos de referencia requeridos.

Recursos

• references/skill-structure-guide.md -- Estructura del directorio, formato de SKILL.md, convenciones de nomenclatura
• references/quality-checklist.md -- Lista de verificación de 5 categorías del revisor de doble eje (100 puntos)
• references/skill-template.md -- Plantilla de SKILL.md con frontmatter YAML y secciones estándar
• scripts/build_design_prompt.py -- Script constructor del prompt (interfaz CLI)