Communitygithub.com

KimYx0207/creador-de-skills-meta

Una habilidad portable para agentes, diseñada para diseñar, refactorizar y revisar skills reutilizables.

¿Qué es creador-de-skills-meta?

Esta habilidad portable para agentes, llamada 'Creador de Skills Meta', está diseñada para ayudar a agentes de IA (como Claude Code, Codex o Cursor) a convertir flujos de trabajo humanos repetibles en paquetes de habilidades ejecutables, validables y migrables. No se trata de generar 'prompts más largos', sino de construir paquetes con una entrada ligera, carga progresiva de detalles y métodos de verificación reproducibles. El creador de skills meta se enfoca en diseñar, refactorizar y revisar skills, siguiendo un conjunto de contratos clave: validar que la tarea realmente merezca ser skillificada, mantener el `SKILL.md` como una ruta de activación y primer movimiento, y delegar la documentación detallada a subdirectorios (`references/`, `assets/`, `evals/`, `scripts/`). Soporta plataformas como Codex y Claude Code, e incluye reglas para manejar intenciones ambiguas, selecciones múltiples y producción por lotes mediante herramientas nativas (como `request_user_input` o `AskUserQuestion`). El flujo de trabajo incluye clasificación, investigación, diseño, construcción, verificación y cierre del ciclo, y se detiene ante tareas que no califican como skills repetibles o ante falta de evidencia local.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add KimYx0207/meta-skill-creator

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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.md solo 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_input de Codex o AskUserQuestion de 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 actualLecturaCuándo usarlo
Investigación de intención y dominioreferences/intent-domain-research.md, assets/domain-research-brief-template.mdEntrada 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 artefactosreferences/experience-surface-model.mdLa skill debe producir archivos, medios, capturas de pantalla, presentaciones, informes, paneles u otros artefactos visibles.
Diseño de productoreferences/product-design.mdSe necesita decidir los archivos del paquete, resultado visible en 3 minutos, viaje del usuario o primera superficie pública.
Contrato de ejecuciónreferences/skill-contract.mdAntes de escribir o modificar un paquete candidato de skill.
Límite de abstracción de fuentesreferences/source-abstraction-boundary.mdAl usar casos externos, ejemplos internos o materiales de la competencia, primero abstraer y luego reescribir.
Plan del paqueteassets/package-plan-template.mdMapear SKILL.md, archivos de referencia, activos, scripts, evaluaciones y ejemplos antes de editar.
Ruta multimodal / herramientasreferences/multimodal-tooling.md, assets/multimodal-prompt-brief-template.mdLa 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 MVPreferences/interactive-mvp-product-skill.mdLa 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ónreferences/evaluation-method.md, evals/trigger-eval.jsonDiseñ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ónreferences/release-gate.md, assets/acceptance-run-template.mdAntes de afirmar que se puede distribuir, migrar o entregar a otros para su uso.
Gobernanza de ciclo cerradoreferences/closed-loop-governance.md, assets/loop-run-record-template.mdAl 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

  1. Clasificar: determinar si es new-skill, refactor-skill, evaluate-skill, package-plan, o not-a-skill.
  2. 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.
  3. 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.
  4. Construir: crear o modificar solo el conjunto mínimo de archivos que el objetivo actual debe tocar.
  5. 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.
  6. Cerrar ciclo: rellenar registro de ejecución; decidir writeback, proposal, none-with-reason o blocked; 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.

Skills relacionados