CommunityRedacción y edicióngithub.com

troels-im/agent-skills-playbook-template

Plantilla progresiva de documentación como código para habilidades de agentes de IA, AGENTS.md, playbooks, trazas de trabajo y políticas de prueba justas.

¿Qué es agent-skills-playbook-template?

Este skill proporciona una interfaz de comandos de bajo consumo de tokens para gestionar flujos de trabajo en un repositorio. Permite a un agente AI leer automáticamente la estructura de documentación del proyecto (AGENTS.md, index.md, flows/index.md), seleccionar el flujo más pequeño relevante y ejecutar sus pasos de forma secuencial. Está diseñado para plataformas como Claude Code, Cursor o Codex que soportan skills de agente. El skill incluye puertas de entrada de usuario obligatorias para evitar inferencias incorrectas y exige la ejecución de pruebas automatizadas (`just turn-test` y `just pr-test`) antes de cada commit. Su formato de nombres de ejecución con timestamp UTC y la estructura de playbooks en `playbooks/repository/choose-workflow.md` garantizan trazabilidad y reutilización.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add troels-im/agent-skills-playbook-template

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Lets

Utiliza este skill como la superficie de comandos de bajo consumo de tokens para los flujos del repositorio.

Flujo de trabajo

  1. Lee AGENTS.md.
  2. Lee el index.md raíz.
  3. Lee flows/index.md.
  4. Selecciona el flujo más pequeño que coincida.
  5. Carga el archivo del flujo seleccionado.
  6. Crea o actualiza la lista de verificación de ejecución del flujo nombrada por ese flujo. Usa slugs con marca de tiempo UTC para los nombres de ejecución generados: run-YYYYMMDDTHHMMSSZ-short-slug.md.
  7. Sigue únicamente los playbooks nombrados por el flujo y requeridos por el paso actual.
  8. Prefija las actualizaciones de progreso con el formato requerido por el flujo: XX% / YY% / ZZ%: mensaje.
  9. Ejecuta just turn-test antes de cada commit.
  10. En el paso final de un flujo, ejecuta just pr-test, corrige las pruebas de PR que fallen y repite hasta que las pruebas de PR pasen o se registre un bloqueador real.

Puertas de entrada de usuario

Cuando un paso del flujo necesite entrada del usuario, aprobación, una decisión de producto o retroalimentación para continuar correctamente, pausa el bucle y pregunta. No infieras decisiones faltantes ni continúes con requisitos supuestos.

Continúa sin preguntar solo cuando el usuario indique explícitamente que no se le moleste, que no se le pregunte, que se proceda con el mejor criterio, o que se dé una instrucción equivalente. Al hacerlo, registra la suposición en la lista de verificación de ejecución y mantenla reversible cuando sea posible.

Si ningún flujo coincide, dilo claramente y enruta a través de playbooks/repository/choose-workflow.md.

No trates /goal o /loop como comandos de usuario para esta plantilla. Usa /lets como el comando orientado al usuario y flows/ como la capa duradera del repositorio.

Skills relacionados