Skill To-Spec
Registre decisões acordadas como especificação e publique no rastreador configurado.
Comunidade · Matt Pocock| Autor | Matt Pocock |
|---|---|
| Licença | MIT |
| Fonte | mattpocock/skills · SKILL.md no GitHub |
| Site do projeto | www.aihero.dev/skills-to-spec |
| Funciona em | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| Lido na fonte em |
to-spec sintetiza conversa já decidida em especificação. Usa código, glossário e decisões arquitetônicas sem outra entrevista de requisitos.
Confirma pontos de teste, registra histórias e escopo e publica no rastreador. Markdown local funciona com a configuração local.
Do SKILL.md da skill: ## Out of Scope
O que ela faz
- Leia conversa e decisões relevantes.
- Confirme pontos de teste e sintetize a especificação.
- Publique com o rótulo de triagem configurado.
O que você recebe
- Especificação com problema, solução, histórias, decisões, testes e exclusões.
Quando usar
- Preservar decisões em trabalhos de várias sessões.
Quando não usar
- Requisitos indecisos ou pequena mudança para uma sessão.
O que ela exige
- Agente com contexto e rastreador configurado por setup-matt-pocock-skills.
- Rastreadores remotos exigem autenticação e permissão; Markdown local dispensa serviço remoto.
Arquivos da skill
| Arquivo ou pasta | Para que serve |
|---|---|
SKILL.md | Modelo, confirmação de pontos de teste e publicação. |
Licença conforme encontrada no repositório em 2026-11-19: MIT.
Prompts de exemplo
Digite um destes depois de instalar; citar a skill pelo nome garante que ela seja usada.
- /to-spec — sintetize o desenho acordado de exportação de conta sem inventar requisitos.
- /to-spec — preserve exclusões e confirme primeiro os pontos de teste.
- /to-spec #42 — converta este mapa decidido em especificação implementável.
Como instalar a skill to-spec
Instalação e permissões
Instale e configure rastreador e rótulos com setup-matt-pocock-skills. Revise a configuração criada antes do uso.
Invocação manual: disable-model-invocation é true. Confirme destino e permissões; este site não cria issues.
Uma skill é uma pasta com um arquivo SKILL.md. Você instala uma vez; o agente lê a descrição curta no início de cada sessão e só carrega as instruções completas quando um pedido corresponde a ela. Escolha onde você usa:
Claude Code: copie a pasta para a sua pasta de skills
Coloque a pasta da skill em ~/.claude/skills/ para usá-la em todos os projetos deste computador, ou em .claude/skills/ dentro de um repositório para compartilhá-la com todos que trabalham nele (faça o commit).
git clone --depth 1 https://github.com/mattpocock/skills.git
mkdir -p ~/.claude/skills
cp -R skills/skills/engineering/to-spec ~/.claude/skills/O Claude Code percebe skills novas ou alteradas nessas pastas durante a sessão. Se a pasta de skills não existia quando a sessão começou, execute /reload-skills uma vez. Depois digite /to-spec ou apenas descreva a tarefa.
No Windows, execute os comandos no Git Bash ou no WSL, ou copie a pasta para o mesmo lugar pelo Explorador de Arquivos.
Codex, Gemini CLI, Cursor e GitHub Copilot
Esses agentes leem as mesmas pastas SKILL.md. A única pasta dentro de um projeto que os quatro aceitam é .agents/skills/, então este comando copia a skill para lá:
git clone --depth 1 https://github.com/mattpocock/skills.git
mkdir -p .agents/skills
cp -R skills/skills/engineering/to-spec .agents/skills/| Agente | Pasta do projeto | Sua pasta de usuário | Observações |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | Digite $ ou execute /skills para escolher uma skill; o Codex também escolhe uma sozinho quando a tarefa corresponde. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | Ou instale pelo Git com gemini skills install <git URL> --path <folder> --consent. Em 18 de junho de 2026, o Google substituiu o Gemini CLI pelo Antigravity CLI para usuários do nível gratuito e do Google One; o Antigravity usa .agents/skills/ no projeto e ~/.gemini/config/skills/ para você. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Digite / no chat do Agent para escolher uma skill. O Cursor também lê as pastas .claude/skills/ do Claude Code. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Funciona no Copilot CLI, no agente na nuvem e no modo agente do VS Code, do Visual Studio e dos IDEs da JetBrains (o suporte nos IDEs depende da versão). Ou execute gh skill install OWNER/REPOSITORY SKILL (prévia pública, GitHub CLI 2.90.0 ou mais recente). |
Fontes destas instruções
Conferido com a documentação de cada fornecedor em 2026-11-14:
Registro de decisões já tomadas
Preserve vocabulário e exclusões reais. Não invente decisões para preencher seções.
Para várias sessões, passe a to-tickets. Manter ambos no mesmo contexto evita buscar novamente uma issue muito grande.
Perguntas sobre a skill to-spec
Faz entrevista comigo?
Não faz nova entrevista de requisitos, mas confirma os pontos de teste com suas expectativas.
GitHub é obrigatório?
Não. O rastreador pode ser Markdown local ou serviço remoto compatível.
to-prd é o mesmo comando?
O autor renomeou para to-spec. Use o nome atual instalado.
ready-for-agent pode iniciar trabalho indesejado?
Sim. Agente que monitora pode tratar a especificação pai como tarefa. Exclua-a explicitamente da seleção dele.
Mais skills de IA
Skills relacionadas
Skill To-Tickets
Comunidade · Matt PocockDivida especificação em fatias verticais demonstráveis com bloqueios explícitos.Skill Writing Plans
Comunidade · Jesse Vincent / Prime RadiantConverta projeto aprovado em tarefas revisáveis com interfaces e verificação.Skill Brainstorming
Comunidade · Jesse Vincent / Prime RadiantTransforme a ideia inicial em um projeto aprovado antes de implementar.Skill Subagent-Driven Development
Comunidade · Jesse Vincent / Prime RadiantExecute plano aprovado com novos implementadores, revisões focadas e registro das tarefas.Hospedagem própria do n8n skill
Comunidade · Romuald CzłonkowskiImplante e mantenha n8n em Docker com HTTPS Caddy, serviços privados e backups verificados.n8n Code JavaScript skill
Comunidade · Romuald CzłonkowskiEscreva ou depure JavaScript no n8n com acesso e retornos conforme o modo.