AI Engineering 2026 Open Source

Spec Flow Skills

Skills de spec-driven design para Claude Code y otros agentes.

Dos skills open source — /spec y /spec-impl — que fuerzan a planear la feature, aprobar el spec a mano e implementarla paso a paso con pausas, en lugar de dejar que el LLM improvise.

GitHub

// TIPO

Skills · Open Source

Skills

Agentes

MIT

Licencia

Rol: Autor / Mantenedor
Equipo: Open source · individual
Alcance: Skills de especificación e implementación para agentes de IA
Período: 2026

Mis responsabilidades

Diseñé el flujo de dos skills con un gap deliberado de aprobación humana.
Especificación de specs versionados en git con estados Draft → Approved → Implemented.
Instalador multi-agente para Claude Code, Cursor, Codex, Antigravity y OpenCode.

Qué es

Spec Flow Skills es un par de skills open source para trabajar con agentes de IA bajo spec-driven design: el artefacto principal es el spec, no el código. El código es la consecuencia.

/spec diseña el documento de la feature haciendo preguntas clarificadoras y lo guarda en specs/NN-slug.md con estado Draft. Tú lo relees fuera del chat y cambias el estado a Approved a mano. Solo entonces /spec-impl valida el estado, crea la branch y implementa paso a paso con pausas para revisar cada diff.

Por qué lo hice

Trabajando con Claude Code me topé una y otra vez con el mismo patrón: un prompt amplio genera 400 líneas, las decisiones quedan implícitas y en la siguiente sesión el agente vuelve a improvisar — a veces en la dirección opuesta. El spec versionado en git hace las decisiones explícitas, persiste entre sesiones y se carga una sola vez como referencia.

Cómo se usa

npx skills@latest add elmerjacobo97/spec-flow-skills

# 1. Diseñar el spec
/spec levels-and-highscores

# 2. Releer fuera del chat y cambiar Status: Draft → Approved

# 3. Implementar solo lo aprobado
/spec-impl 03-levels-and-highscores

También hay instalador para Cursor, Codex, Antigravity y OpenCode si no usas Claude Code.

Lo que aprendí

El hueco entre las dos skills — releer y aprobar a mano — es lo que hace que el método no se degrade a “Claude escribe documentación bonita y luego el código que se le ocurra”. Sin ese contrato firmado por un humano, el spec es decorativo.

Problema

Cuando le pides a un LLM que construya una feature, improvisa decenas de decisiones de diseño invisibles. En la siguiente sesión no recuerda ninguna, y el contexto se llena pegando contexto a mano.

Solución

Dos skills en pareja: /spec diseña el documento con preguntas clarificadoras; tú lo relees y lo apruebas a mano; /spec-impl solo ejecuta specs Approved, paso a paso con pausas entre diffs.

Tecnologías

Claude CodeAgent SkillsMarkdownCursorSpec-driven

Resultados

Flujo instalable con npx skills@latest add elmerjacobo97/spec-flow-skills.

Soporte para Claude Code, Cursor, Codex, Antigravity y OpenCode.

El gap humano entre Draft y Approved es deliberado: Claude no puede aprobar su propio trabajo.

¿Quieres el CV o hablar del rol?

Disponible para empleo remoto a tiempo completo. Respondo en máximo 2 días laborables.

Contactar Descargar CV

// Siguiente caso

DriftWatch

Detecta cambios de schema en APIs externas antes de que rompan tu app.

Ver caso