doubt-driven-development SKILL.md skillA
doubt-driven-development from addyosmani/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add addyosmani/agent-skills/doubt-driven-development@git:20261029.c55b842Pins git:20261029.c55b842 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- addyosmani/agent-skills
- Path
skills/doubt-driven-development/SKILL.md- Versions recorded
- 5
- Latest version
- git:20261029.c55b842, committed Oct 29, 2026
- First version recorded
- May 7, 2026
- Size
- 16,753 bytes
- Repository stars
- 112,362
- License
- MIT
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.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Doubt-Driven Development
## Overview
A confident answer is not a correct one. Long sessions accumulate context that quietly turns assumptions into "facts" without anyone noticing. Doubt-driven development is the discipline of materializing a fresh-context reviewer — biased to **disprove**, not approve — before any non-trivial output stands.
This is not `/review`. `/review` is a verdict on a finished artifact. This is an in-flight posture: non-trivial decisions get cross-examined while course-correction is still cheap.
## When to Use
A decision is **non-trivial** when at least one of these is true:
- It introduces or modifies branching logic
- It crosses a module or service boundary
- It asserts a property the type system or compiler cannot verify (thread safety, idempotence, ordering, invariants)
- Its correctness depends on context the future reader cannot see
- Its blast radius is irreversible (production deploy, data migration, public API change)
Apply the skill when:
- About to make an architectural decision under uncertainty
- About to commit non-trivial code
- About to claim a non-obvious fact ("this is safe", "this scales", "this matches the spec")
…Read the whole file at its exact version.
How to install
mdr add addyosmani/agent-skills/doubt-driven-development@sha256:7a7d53d9d2b93ca7The line at the top of this page pins the label git:20261029.c55b842, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_jhviqtostzvelqpc)
6 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between May 7, 2026 and Oct 29, 2026, about one every 44 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261029.c55b842 latest | 2026-10-29 | c55b842 | 16,753 B | A | view · diff |
| git:20260907.cda4542 | 2026-09-07 | cda4542 | 16,647 B | A | view · diff |
| git:20260807.91d4d07 | 2026-08-07 | 91d4d07 | 16,499 B | A | view · diff |
| git:20260507.97e12d0 | 2026-05-07 | 97e12d0 | 16,487 B | A | view · diff |
| git:20260507.0af1a5e | 2026-05-07 | 0af1a5e | 12,592 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (16753 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
addyosmani/agent-skills · 112,362 stars · license MIT · pushed 2026-10-31 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_jhviqtostzvelqpc GET https://markdownregistry.com/api/v1/resolve?ref=addyosmani/agent-skills/doubt-driven-development GET https://markdownregistry.com/api/v1/blob/7a7d53d9d2b93ca7af8d882718753dc7887716f143e7937ecbc381f26416bda7
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from addyosmani/agent-skills
Every file in addyosmani/agent-skills