Creador de Skills Meta
Con esta habilidad, convierte flujos de trabajo repetibles en paquetes de habilidades ejecutables, validables y migrables. El producto no es un "prompt más largo", sino un paquete de capacidades con una entrada ligera por defecto, detalles cargados bajo demanda y métodos de verificación reproducibles.
Contrato Central
- Partir del flujo de trabajo real del usuario, no de plantillas basadas en preferencias personales.
- Antes de escribir archivos, demostrar que la tarea merece ser skillificada; las tareas puntuales no deben convertirse forzosamente en paquetes de habilidades.
SKILL.mdsolo conserva la ruta de activación: disparador, primera acción, carga progresiva, parada forzosa y verificación.- La investigación detallada, el diseño del producto, el plan del paquete, la evaluación de disparadores, los métodos de aceptación y las plantillas se colocan en
references/,assets/,evals/,scripts/. - Las skills que requieran completar intenciones ambiguas, permitir múltiples selecciones al usuario o primero asegurar el MVP y luego producir en lote, deben diseñar puntos de decisión nativos del host como
request_user_inputde Codex oAskUserQuestionde Claude Code; las tarjetas de selección en Markdown solo pueden ser interfaces de espera degradadas, no pueden simular confirmaciones reales. - Para imágenes, videos, presentaciones, documentos, informes, paneles u otros artefactos renderizados, se debe priorizar Image2 / capacidades nativas del host; MCP, scripts, SVG, previsualizaciones estáticas son rutas degradadas o auxiliares, y debe haber evidencia de degradación.
- El material externo solo se puede abstraer como principios de calidad; no copiar nombres, estructuras de página, sistemas visuales, prompts, ejemplos o argumentos comerciales de otros.
- Cada entrega debe cerrar el ciclo: registrar evidencia de ejecución, hallazgos de revisión, y decisión (
writeback/proposal/none-with-reason/blocked); el aprendizaje reutilizable se escribe de vuelta en la referencia, plantilla, validador, evaluación o ejemplo correspondiente.
Carga Progresiva
Solo leer los archivos necesarios para la fase actual:
| Fase actual | Lectura | Cuándo usarlo |
|---|---|---|
| Investigación de intención y dominio | references/intent-domain-research.md, assets/domain-research-brief-template.md | Entrada del usuario difusa, dominio desconocido, parece una decisión estratégica, o podría ser un prompt puntual; primero escribir un resumen de investigación de dominio; si falta evidencia, marcar research-needed. |
| Superficie y cadena de artefactos | references/experience-surface-model.md | La skill debe producir archivos, medios, capturas de pantalla, presentaciones, informes, paneles u otros artefactos visibles. |
| Diseño de producto | references/product-design.md | Se necesita decidir los archivos del paquete, resultado visible en 3 minutos, viaje del usuario o primera superficie pública. |
| Contrato de ejecución | references/skill-contract.md | Antes de escribir o modificar un paquete candidato de skill. |
| Límite de abstracción de fuentes | references/source-abstraction-boundary.md | Al usar casos externos, ejemplos internos o materiales de la competencia, primero abstraer y luego reescribir. |
| Plan del paquete | assets/package-plan-template.md | Mapear SKILL.md, archivos de referencia, activos, scripts, evaluaciones y ejemplos antes de editar. |
| Ruta multimodal / herramientas | references/multimodal-tooling.md, assets/multimodal-prompt-brief-template.md | La skill depende de Image2, capacidades de medios del host, MCP, renderizadores locales o scripts; primero registrar inventario de capacidades locales y resumen multimodal. |
| Decisiones interactivas y puerta MVP | references/interactive-mvp-product-skill.md | La skill debe mostrar múltiples decisiones bajo intención difusa, fijar estilo/portada/primer pantalla/MVP y luego producir en lote, o reutilizar flujo de confirmación entre hosts Codex y Claude Code. |
| Diseño de evaluación | references/evaluation-method.md, evals/trigger-eval.json | Diseñar evaluación de disparador, evaluación de salida, comparación de línea base, regresión o verificación de aceptación. |
| Puerta de publicación | references/release-gate.md, assets/acceptance-run-template.md | Antes de afirmar que se puede distribuir, migrar o entregar a otros para su uso. |
| Gobernanza de ciclo cerrado | references/closed-loop-governance.md, assets/loop-run-record-template.md | Al aceptar, fallar, revisar, derivar, preparar publicación o cuando el usuario solicite "cierre de ciclo"; se debe escribir el registro de ejecución y la decisión de escritura. |
Los archivos .md en assets/ son plantillas de trabajo para que el usuario las complete; los .json son datos estructurados para scripts o validaciones. Solo se leen al crear el artefacto correspondiente. scripts/ solo se ejecuta durante validación, conversión o empaquetado; no pegar el contenido del script en el contexto de la conversación.
Flujo de trabajo
- Clasificar: determinar si es
new-skill,refactor-skill,evaluate-skill,package-plan, onot-a-skill. - Obtener e investigar: recopilar solo la evidencia que cambiará la decisión del paquete, la superficie del artefacto, la ruta de herramientas o el criterio de aceptación.
- Diseñar: determinar resultado, límite de disparo, entrada/salida, ruta de capacidades locales, superficie de decisión interactiva, puerta de bloqueo MVP, estructura del paquete y modos de fallo público.
- Construir: crear o modificar solo el conjunto mínimo de archivos que el objetivo actual debe tocar.
- Validar: ejecutar validación del paquete, validación de ciclo cerrado y validación de dominio; informar qué demuestra la evidencia estructural, la evidencia del artefacto, la evidencia de ejecución y la confirmación humana.
- Cerrar ciclo: rellenar registro de ejecución; decidir
writeback,proposal,none-with-reasonoblocked; solo escribir de vuelta aprendizaje reutilizable como reglas; no suplantar el cierre de ciclo con un resumen de chat.
Estructura del paquete
Archivos predeterminados:
SKILL.md: entrada ligera, responsable del disparo y del contrato de ejecución.references/: reglas de dominio, modelo de producto, ruta de capacidades, abstracción de fuentes, método de evaluación, puerta de publicación.assets/: plantillas rellenables, hojas de trabajo, datos estructurados o resúmenes de prompts.scripts/: validaciones deterministas, conversión, renderizado o verificación del paquete.evals/: evaluaciones de disparo y casos de regresión.examples/: ejemplos de entrada/salida pequeños y reales; no incluir historial privado, puntuaciones internas o evidencia de ejecución falsa.
Solo agregar nuevos archivos si previenen un fallo concreto o facilitan que la skill se ejecute correctamente. No añadir archivos de referencia solo para guardar notas de investigación.
Parada forzosa
Detenerse y explicar el bloqueo en los siguientes casos:
- La tarea es solo un prompt puntual, no un flujo de trabajo repetible.
- La superficie del dominio se basa en suposiciones, sin materiales del usuario, evidencia local o evidencia de la fuente actual.
- La skill multimodal carece de inventario de capacidades locales y ruta de evidencia de salida.
- Se requieren múltiples rondas de decisión del usuario o confirmación MVP, pero no hay herramienta de selección nativa, interfaz de espera degradada, campo de estado de confirmación ni reglas de parada para producción en lote.
- El paquete depende de archivos generados, pero no hay forma de probar que existen archivos, capturas, medios o resultados renderizados.
- El alcance del disparador se solapa con otro paquete de skill activo, sin límite de ruta.
- El diseño expondría historial de evaluación privado, revisiones internas, cicatrices de implementación, o haría evidente la imitación de un proyecto externo.
Validación
Ejecutar en el directorio raíz del paquete:
python scripts/check_meta_skill_package.py .
python scripts/check_closed_loop.py .
Si el paquete generado tiene sus propios scripts, también ejecutarlos según el artefacto real. Durante la validación, distinguir claramente entre verificación estructural, evidencia del artefacto generado, evidencia de ejecución/herramientas y aceptación manual; la aprobación en un nivel no reemplaza la aprobación en todos.
Informe final
Reportar en español: qué archivos se modificaron, decisión del paquete, límite de disparo, diagrama de carga progresiva, comandos de validación, niveles de evidencia, decisión de cierre de ciclo y riesgos restantes. Proporcionar una pequeña comparación antes/después o fragmento de salida para que el usuario pueda juzgar si el paquete de skill es realmente más fácil de usar.