A prompt-based skill that makes AI coding agents write only the code a task needs, favoring reuse and minimal solutions over large implementations.
addyosmani/agent-skills
A set of production-grade engineering workflow skills, packaged as Markdown, that guide AI coding agents through spec, plan, build, test, review, and ship.
- Stars
- 108,400
- Forks
- 11,298
- Open issues
- 134
- Last commit
- 7 days ago
What is it?
Agent Skills is a collection of structured SKILL.md workflows that teach AI coding agents to follow the habits of senior engineers: writing a spec before code, breaking work into small verifiable tasks, practicing test-driven development, reviewing changes against a five-axis checklist, and shipping with feature flags and staged rollouts. The pack contains 25 skills grouped by lifecycle phase (define, plan, build, verify, review, ship), plus a meta-skill that routes incoming work to the right one.
The skills are plain Markdown, so they work with any agent that accepts system prompts or instruction files. The repository ships adapters for Claude Code (as plugin slash commands such as /spec, /plan, /build, /test, /review, /ship), Gemini CLI, Codex, Antigravity, Copilot and others, and the open skills CLI can install individual skills with npx. It also includes four specialist personas (code reviewer, test engineer, security auditor, web performance auditor) and shared checklists for security, performance, accessibility and observability.
Key features
- 01Covers the full development lifecycle with slash commands for spec, plan, build, test, review and ship.
- 02Each skill has step-by-step processes, verification gates and common rationalizations to watch for.
- 03Installable per skill or as a whole pack across many agents via the skills CLI or native plugins.
- 04Includes specialist personas for code review, testing, security auditing and web performance auditing.
- 05Ships reference checklists for security, performance, accessibility and observability.
Use cases
- Giving an AI coding agent consistent engineering discipline for features that touch many files.
- Adding a spec-first and test-first workflow to a team that uses Claude Code, Codex or Gemini CLI.
- Running a five-axis code review or security audit on changes before merging.
- Onboarding agents to an existing codebase with an incremental, verification-first rollout.
Quick start
- 1
Install all skills with the open skills CLI
npx skills add addyosmani/agent-skills - 2
Or add the Claude Code marketplace and install the plugin
/plugin marketplace add addyosmani/agent-skills
Things to know
- Individual skill installs omit the shared references/ directory, so some supplementary checklists are unavailable.
Topics
FAQ
- What is agent-skills?
- A set of production-grade engineering workflow skills, packaged as Markdown, that guide AI coding agents through spec, plan, build, test, review, and ship. Agent Skills is a collection of structured SKILL.md workflows that teach AI coding agents to follow the habits of senior engineers: writing a spec before code, breaking work into small verifiable tasks, practicing test-driven development, reviewing changes against a five-axis checklist, and shipping with feature flags and staged rollouts. The pack contains 25 skills grouped by lifecycle phase (define, plan, build, verify, review, ship), plus a meta-skill that routes incoming work to the right one.
- Is agent-skills free to use? What license does it have?
- agent-skills is open source under the MIT license. Check the license terms before using it in commercial products.
- Is agent-skills still maintained?
- Actively maintained. The last commit to agent-skills was on Oct 13, 2026.
- What can I use agent-skills for?
- Giving an AI coding agent consistent engineering discipline for features that touch many files. Adding a spec-first and test-first workflow to a team that uses Claude Code, Codex or Gemini CLI. Running a five-axis code review or security audit on changes before merging. Onboarding agents to an existing codebase with an incremental, verification-first rollout.
- How do I install agent-skills?
- Install all skills with the open skills CLI: npx skills add addyosmani/agent-skills Or add the Claude Code marketplace and install the plugin: /plugin marketplace add addyosmani/agent-skills
- Where can I get agent-skills?
- The source code and installation instructions are on GitHub: https://github.com/addyosmani/agent-skills
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A curated directory of 1000+ Claude Skills and plugins for Claude Code, Claude.ai and coding agents like Codex, Cursor and Gemini CLI.
A plugin of 36 AI coding-agent skills that runs a loop of brainstorm, plan, build, review, and capture learnings for reuse.
An Agent Skill that lets coding agents write and run custom Playwright browser automation scripts for tests and multi-step web tasks.
A terminal UI for viewing, checking, installing and updating agent skills across Claude Code, OpenCode, Codex, Cursor and other coding agents.
A collection of 67 specialized skill packs that turn Claude Code into a pair programmer for full-stack development.