What Are agent-skills?
agent-skills by Addy Osmani is a collection of production-grade engineering skills for AI coding agents. Where most skill collections focus on convenience, agent-skills focuses on correctness: production standards for performance, security, testing, code review, API design, and documentation.
These skills encode the standards a senior engineer would apply — not rules of thumb, but detailed, opinionated guidance derived from real production experience.
Skill Categories in Detail
Performance Optimization
The performance skill encodes specific profiling workflows: what to measure first, how to read a flame graph, when bundle splitting helps vs. hurts, and how to evaluate caching tradeoffs. It's not generic advice — it's a step-by-step process.
Security Hardening
Security skills cover the OWASP Top 10 with concrete detection patterns, not just descriptions. The skill guides Claude through input validation checks, authentication flow review, secret scanning, and dependency vulnerability assessment.
Testing and CI/CD
Opinionated standards for test coverage (what matters, what doesn't), integration test design, flaky test diagnosis, and CI pipeline configuration for common platforms (GitHub Actions, CircleCI, GitLab CI).
Code Review
A structured review checklist that Claude applies consistently: correctness, performance implications, security surface, test coverage, naming, and documentation. PR feedback follows a consistent format that's easy to parse and act on.
How to Install agent-skills?
npx skills add addyosmani/agent-skills | Or clone and symlink: git clone https://github.com/addyosmani/agent-skills ~/.agents/skills/agent-skills