Pular para o conteúdo

Skill To-Spec

Registre decisões acordadas como especificação e publique no rastreador configurado.

Comunidade · Matt Pocock
AutorMatt Pocock
LicençaMIT
Fontemattpocock/skills · SKILL.md no GitHub
Site do projetowww.aihero.dev/skills-to-spec
Funciona emClaude 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

Esta é uma skill da comunidade, de Matt Pocock, sem verificação nossa nem da Anthropic. Skills podem mandar o agente executar código, ler arquivos ou acessar a rede. Antes de instalar, leia o SKILL.md e todos os scripts da pasta, e procure qualquer coisa que não corresponda ao que ela diz fazer.

O que ela faz

  1. Leia conversa e decisões relevantes.
  2. Confirme pontos de teste e sintetize a especificação.
  3. 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 pastaPara que serve
SKILL.mdModelo, 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/
AgentePasta do projetoSua pasta de usuárioObservaçõ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).
Instale só skills em que você confia. A recomendação da Anthropic é usar skills apenas de fontes confiáveis e ler todos os arquivos de qualquer outra skill antes de usá-la: uma skill pode mandar o agente executar comandos, ler arquivos ou enviar dados de formas que a descrição não menciona.

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

Categorias de skills