addyosmani/agent-skills

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.

50K installs 108K stars

Before you install

Last update
Files in folder
1
Scripts
No script files found
SKILL.md size
16 KB (about 4,162 tokens of context each time it loads)
License
MIT
Source on GitHub
addyosmani/agent-skills

Skills are plain text instructions the agent follows, sometimes with scripts. Check the source, prefer repositories with many installs and stars, and read any script it ships.

Install

npx skills add addyosmani/agent-skills@doubt-driven-development

Runs in a terminal with Node.js 18 or newer. Add -y to skip the prompts and -g to install for every project instead of this one.

Install for your agent

npx skills add addyosmani/agent-skills@doubt-driven-development --agent claude-code -y
Project install writes to
.claude/skills/doubt-driven-development
Global install writes to
~/.claude/skills/doubt-driven-development

Start a new session afterwards so the agent picks the skill up. In Claude Code you can also call it directly with /doubt-driven-development.

What it does

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…

Excerpt from the skill's own SKILL.md. Read the full file on GitHub before installing: skills run with your agent's permissions.

Categories

Related skills

  • code-review-and-quality

    addyosmani/agent-skills

    Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch. Use when asked to review a diff or a pull request, even when the diff is pasted inline.

  • security-and-hardening

    addyosmani/agent-skills

    Hardens code against vulnerabilities. Use when auditing an input handler for vulnerabilities, when handling user input, authentication, data storage, or external integrations, or when checking a login flow is safe against the OWASP Top Ten. Use when building any feature that accepts untrusted data, manages user sessions, or interacts with third-party services. Use when auditing dependencies for known vulnerabilities, triaging package-manager audit findings, or assessing supply-chain risk in a new package. Use when personal data or privacy compliance (GDPR, CCPA) is involved.

    63K installs 108KSecurityDataCode review
  • frontend-ui-engineering

    addyosmani/agent-skills

    Builds production-quality, accessible, responsive user-facing UIs. Use when building or modifying interfaces and pages, creating components, implementing layouts, meeting WCAG accessibility requirements, managing state, or when the output needs to look and feel production-quality rather than AI-generated.

    60K installs 108KDesign & UIReact & Next.js
  • spec-driven-development

    addyosmani/agent-skills

    Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when drafting a PRD or requirements document with objectives and scope, or when requirements are unclear, ambiguous, or only exist as a vague idea. Use when a single requirement spans several independently testable capabilities and needs decomposing into a capability map of modules before specifying.

    58K installs 108KWriting
  • performance-optimization

    addyosmani/agent-skills

    Optimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.

    58K installs 108K
  • planning-and-task-breakdown

    addyosmani/agent-skills

    Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.

← Search skills

/skills/addyosmani/agent-skills/doubt-driven-development/