hamgarian/loot-skill

skill-factory

Construye un skill como lo haría un mantenedor cuidadoso, y luego retiene el lanzamiento hasta que el usuario lo apruebe. Funciona en cualquier agente; cada paso nombra la mejor herramienta y una alternativa que siempre funcione.

Entrada: una idea de skill, o un item entregado por loot con su evidencia (consulta, resultados de búsqueda, prueba, borde). Carpeta destino: donde indique el usuario, si no, ../<slug> fuera del historial del repositorio actual.

1. Especificación

Escribe SPEC.md: objetivo, entradas y salidas, y una lista de verificación de aceptación donde cada línea se pueda probar. Bajo una página. Si loot entregó el item, reutiliza su evidencia en lugar de buscar de nuevo. Pregunta al usuario solo cuando dos interpretaciones de la idea produzcan skills diferentes.

2. Construir, pruebas primero

• Si el agente tiene un ayudante de creación de skills (en Claude Code: anthropic-skills:skill-creator), úsalo para el skill y sus evaluaciones.
• De lo contrario, escribe SKILL.md tú mismo: frontmatter con name (en kebab-case) y una description que diga qué hace y cuándo activarlo, luego los pasos.
• Los scripts obtienen pruebas antes del código (node:test o pytest). Implementa hasta que pasen. Escribe archivos con tu herramienta de edición de archivos, no con heredocs del shell.
• Ejecuta todas las pruebas y evaluaciones. Mantén el comando exacto y su salida para el paso 4.

3. Revisión independiente

El constructor no califica su propio trabajo.

• Mejor: inicia un subagente que no haya visto esta conversación. Dale solo la carpeta destino y references/release-checklist.md con este resumen: "Revisa el skill en contra la lista de verificación. Responde PASS o FAIL por cada elemento con evidencia archivo:línea. Cuando no estés seguro, FAIL. Señala cualquier afirmación que las pruebas o evaluaciones no demuestren."
• Alternativa: sin subagentes: para cada elemento de la lista de verificación, escribe el argumento más sólido de que FALLA antes de decidir.

Corrige cada FAIL, vuelve a ejecutar las pruebas, revisa de nuevo. Detente cuando todos los elementos pasen, o cuando un elemento esté bloqueado por el usuario (di cuál y por qué).

4. Puerta de lanzamiento

Escanea en busca de secretos: node <carpeta del skill loot>/scripts/scan.mjs <carpeta>, además de gitleaks dir <carpeta> si está instalado. Luego muestra al usuario un manifiesto y detente para obtener un sí claro:

• nombre del repositorio, público o privado
• versión y línea del changelog
• los archivos a publicar
• resultados de pruebas y evaluaciones (comando + conteo de aprobados), el veredicto de la revisión
• cualquier cosa omitida

Un sí cubre exactamente ese manifiesto. Luego publica desde un git init fresco: haz commit release vX.Y.Z, etiqueta, gh repo create y haz push, e instala el skill donde el agente del usuario carga los skills. Sin gh o sin iniciar sesión: imprime los comandos. Nunca pidas, escribas o almacenes credenciales.

5. Informe

Un mensaje corto en lenguaje sencillo: enlaces, resultados de pruebas, resultado de la revisión y lo que queda para el usuario.