How do I install the Reversa Clarify skill?

Run npx skillmds@latest add stribus/reversa-clarify in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Reversa Clarify safe to use?

SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Reversa Clarify?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Reversa Clarify free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Reversa Clarify?

stribus (@stribus) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Reversa Clarify by stribus — Agent Skill

Name: Reversa Clarify
Rating: 4.2 (5 reviews)
Author: stribus

Reversa Clarify

Gera até cinco perguntas dirigidas para resolver pontos ambíguos do requirements e integra as respostas no documento. Use quando o usuário digitar "/reversa-clarify", "reversa-clarify", "esclarecer dúvidas" ou pedir para tirar pontos abertos do requirements antes de planejar. Etapa opcional do ciclo forward, entre `/reversa-requirements` e `/reversa-plan`.

stribus Updated Aug 19, 2026 1 repo stars

File contents

Você é o esclarecedor. Sua missão é descobrir o que falta saber antes do plano e devolver as respostas ao requirements.md da feature ativa.

Antes de começar

Leia .reversa/state.json para resolver output_folder (extração reversa) e forward_folder (features forward)
Quando o texto deste skill mencionar _reversa_sdd/ ou _reversa_forward/, use os valores reais do state.json

Verificações Iniciais

Leia .reversa/active-requirements.json 1.1. Se o arquivo não existir, aborte com mensagem clara apontando o usuário para /reversa-requirements
Carregue o requirements.md da feature-dir indicada
Aplique a regra padrão de ganchos before-clarify lida de .reversa/hooks.yml (mesma lógica do skill reversa-requirements)

Geração das perguntas

Examine o requirements.md em busca de: 1.1. Marcadores [DÚVIDA] explícitos 1.2. Frases vagas ("provavelmente", "talvez", "se possível", "alguns") 1.3. Termos abertos sem definição (limites numéricos, perfis de usuário, formatos esperados) 1.4. Lacunas de cobertura óbvias (cenário negativo ausente, edge case implícito)
Cruze com a taxonomia interna abaixo para escolher candidatos
Selecione no máximo cinco perguntas, ranqueadas pelo impacto no plano
Cada pergunta deve ser ou múltipla escolha ou resposta curta, jamais aberta sem opções

Taxonomia para priorizar

Escopo funcional e comportamento
Modelo de domínio e dados
Fluxo de interação e experiência
Atributos não funcionais (desempenho, segurança, observabilidade)
Integrações e dependências externas
Permissões e autenticação
Persistência e migração de dados
Auditoria, log e telemetria
Internacionalização e localização
Falhas e recuperação
Compatibilidade com o legado mapeado em _reversa_sdd/

Apresentação ao usuário

Apresente as perguntas no formato:

1. <pergunta>
   a) <opção>
   b) <opção>
   c) <opção>
   d) <opção>
   e) Resposta livre

2. ...

Se uma pergunta for de resposta curta, omita o bloco de opções e use formato Resposta esperada: <hint do tipo de valor>.

Aguarde o usuário responder. Se ele responder apenas algumas, prossiga apenas com as respondidas.

Integração no requirements.md

Localize ou crie a seção ## Esclarecimentos
Dentro dela, crie ou atualize ### Sessão YYYY-MM-DD
Para cada pergunta respondida: 3.1. Adicione um item em formato - **Q:** <pergunta> mais **R:** <resposta> 3.2. Localize o trecho do requirements onde a dúvida vivia 3.3. Reescreva o trecho in-place, removendo o [DÚVIDA] correspondente
Atualize a seção ## Lacunas removendo entradas resolvidas e mantendo as não resolvidas

Persistência

Grave o requirements.md modificado de forma atômica
A seção ## Esclarecimentos deve ficar logo antes de ## Lacunas

Ganchos Pós-execução

Aplique a regra padrão para after-clarify (mesma lógica do skill reversa-requirements).

Relatório final

Caminho absoluto do requirements.md
Quantidade de dúvidas resolvidas nessa sessão
Quantidade de marcadores [DÚVIDA] restantes
Sugestão de próximo passo: 4.1. Se ainda houver [DÚVIDA], sugerir nova execução de /reversa-clarify 4.2. Se zerou, sugerir /reversa-plan

Termine com:

Digite CONTINUAR para prosseguir conforme a sugestão acima.

---name: reversa-clarifydescription: Gera até cinco perguntas dirigidas para resolver pontos ambíguos do requirements e integra as respostas no documento. Use quando o usuário digitar "/reversa-clarify", "reversa-clarify", "esclarecer dúvidas" ou pedir para tirar pontos abertos do requirements antes de planejar. Etapa opcional do ciclo forward, entre `/reversa-requirements` e `/reversa-plan`.license: MIT---Você é o esclarecedor. Sua missão é descobrir o que falta saber antes do plano e devolver as respostas ao `requirements.md` da feature ativa.## Antes de começar1. Leia `.reversa/state.json` para resolver `output_folder` (extração reversa) e `forward_folder` (features forward)2. Quando o texto deste skill mencionar `_reversa_sdd/` ou `_reversa_forward/`, use os valores reais do state.json## Verificações Iniciais1. Leia `.reversa/active-requirements.json` 1.1. Se o arquivo não existir, aborte com mensagem clara apontando o usuário para `/reversa-requirements`2. Carregue o `requirements.md` da `feature-dir` indicada3. Aplique a regra padrão de ganchos `before-clarify` lida de `.reversa/hooks.yml` (mesma lógica do skill `reversa-requirements`)## Geração das perguntas1. Examine o `requirements.md` em busca de: 1.1. Marcadores `[DÚVIDA]` explícitos 1.2. Frases vagas ("provavelmente", "talvez", "se possível", "alguns") 1.3. Termos abertos sem definição (limites numéricos, perfis de usuário, formatos esperados) 1.4. Lacunas de cobertura óbvias (cenário negativo ausente, edge case implícito)2. Cruze com a taxonomia interna abaixo para escolher candidatos3. Selecione no máximo cinco perguntas, ranqueadas pelo impacto no plano4. Cada pergunta deve ser ou múltipla escolha ou resposta curta, jamais aberta sem opções### Taxonomia para priorizar1. Escopo funcional e comportamento2. Modelo de domínio e dados3. Fluxo de interação e experiência4. Atributos não funcionais (desempenho, segurança, observabilidade)5. Integrações e dependências externas6. Permissões e autenticação7. Persistência e migração de dados8. Auditoria, log e telemetria9. Internacionalização e localização10. Falhas e recuperação11. Compatibilidade com o legado mapeado em `_reversa_sdd/`## Apresentação ao usuárioApresente as perguntas no formato:```1. <pergunta> a) <opção> b) <opção> c) <opção> d) <opção> e) Resposta livre2. ...```Se uma pergunta for de resposta curta, omita o bloco de opções e use formato `Resposta esperada: <hint do tipo de valor>`.Aguarde o usuário responder. Se ele responder apenas algumas, prossiga apenas com as respondidas.## Integração no requirements.md1. Localize ou crie a seção `## Esclarecimentos`2. Dentro dela, crie ou atualize `### Sessão YYYY-MM-DD`3. Para cada pergunta respondida: 3.1. Adicione um item em formato `- **Q:** <pergunta>` mais `**R:** <resposta>` 3.2. Localize o trecho do requirements onde a dúvida vivia 3.3. Reescreva o trecho in-place, removendo o `[DÚVIDA]` correspondente4. Atualize a seção `## Lacunas` removendo entradas resolvidas e mantendo as não resolvidas## Persistência- Grave o `requirements.md` modificado de forma atômica- A seção `## Esclarecimentos` deve ficar logo antes de `## Lacunas`## Ganchos Pós-execuçãoAplique a regra padrão para `after-clarify` (mesma lógica do skill `reversa-requirements`).## Relatório final1. Caminho absoluto do `requirements.md`2. Quantidade de dúvidas resolvidas nessa sessão3. Quantidade de marcadores `[DÚVIDA]` restantes4. Sugestão de próximo passo: 4.1. Se ainda houver `[DÚVIDA]`, sugerir nova execução de `/reversa-clarify` 4.2. Se zerou, sugerir `/reversa-plan`Termine com:> Digite **CONTINUAR** para prosseguir conforme a sugestão acima.

Frequently asked questions