Skills for Real Engineers. Straight from my .agents directory.
doubt-driven-development
Agent skill fromaddyosmani/agent-skills
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.
How to install doubt-driven-development
npx skills add addyosmani/agent-skills# or add only this skill to Claude Code: copy the folder
skills/doubt-driven-development/
# into
~/.claude/skills/doubt-driven-development/ (all projects)
.claude/skills/doubt-driven-development/ (one project)
1# Doubt-Driven Development23## Overview45A 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.67This 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.89## When to Use1011A decision is **non-trivial** when at least one of these is true:1213- It introduces or modifies branching logic14- It crosses a module or service boundary15- It asserts a property the type system or compiler cannot verify (thread safety, idempotence, ordering, invariants)16- Its correctness depends on context the future reader cannot see17- Its blast radius is irreversible (production deploy, data migration, public API change)1819Apply the skill when:2021- About to make an architectural decision under uncertainty22- About to commit non-trivial code23- About to claim a non-obvious fact ("this is safe", "this scales", "this matches the spec")24- Working in code you don't fully understand2526**When NOT to use:**2728- Mechanical operations (renaming, formatting, file moves)29- Following a clear, unambiguous user instruction30- Reading or summarizing existing code31- One-line changes with obvious correctness32…
Excerpt shown under the repository's MIT license.
More skills in agent-skills
- ▸api-and-interface-design
- ▸browser-testing-with-devtools
- ▸ci-cd-and-automation
- ▸code-review-and-quality
- ▸code-simplification
- ▸constraint-driven-development
- ▸context-engineering
- ▸debugging-and-error-recovery
- ▸deprecation-and-migration
- ▸documentation-and-adrs
- ▸frontend-ui-engineering
- ▸git-workflow-and-versioning
Similar skill repositories
An agentic skills framework & software development methodology that works.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Public repository for Agent Skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
