← all repositories
addyosmani/agent-skills

A staff engineer's playbook, compressed for LLMs

Twenty-three structured Markdown skills that teach AI agents to spec, build, test, and ship like senior developers.

49k stars Shell Coding Assistants
agent-skills
Velocity · 7d
+435
★ / day
Trend
steady
star history

What it does

Agent Skills is a collection of 23 Markdown-based instruction sets — plus three specialist personas — that plug into Claude Code, Cursor, Gemini CLI, Windsurf, Copilot, and others. Each skill encodes a specific engineering workflow: spec-driven development, test-driven development, doubt-driven development, code review, security hardening, shipping, and more. Agents invoke them via slash commands (/spec, /build, /ship) or automatically based on context.

The interesting bit

The clever angle is doubt-driven development: a built-in adversarial loop where the agent must extract claims, doubt them, reconcile, and stop — with optional cross-model escalation. It’s essentially a structured way to make an LLM argue with itself before it commits to a bad architectural decision.

Key highlights

  • 23 skills covering the full lifecycle, from vague-idea interview to staged rollout
  • Automatic skill activation by task type (API design triggers api-and-interface-design, UI work triggers frontend-ui-engineering)
  • Reference checklists for testing, security, performance, and accessibility
  • Plain Markdown format works with any agent that accepts system prompts
  • ~47K stars and explicit setup docs for seven major tools

Caveats

  • Effectiveness depends heavily on how well your specific agent follows long structured prompts
  • Some skills (like doubt-driven-development) require user-authorized escalation steps that may interrupt flow
  • The “95% confidence” target in interview-me is a heuristic, not a measurable threshold

Verdict

Worth a look if you’re tired of AI agents skipping tests, writing specs after the fact, or shipping without rollback plans. Probably overkill if you’re just using Copilot for autocomplete or one-off scripts.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.