Escribir Skills
Un pipeline de 4 fases: Reunir → Criticar → Planificar → Implementar.
Fase 1: Reunir
Usa AskUserQuestion con preguntas agrupadas por dominio en 4 dominios. Cada dominio recibe 1 llamada con 2-4 opciones y una recomendación (primera opción = (Recomendado)).
- Propósito — ¿Qué tarea/dominio cubre la skill? ¿Quién la usa?
- Casos de Uso — ¿Qué escenarios específicos activan esta skill? ¿Qué palabras clave?
- Estructura — ¿Necesita scripts? ¿Archivos de referencia? ¿SKILL.md único o múltiples archivos?
- Herramientas — ¿Qué herramientas u otras skills debe invocar o referenciar?
Fase 2: Criticar
Invoca la skill grill-me, pasando los requisitos recopilados. Indícale que use los dominios adaptados a la skill en skill-grill-domains.md (Intención, Alcance, Diseño, Casos Extremos). Omite dominios irrelevantes (Flujo de Datos, Dependencias, Despliegue, Pruebas).
Respaldo (grill-me no disponible): Ejecuta un mini-crítica en línea usando AskUserQuestion directamente. Para cada dominio en skill-grill-domains.md, agrupa 2-4 preguntas por llamada con recomendaciones y opciones.
Fase 3: Planificar
Produce un modelo estructurado de skill usando la plantilla en blueprint-template.md. Presenta el modelo en el contexto de la conversación (sin escribirlo en disco). El usuario debe aprobar antes de continuar. Si el usuario solicita cambios, revisa y vuelve a presentar.
Fase 4: Implementar
Crea todos los archivos de la skill siguiendo el modelo aprobado. Completamente automatizado — el agente escribe todo.
Luego ejecuta la Fase 4b: Revisión usando los criterios de quality-criteria.md:
- Auto-verificación — Verifica criterios medibles (cantidad de líneas, longitud de la descripción, activadores, profundidad de referencias). Corrige cualquier falla antes de continuar.
- Revisión subjetiva — Presenta la lista de verificación al usuario mediante
AskUserQuestion. Si el usuario señala problemas, revisa y vuelve a verificar.
Estructura de la Skill
nombre-skill/
├── SKILL.md # Instrucciones principales (obligatorio, <100 líneas)
├── references/ # Documentos de soporte (si es necesario)
│ └── referencia-dominio.md
└── scripts/ # Scripts de utilidad (si es necesario)
└── ayudante.sh
Respaldo (sin AskUserQuestion)
Si AskUserQuestion no está disponible, recurre a preguntas basadas en texto:
[Encabezado] — [Tema] Recomendado: [Tu recomendación y por qué] Alternativas: (A) [Opción] — [compensación] | (B) [Opción] — [compensación]
Estándares de Calidad
Consulta quality-criteria.md para requisitos de descripción, criterios de auto-verificación, lista de verificación de revisión subjetiva y orientación sobre cuándo agregar scripts o dividir archivos.