CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

doubt-driven-development

Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when you want every assumption cross-examined before proceeding, when stress-testing a plan for hidden failure modes, when correctness matters more than speed, when working in unfamiliar code, when stakes are high (production auth, security-sensitive logic, a high-stakes migration, irreversible operations), or any time a confident output would be cheaper to verify now than to debug later.

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/doubt-driven-development/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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.

The body delivers an exceptionally clear, well-validated five-step workflow with mostly concrete, executable guidance — the reconciliation precedence order and bounded stop conditions are standout design. Its weaknesses are repetition of the cross-model rules across four sections and a monolithic single-file layout whose only file references dangle outside the bundle.

Suggestions

State the cross-model offer/skip rule once (in the escalation section) and have the Red Flags and Verification entries reference it in a few words instead of restating it, trimming the 'Skipping is fine; silent skipping is not' repetition across four sections.

Move the cross-model CLI details (PATH/version checks, shell-escaping guidance, codex/gemini example invocations) into a references/cross-model.md file and keep a short offer-or-skip decision block inline, cutting the main body substantially.

Fix or drop the dangling references: 'see agents/ for the roster' and '../../references/orchestration-patterns.md' do not resolve in this bundle — either include the referenced files or inline the one or two load-bearing facts (e.g., the persona roster) the reader needs.

DimensionReasoningScore

Conciseness

The body is dense with genuinely novel guidance and avoids explaining known concepts, but repeats key rules — the cross-model 'silent skipping is not okay' rule appears four times (escalation Step 4, Non-interactive contexts, Red Flags, and the Verification checklist) and the Rationalizations table re-treads earlier sections. It fits 'mostly efficient but could be tightened' better than the minor-trims-only anchor.

3 / 5

Actionability

Concrete, copy-paste-ready artifacts abound: the verbatim adversarial prompt, the CLAIM template, executable codex/gemini commands with sandbox flags, and a precedence-ordered finding taxonomy. Minor gaps remain — the core reviewer spawn in Step 3 has no concrete invocation example, and the 'see agents/ for the roster' pointer does not resolve to a file in the bundle.

4 / 5

Workflow Clarity

The five-step process is clearly sequenced with a checklist up front, explicit validation checkpoints (re-read the artifact before classifying, bounded 3-cycle stop, checkable 'doubt theater' signal), feedback loops (re-loop on actionable findings, fix the contract on misreads), and a closing verification checklist — a direct match for the top anchor.

5 / 5

Progressive Disclosure

In-file structure is well organized, but everything lives inline in a ~245-line SKILL.md: the ~55-line cross-model CLI section (tool flags, sandbox rationale, example commands) is a natural separate reference file. Both file references ('agents/' and '../../references/orchestration-patterns.md') fail to resolve within the bundle, leaving navigation to unverifiable paths — fitting the 'content that should be separate is inline / references not clearly resolvable' anchor.

3 / 5

Total

15

/

20

Passed

Description

78%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 with an explicit what-and-when structure and abundant natural trigger phrases spanning both routine (unfamiliar code, stress-testing plans) and high-stakes (production auth, irreversible operations) situations. Its only weaknesses are a single-action capability statement and a couple of missing common synonyms.

DimensionReasoningScore

Specificity

The description states one concrete action — 'Subjects every non-trivial decision to a fresh-context adversarial review' — clearly and in third person, but does not list several specific actions, matching the 'names domain and 1-2 concrete actions' anchor rather than the 'lists several specific actions' anchor.

3 / 5

Completeness

It explicitly answers both questions: the 'what' ('Subjects every non-trivial decision to a fresh-context adversarial review before it stands') and an explicit 'Use when...' clause with multiple concrete trigger conditions, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Rich natural trigger phrases — 'stress-testing a plan', 'hidden failure modes', 'working in unfamiliar code', 'correctness matters more than speed', 'cheaper to verify now than to debug later' — plus concrete stake contexts (production auth, security-sensitive logic, irreversible operations). A few natural synonyms like 'second opinion' or 'sanity check' are missing, so it falls just short of the comprehensive-coverage anchor.

4 / 5

Distinctiveness Conflict Risk

The in-flight adversarial-verification niche ('before it stands', 'assumption cross-examined before proceeding') is mostly distinct from post-hoc review skills, with only minor overlap risk against generic review/verification requests.

4 / 5

Total

16

/

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

addyosmani/agent-skills

Path

skills/doubt-driven-development/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.