ClaudeMap

Addy Osmani's Agent Skills

Production-grade engineering skills for AI coding agents — 25 skills and 9 lifecycle slash commands, from spec to ship.

Skills & Commandsskillsengineeringslash-commandsbest-practicesworkflow

Addy Osmani packages the workflows, quality gates and best practices senior engineers use into 25 skills plus 9 slash commands that map the development lifecycle: /spec, /plan, /build, /test, /constraints, /review, /webperf, /code-simplify and /ship. Skills also activate automatically from context — designing an API triggers api-and-interface-design, UI work triggers frontend-ui-engineering. /build auto approves the plan once, then implements every task autonomously, test-driven and committed individually, pausing on failures or risky steps. The practices are lifted from Google's engineering culture — Software Engineering at Google, Hyrum's Law in API design, the Beyonce Rule and test pyramid in testing, Chesterton's Fence in simplification — embedded into step-by-step workflows agents actually follow. Installs into 70+ agents via the open skills CLI, or natively as a Claude Code plugin.

What it does

  • 25 skills and 9 slash commands mapping the full lifecycle — /spec /plan /build /test /constraints /review /webperf /code-simplify /ship
  • /build auto: approve the plan once, then it implements every task in one autonomous pass — still test-driven, committed individually, pausing on failures or risky steps
  • Context-driven auto-activation: skills load from what you are doing, so the quality gates apply without you remembering to invoke them
  • Google engineering culture baked in — Hyrum's Law, the Beyonce Rule, test pyramid, Chesterton's Fence, trunk-based development, drawn from Software Engineering at Google and Google's eng-practices guide

When to use it

Teams that want senior-engineer quality gates enforced consistently by the agent in every phase — spec, plan, build, test, review, ship — instead of hoping each session remembers them.

Getting started

# any of 70+ agents via the open skills CLI:
npx skills add addyosmani/agent-skills            # all 25 skills
npx skills add addyosmani/agent-skills --list     # browse first
npx skills add addyosmani/agent-skills --skill code-review-and-quality   # just one

# Claude Code native plugin:
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

Things to know

MIT. A per-skill npx install copies only skills/<name>/, not the repo-level references/ checklists — a tracked portability gap (issue #361); use a whole-repo install if you want those shared checklists.

Repository

addyosmani/agent-skills

Charted

Related on the map

  • Guizang's agent skill turns your repo's recent updates into a finished promo video — real components, code-rendered animation, an original code-written soundtrack — no video editor involved.

    • agent-skill
    • video
    • promo
    • marketing
  • An agent skill that geolocates a photo with nothing readable in it — OSM geometry, elevation skylines and satellite tiles turn “where was this taken?” into a measured answer with an error radius.

    • agent-skill
    • geolocation
    • osint
    • openstreetmap
  • A skill that makes AI coding agents map the architecture and declare the blast radius before they touch a line of code — rendered as one standalone HTML page.

    • skill
    • architecture
    • code-visualization
    • change-scope