SkillSpec Writer
Transforma uma ideia aproximada mais respostas curtas em um rascunho de especificação estruturado: objetivo, público, escopo, não objetivos, requisitos e critérios de aceitação, com uma pontuação de completude de 9 pontos e cada lacuna listada como pergunta aberta.
Funciona com: Claude Code, Codex, Cursor, Muse · Versão 1.0.0 · Você precisa de: Seu brief: brief.txt (linhas rotuladas — Title, Idea, Audience, Goal, mais itens In / Out / Need / Check / Constraint).
Obtenha este Skill com o Premium Ver planos
Prévia
Resultado de exemplo
Um exemplo do que este Skill produz. Conteúdo de amostra, mostrado para ilustração.
Spec Writer report — sample Completeness: 100/100 (9/9 required answers) | Gaps: 0 | Errors: 0 | Warnings: 0 Spec: BeanLoop Weekly Digest — Goal: Send one useful digest every Friday without manual assembly. Audience: Solo founders who ship weekly. In scope: Pull shipped items from the changelog; Group items by feature area. Non-goals: No social-media posting. Requirements: 3. Acceptance criteria: 2, including a short note for weeks with no shipped items. Constraint: Must run in under 5 minutes, local only. Open questions: None.
O que você recebe
- Um rascunho de especificação estruturado: objetivo, público, ideia, escopo, não objetivos, requisitos, critérios de aceitação, restrições
- Uma pontuação de completude: 9 itens obrigatórios, cada lacuna como uma pergunta aberta
- Seções faltantes marcadas “Not yet defined” — nunca preenchidas com conteúdo inventado
- Todos os erros e avisos de entrada apontados no relatório
Sobre este Skill
Lê um arquivo de texto simples que você escreve — brief.txt, uma linha rotulada por resposta (Title / Idea / Audience / Goal, mais linhas repetíveis In / Out / Need / Check / Constraint) — e produz spec.md: a especificação em ordem fixa com suas palavras textuais, uma pontuação de completude (arredondamento de 100 x preenchidos / 9 itens obrigatórios), cada item faltante como pergunta aberta marcada “Not yet defined”, e todos os erros e avisos de entrada. Apenas local, apenas biblioteca padrão; nada é inventado para preencher uma lacuna: 100/100 significa que o brief está completo, não que a especificação seja boa, e o rascunho ainda precisa de revisão humana antes de alguém construir a partir dele.
Experimente
Transforme esta ideia aproximada e estas respostas em uma especificação estruturada — objetivo, escopo, não objetivos, requisitos e critérios de aceitação.Ideal para
- Colocar uma ideia por escrito antes de alguém construir a coisa errada
- Acordar escopo e não objetivos no papel, não em uma reunião
- Verificar um brief respondido pela metade para ver exatamente o que falta
Não serve para
- Julgar se uma especificação é boa — completude não é qualidade
- Aprovar escopo ou esforço — um rascunho não é uma decisão
- Inventar respostas faltantes para aumentar a pontuação
Como instalar
- Copie o prompt de instalação no seu agente:
Read https://skillu.dev/install/agent.md, then install the Spec Writer skill (spec-writer). - Ou baixe o pacote do Skill nesta página após o lançamento e coloque a pasta dele no diretório de skills do seu agente.
- Chame-o com um comando de barra, ex.:
/spec-writer, e descreva o que você quer em palavras simples.
Perguntas frequentes
Como a completude é pontuada?
Nove itens obrigatórios: Title, Idea, Audience, Goal, pelo menos um item In, pelo menos um item Out, pelo menos um item Need, pelo menos um item Check, pelo menos um item Constraint. Pontuação = arredondamento(100 x preenchidos / 9). Um brief completo pontua 100/100; um brief só com título e ideia pontua 22/100.
O que acontece com um item faltante?
Ele fica como “Not yet defined” no rascunho e aparece como uma pergunta aberta a responder. O script nunca adivinha um público, um requisito ou uma restrição para aumentar a pontuação.