Agent Skills (addyosmani)
Agent Skills is a collection of production-grade engineering skills packaged as Markdown files that AI coding agents can follow to apply senior-level workflows, quality gates, and best practices across the software development lifecycle. It solves the problem of inconsistent or low-quality output from AI agents by encoding structured processes for defining, planning, building, testing, reviewing, and shipping code. It is for developers and teams using AI coding agents like Claude Code, Cursor, Codex, and others who want to enforce engineering standards and improve code quality.
🎬 What AI Agent Skills Are and How They Work · IBM Technology
✨ Key features
- 9 slash commands mapping to development lifecycle phases
- 25 skills covering spec, plan, build, test, review, ship
- Automatic skill activation based on task context
- Works with 70+ agents via skills CLI
- Native integrations for Claude Code, Cursor, Codex, and more
- Includes meta-skill to discover which skill applies
🎯 Use cases
- Enforce spec-driven development for new features
- Automate test-driven development with red-green-refactor
- Run code reviews with five-axis quality checks
- Audit web performance with Core Web Vitals targets
- Simplify complex code while preserving behavior
📦 Installation
🧰 Requirements: Requires Node.js for npx CLI, or a compatible AI coding agent; no API keys or accounts needed.
npx skills add addyosmani/agent-skills # install all 25 skills
npx skills add addyosmani/agent-skills --list # browse before installing
Or install individual skills:
npx skills add addyosmani/agent-skills --skill code-review-and-quality
npx skills add addyosmani/agent-skills --skill interview-me
npx skills add addyosmani/agent-skills --skill test-driven-development
For Claude Code marketplace install:
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
For local development:
git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skills
🚀 Usage
# After installation, invoke a skill in your agent's chat
/spec
/plan
/build
/test
/constraints
/review
/webperf
/code-simplify
/ship
Or use /build auto to generate plan and implement tasks autonomously.
⚠️ Good to know
Installing a single skill via npx does not copy the repo-level references/ directory, so paths to supplementary shared checklists are unavailable; this portability gap is tracked in issue #361.
❓ FAQ
How do I install all skills?
Run npx skills add addyosmani/agent-skills to install all 25 skills into your agent.
Can I use Agent Skills with Claude Code?
Yes, you can install via the marketplace with /plugin marketplace add addyosmani/agent-skills and /plugin install agent-skills@addy-agent-skills, or clone the repo and use claude --plugin-dir.
What is the /build auto command?
It generates the plan and implements every task in a single approved pass, removing manual steps between tasks while still verifying each task with tests and committing individually.
Do skills work with agents other than Claude Code?
Yes, skills are plain Markdown and work with any agent that accepts system prompts or instruction files, and the skills CLI supports 70+ agents.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.