Skip to main content
Lab Grimoire
TW EN
Coffee
ai-tools

agent-skills

23 production-grade engineering skills for AI coding agents by Addy Osmani (Google Chrome). Covers the full Define-to-Ship lifecycle with Doubt-Driven Development for adversarial self-verification, Anti-rationalization Tables to prevent shortcutting, and 3 specialist personas for parallel review. Pure Markdown, zero dependencies. MIT licensed.

Best For

Any developer using AI coding agents (Claude Code, Cursor, Copilot, Gemini CLI) who has noticed the pattern: the AI skips specs, omits tests, ignores security checks, and takes shortcuts when context gets long. This skill pack addresses that structural problem. Particularly valuable for teams shipping production code where quality gates matter.

How I Actually Use It

Install the skill pack, and your AI agent gains 23 engineering skills organized across the full development lifecycle. The key shift is that these aren't just "best practice reminders" — each skill includes Anti-rationalization Tables that preemptively list reasons the agent might skip a step, paired with counterarguments.

The standout skill is Doubt-Driven Development (DDD). When you make an architectural decision or write security-critical code, DDD runs a five-step cycle: declare the decision (CLAIM), isolate the output artifact (EXTRACT), hand it to an adversarial verifier in a fresh context (DOUBT), classify each finding by severity (RECONCILE), and decide whether to stop or loop (STOP). The verifier never sees the original reasoning — only the artifact and its contract — so it can't be talked into agreeing.

The /ship command fans out three specialist personas in parallel — code reviewer, security auditor, test engineer — then merges their findings before release.

Where It Is Strong

  • Doubt-Driven Development is a genuine structural innovation, not prompt-level "please double-check." It architecturally separates claim from artifact and uses context isolation for adversarial review. Supports cross-model escalation (Claude writes, GPT reviews)
  • Anti-rationalization Tables in every skill anticipate and block the specific shortcuts AI agents tend to take
  • 23 skills cover Define (interview-me, idea-refine, spec-driven-development), Plan, Build (DDD, TDD, source-driven-development, context-engineering), Verify (browser-testing, debugging), Review (code-review, simplification, security, performance), and Ship (git workflow, CI/CD, documentation, launch checklist)
  • Pure Markdown, zero runtime dependencies. Works identically across Claude Code, Cursor, Copilot, Gemini CLI, and others. No vendor lock-in
  • Addy Osmani's engineering taste. Each skill reflects decisions from someone who has shipped at Google-scale, not generic advice

Where It Fails

  • DDD effectiveness is unquantified. The design logic is sound, but there's no published data on how many bugs it actually catches versus baseline
  • Skill selection ambiguity. When multiple skills could apply, the agent's selection logic isn't documented. In practice, you guide it
  • Context consumption. Loading all 23 skills simultaneously would be expensive. The progressive disclosure design helps, but large tasks can still hit limits
  • Single maintainer. Addy Osmani's reputation is strong, but bus factor is 1

Pricing, Difficulty, and Risk

Free, MIT license. Installation is cloning into your skills directory. Medium difficulty — you need to understand the lifecycle model and know which skills to invoke when, but the slash commands make common patterns accessible. No privacy risk; everything is local Markdown. The main risk is over-relying on DDD cycles when shipping speed matters more than exhaustive verification.

Verdict

The most comprehensive and well-designed AI engineering skill pack available. If you use an AI coding agent for anything beyond throwaway scripts, install this. Start with three skills: doubt-driven-development for critical decisions, spec-driven-development for features, and source-driven-development for framework usage. Expand from there as your workflow matures. The 41,000+ stars aren't hype — the engineering depth backs them up.

Source