Saltar al contenido

Skill To-Spec

Registra decisiones acordadas como especificación y publícala en el gestor configurado.

Comunidad · Matt Pocock
AutorMatt Pocock
LicenciaMIT
Fuentemattpocock/skills · SKILL.md en GitHub
Sitio del proyectowww.aihero.dev/skills-to-spec
Funciona enClaude 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

Esta es una skill de la comunidad creada por Matt Pocock, sin revisar por nosotros ni por Anthropic. Las skills pueden indicar al agente que ejecute código, lea archivos o acceda a la red. Antes de instalarla, lee su SKILL.md y cada script de la carpeta, y busca cualquier cosa que no encaje con lo que dice hacer.

Qué hace

  1. Lee conversación y decisiones relevantes.
  2. Confirma puntos de prueba y sintetiza la especificación.
  3. 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 carpetaPara qué sirve
SKILL.mdPlantilla, 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/
AgenteCarpeta del proyectoTu carpeta de usuarioNotas
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).
Instala solo skills de confianza. Anthropic aconseja usar solo skills de fuentes de confianza y leer todos los archivos de cualquier otra skill antes de usarla: una skill puede indicar al agente que ejecute comandos, lea archivos o envíe datos de formas que su descripción no menciona.

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

Categorías de skills