CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

doubt-driven-review

Skill de revisão adversarial em tempo real — submete toda decisão não-trivial a um revisor de contexto fresco, viesado a REFUTAR, antes dela ficar de pé. Diferente do Reviewer final (skill 11, veredito pos-hoc em PR pronta), esta skill entra EM VOO, enquanto corrigir rota ainda é barato. Use antes de decisão arquitetural sob incerteza, antes de commitar código não-trivial, antes de afirmar um fato não-óbvio ("isso é seguro", "isso escala"), ou trabalhando em código que você não entende totalmente. Trigger em: "tem certeza disso", "migration nao vai quebrar", "duvida isso", "decisao de arquitetura antes de eu commitar", "revisa antes de eu commitar", "revisa isso adversarialmente", "isso ta certo mesmo", "questiona essa suposicao", "declarar isso seguro", "refuta essa claim", "decisao", "adversarial review", "doubt driven", "segunda opiniao antes de seguir", "acho que ta certo mas".

73

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured process skill with genuinely executable guidance: templates, taxonomy, precedence rules, stop conditions, and anti-pattern tables all earn their tokens. The main gaps are mild redundancy around the skill-11 distinction and references to governance/policy files that do not exist in the skill's bundle.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — no explanation of what subagents or code review are, and every section (stop conditions, rationalization table, red flags) carries operational weight. Not 5 because the skill-11 distinction is stated three separate times (intro, 'Quando Usar' context, rationalizations table, 'Interação') and the 'Quando Nao Usar' guidance is partly re-stated in the rationalizations table, which could be tightened.

4 / 5

Actionability

Fully actionable for an instruction-only skill: a copyable 5-step checklist, a literal adversarial reviewer prompt template with ARTEFATO/CONTRATO placeholders and explicit anti-validation instructions, a concrete dispatch command ('Agent tool com subagent_type: "dev-team-kit-fv:code-reviewer"'), a four-class finding taxonomy with precedence order, and explicit stop conditions (3 cycles, escalate).

5 / 5

Workflow Clarity

The five-step process (CLAIM → EXTRACT → DUVIDA → RECONCILIA → PARA) is clearly sequenced with a checklist, has explicit validation (relere o texto do artefato contra cada finding antes de classificar), built-in feedback loops (correct the contract and re-classify; change the artifact and reloop), and explicit stopping/escalation rules including a checkable 'teatro de dúvida' signal. This matches the anchor-5 structure of sequence + validation + error-recovery loops.

5 / 5

Progressive Disclosure

For a process skill of this size the single-file structure is appropriate and the sectioning is clean and navigable, with a source attribution at the end. Not 5 because the 'Governanca Global' section references GLOBAL.md and three policies/*.md files that are not present in the skill's bundle, leaving dead-end navigation, and no bundle organization (references/scripts) is used to offset the body's length.

4 / 5

Total

18

/

20

Passed

Description

91%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete what, explicit use-when guidance, a rich list of natural trigger phrases, and active disambiguation from the sibling final-review skill. The only weaknesses are the very broad single-word trigger 'decisao' and the fact that the capability is described as one composite action rather than several distinct ones.

DimensionReasoningScore

Specificity

The description names a concrete action ('submete toda decisão não-trivial a um revisor de contexto fresco, viesado a REFUTAR, antes dela ficar de pé') with specific application contexts (architectural decisions, non-trivial commits, non-obvious factual claims). Not 5 because it describes a single composite capability rather than multiple distinct concrete actions; not 3 because the what is fully concrete and contextualized with example claims ('isso é seguro', 'isso escala').

4 / 5

Completeness

Both questions are answered explicitly: the 'what' is adversarial in-flight review by a fresh-context, refutation-biased reviewer, and the 'when' is given by an explicit 'Use antes de...' clause plus a dedicated trigger list. This mirrors the anchor-5 good example structure of what + when with concrete trigger phrases.

5 / 5

Trigger Term Quality

The 'Trigger em:' list provides comprehensive natural phrases a user would actually say — 'tem certeza disso', 'migration nao vai quebrar', 'revisa antes de eu commitar', 'isso ta certo mesmo', 'segunda opiniao antes de seguir', 'acho que ta certo mas' — plus synonyms and jargon variants ('adversarial review', 'doubt driven', 'refuta essa claim'). Coverage including informal synonyms matches the top anchor exactly.

5 / 5

Distinctiveness Conflict Risk

The description actively disambiguates from the closest neighbor ('Diferente do Reviewer final (skill 11, veredito pos-hoc em PR pronta), esta skill entra EM VOO'), giving it a clear niche. Not 5 because the standalone trigger 'decisao' is very broad and could fire on any decision-adjacent mention, creating minor overlap risk with general review/planning skills.

4 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

felvieira/claude-skills-fv

Path

skills/53-doubt-driven-review/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.