Pular pro conteúdo

To Spec skill

Depois de discutir uma ideia com o agente, um comando junta tudo num documento com problema, solução, histórias de usuário e decisões, já na lista de tarefas.

por Matt Pocock

instalações
720,9 mil
estrelas no GitHub
303,3 mil
No skills.sh desde
julho de 2026
Licença
MIT

Atualizada no GitHub em 22 de outubro de 2026. Dados conferidos em 26 de outubro de 2026, no skills.sh e no GitHub.

O que ela faz

A to-spec pega o que você já conversou com o agente e o que ele sabe do código e escreve a especificação da funcionalidade, o documento que muita gente chama de PRD. Ela não te entrevista: só junta o que já foi dito.

O agente lê o projeto, usa o vocabulário do glossário e respeita as decisões já registradas. Depois propõe onde a funcionalidade vai ser testada, no menor número de pontos possível, e confere com você antes de escrever.

O documento sai num modelo fixo: o problema e a solução do ponto de vista de quem usa, uma lista longa de histórias de usuário, as decisões de implementação e de teste, e o que fica de fora. Ela publica no rastreador de tarefas com a etiqueta ready-for-agent.

Nas palavras de quem fez

Turn the current conversation into a spec and publish it to the project issue tracker: no interview, just synthesis of what you've already discussed.

Matt Pocock, no SKILL.md

Quando usar

  • Depois de uma conversa longa sobre uma funcionalidade nova, pra não perder o que foi decidido
  • Antes de mandar o agente programar, pra ele ter um documento de onde partir
  • Registrar o pedido de um cliente como tarefa no GitHub do projeto
  • Passar uma ideia pra outra pessoa ou outro agente implementar

Depois de instalar, é só pedir assim

  • /to-spec com o que a gente combinou sobre a área de membros
  • /to-spec com tudo o que a gente falou do novo checkout, e publica no GitHub
  • /to-spec: transforma essa conversa sobre o painel de vendas numa especificação

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

  • Gen Agent Trust HubPassou
  • SocketPassou
  • SnykPassou

Perguntas

Como instalar a To Spec no Claude Code?

Toca em Levar, aqui nesta página, e deixa seu nome, e-mail e WhatsApp (é uma vez só). Aparece uma frase pronta: cola ela no Claude Code, que ele mesmo instala a To Spec, e a skill passa a valer na próxima conversa. A mesma frase serve no Codex. Se preferir fazer na mão, o passo a passo está em como instalar skills no Claude Code.

O que ela precisa pra funcionar?

Saber onde ficam as tarefas e quais etiquetas usar. Isso vem da skill setup-matt-pocock-skills; se ela não tiver rodado, o agente avisa. Com GitHub, publica pelo programa gh; também funciona com arquivos no próprio projeto. Não pede chave de API nem conta paga.

Ela roda sozinha?

Não. Ela só roda quando chamada: digite /to-spec. E não faz perguntas, fora confirmar os pontos de teste: se a ideia ainda está crua, converse antes, porque ela só resume o que já foi dito.

Roda no Codex e no Antigravity?

As instruções são texto num SKILL.md, que esses agentes também leem. Pra publicar no GitHub ou no GitLab, o agente precisa conseguir rodar o gh ou o glab no terminal.

Levar essa skill

1x to-specR$ 0,00

TotalR$ 0,00

A skill sai aqui mesmo, na hora. Seus dados eu uso pra falar com você sobre o MazyOS.

Levar precisa do JavaScript ligado. O código da skill está no GitHub: github.com/mattpocock/skills

Aprenda a usar

Mais da loja Matt Pocock

Ver a loja Matt Pocock