Skill To-Spec
Registra decisiones acordadas como especificación y publícala en el gestor configurado.
Comunidad · Matt Pocock| Autor | Matt Pocock |
|---|---|
| Licencia | MIT |
| Fuente | mattpocock/skills · SKILL.md en GitHub |
| Sitio del proyecto | www.aihero.dev/skills-to-spec |
| Funciona en | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| Leída en la fuente el |
to-spec sintetiza una conversación ya decidida como especificación. Usa código, glosario y decisiones arquitectónicas sin iniciar otra entrevista de requisitos.
Confirma puntos de prueba, registra historias y alcance, y publica una especificación en el gestor configurado. Admite Markdown con configuración de gestor local.
Del SKILL.md de la skill: ## Out of Scope
Qué hace
- Lee conversación y decisiones relevantes.
- Confirma puntos de prueba y sintetiza la especificación.
- Publica en el gestor con la etiqueta de clasificación configurada.
Qué obtienes
- Una especificación con problema, solución, historias, decisiones, pruebas y exclusiones.
Cuándo usarla
- Preservar decisiones para trabajo repartido entre sesiones.
Cuándo no usarla
- Requisitos sin decidir o un cambio que cabe en una sola sesión.
Qué necesita
- Agente con contexto y configuración de gestor mediante setup-matt-pocock-skills.
- Gestores remotos requieren herramientas autenticadas y permiso de publicación; Markdown local evita el servicio remoto.
Archivos de la skill
| Archivo o carpeta | Para qué sirve |
|---|---|
SKILL.md | Plantilla, confirmación de puntos de prueba y publicación. |
Licencia según el repositorio el 2026-11-19: MIT.
Prompts de ejemplo
Escribe uno de estos después de instalarla; si nombras la skill, te aseguras de que se use.
- /to-spec — sintetiza el diseño acordado de exportación sin inventar requisitos.
- /to-spec — conserva exclusiones y confirma primero los puntos de prueba.
- /to-spec #42 — convierte este mapa decidido en una especificación construible.
Cómo instalar to-spec
Instalación y permisos
Instala y configura gestor y etiquetas con setup-matt-pocock-skills. Revisa la configuración generada antes de usarla.
Se invoca manualmente: disable-model-invocation es true. Confirma destino y permisos; este sitio no crea incidencias.
Una skill es una carpeta con un archivo SKILL.md. La instalas una vez; el agente lee su breve descripción al empezar cada sesión y carga las instrucciones completas solo cuando una petición encaja. Elige dónde la usas:
Claude Code: copia la carpeta en tu carpeta de skills
Pon la carpeta de la skill en ~/.claude/skills/ para usarla en todos los proyectos de este ordenador, o en .claude/skills/ dentro de un repositorio para compartirla con todos los que trabajan en él (haz commit).
git clone --depth 1 https://github.com/mattpocock/skills.git
mkdir -p ~/.claude/skills
cp -R skills/skills/engineering/to-spec ~/.claude/skills/Claude Code detecta las skills nuevas o modificadas en estas carpetas durante la sesión. Si la carpeta de skills no existía al empezar la sesión, ejecuta /reload-skills una vez. Después escribe /to-spec o simplemente describe la tarea.
En Windows, ejecuta los comandos en Git Bash o WSL, o copia la carpeta al mismo sitio con el Explorador de archivos.
Codex, Gemini CLI, Cursor y GitHub Copilot
Estos agentes leen las mismas carpetas SKILL.md. La única carpeta que aceptan los cuatro dentro de un proyecto es .agents/skills/, así que esto copia la skill ahí:
git clone --depth 1 https://github.com/mattpocock/skills.git
mkdir -p .agents/skills
cp -R skills/skills/engineering/to-spec .agents/skills/| Agente | Carpeta del proyecto | Tu carpeta de usuario | Notas |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | Escribe $ o ejecuta /skills para elegir una skill; Codex también elige una cuando tu tarea encaja. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | O instálala desde Git con gemini skills install <git URL> --path <folder> --consent. El 18 de junio de 2026, Google sustituyó Gemini CLI por Antigravity CLI para los usuarios del nivel gratuito y de Google One; Antigravity usa .agents/skills/ en un proyecto y ~/.gemini/config/skills/ para ti. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Escribe / en el chat de Agent para elegir una skill. Cursor también lee las carpetas .claude/skills/ de Claude Code. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Funciona en Copilot CLI, en el agente en la nube y en el modo agente de VS Code, Visual Studio y JetBrains (la compatibilidad con cada IDE depende de la versión). O ejecuta gh skill install OWNER/REPOSITORY SKILL (vista previa pública, GitHub CLI 2.90.0 o posterior). |
Fuentes de estos pasos
Comprobado con la documentación de cada proveedor el 2026-11-14:
Registro de decisiones ya tomadas
Conserva vocabulario y exclusiones reales del proyecto. No inventes decisiones para rellenar secciones.
Para varias sesiones, pásala a to-tickets. Mantener ambos pasos en el mismo contexto evita volver a obtener una incidencia muy grande.
Preguntas sobre to-spec
¿Me hará una entrevista?
No pretende entrevistar de nuevo, pero confirma que los puntos de prueba encajen con tus expectativas.
¿Requiere GitHub?
No. Usa el gestor configurado: Markdown local o gestor remoto compatible.
¿to-prd es el mismo comando?
El autor lo renombró to-spec. Usa el nombre actual instalado.
¿ready-for-agent puede disparar trabajo no deseado?
Sí. Un agente que consulta etiquetas puede tomar la especificación padre como tarea. Exclúyela explícitamente de su selección.
Más skills de IA
Skills relacionadas
Skill To-Tickets
Comunidad · Matt PocockDivide una especificación en cortes verticales demostrables con dependencias explícitas.Skill Writing Plans
Comunidad · Jesse Vincent / Prime RadiantConvierte un diseño aprobado en tareas revisables con interfaces y verificación.Skill Brainstorming
Comunidad · Jesse Vincent / Prime RadiantConvierte una idea inicial en un diseño acordado antes de implementar.Skill Subagent-Driven Development
Comunidad · Jesse Vincent / Prime RadiantEjecuta un plan aprobado con implementadores nuevos, revisiones acotadas y registro de tareas.n8n autohospedado skill
Comunidad · Romuald CzłonkowskiDespliega y mantiene n8n con Docker, HTTPS mediante Caddy, servicios privados y copias verificadas.n8n Code JavaScript skill
Comunidad · Romuald CzłonkowskiEscribe o depura JavaScript en n8n con acceso y retornos según el modo.