{"name":"agent-skills: Production-Grade Engineering Skills for AI Coding Agents","description":"agent-skills is a comprehensive GitHub repository offering production-grade engineering skills for AI coding agents. It provides structured workflows, quality gates, and best practices that senior engineers use to build reliable software. These skills help AI agents consistently follow robust development processes across all phases.","github":"https://github.com/addyosmani/agent-skills","url":"https://osrepos.com/repo/addyosmani-agent-skills","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/addyosmani-agent-skills","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/addyosmani-agent-skills.md","json":"https://osrepos.com/repo/addyosmani-agent-skills.json","topics":["agent-skills","ai-agents","development","engineering-skills","best-practices","javascript","workflow-automation","github-repo"],"keywords":["agent-skills","ai-agents","development","engineering-skills","best-practices","javascript","workflow-automation","github-repo"],"stars":null,"summary":"agent-skills is a comprehensive GitHub repository offering production-grade engineering skills for AI coding agents. It provides structured workflows, quality gates, and best practices that senior engineers use to build reliable software. These skills help AI agents consistently follow robust development processes across all phases.","content":"## Introduction\n\nThe `agent-skills` repository, created by Addy Osmani, provides a collection of production-grade engineering skills designed for AI coding agents. This project aims to equip AI agents with the workflows, quality gates, and best practices that senior engineers employ when building software. By integrating these skills, AI agents can consistently follow robust development processes, ensuring higher quality and more reliable code across every phase of software development, from defining ideas to shipping to production.\n\n## Installation\n\nGetting started with `agent-skills` is straightforward, offering flexibility for various AI agents and workflows.\n\nThe fastest path is using the open [skills CLI](https://github.com/vercel-labs/skills \"skills CLI\" target=\"_blank\"):\n\nbash\nnpx skills add addyosmani/agent-skills            # install all 24 skills\nnpx skills add addyosmani/agent-skills --list     # browse before installing\n\n\nYou can also install individual skills:\n\nbash\nnpx skills add addyosmani/agent-skills --skill code-review-and-quality\nnpx skills add addyosmani/agent-skills --skill test-driven-development\n\n\nFor native integrations, `agent-skills` supports a wide range of tools. For example, with Claude Code:\n\nbash\n/plugin marketplace add addyosmani/agent-skills\n/plugin install agent-skills@addy-agent-skills\n\n\nRefer to the [official documentation](https://github.com/addyosmani/agent-skills#quick-start \"Quick Start\" target=\"_blank\") for detailed setup instructions for Cursor, Antigravity CLI, Gemini CLI, GitHub Copilot, and other agents.\n\n## Examples\n\n`agent-skills` organizes its capabilities around the software development lifecycle, offering 8 slash commands that activate specific skill sets automatically.\n\nHere are some key commands:\n\n| What you're doing | Command | Key principle |\n|-------------------|---------|---------------|\n| Define what to build | `/spec` | Spec before code |\n| Plan how to build it | `/plan` | Small, atomic tasks |\n| Build incrementally | `/build` | One slice at a time |\n| Prove it works | `/test` | Tests are proof |\n| Review before merge | `/review` | Improve code health |\n| Ship to production | `/ship` | Faster is safer |\n\nBeyond these commands, the repository includes 24 distinct skills covering various aspects of engineering. For instance:\n\n*   **`spec-driven-development`**: Guides agents to write a Product Requirements Document (PRD) before any code is written.\n*   **`test-driven-development`**: Enforces the Red-Green-Refactor cycle and best practices for testing.\n*   **`code-review-and-quality`**: Provides a five-axis review process for changes before merging.\n*   **`security-and-hardening`**: Focuses on OWASP Top 10 prevention and secure coding practices.\n\nThe repository also features pre-configured specialist agent personas, such as `code-reviewer`, `test-engineer`, and `security-auditor`, for targeted reviews.\n\n## Why Use Agent Skills?\n\nAI coding agents often default to the shortest path, potentially skipping crucial steps like writing specifications, comprehensive testing, or security reviews. `agent-skills` addresses this by providing structured workflows that enforce the same discipline senior engineers bring to production code.\n\nEach skill encodes hard-won engineering judgment, guiding agents on *when* to write a spec, *what* to test, *how* to review, and *when* to ship. These are not generic prompts, but opinionated, process-driven workflows that elevate the quality of AI-generated code from prototype-level to production-ready. The skills integrate best practices from Google's engineering culture, including concepts from \"Software Engineering at Google\" and Google's engineering practices guide, embedding principles like Hyrum's Law, the Beyonce Rule, and Chesterton's Fence directly into the step-by-step workflows.\n\n## Links\n\n*   **GitHub Repository**: [https://github.com/addyosmani/agent-skills](https://github.com/addyosmani/agent-skills \"GitHub Repository\" target=\"_blank\")\n*   **Skills CLI**: [https://github.com/vercel-labs/skills](https://github.com/vercel-labs/skills \"Skills CLI\" target=\"_blank\")","metrics":{"detailViews":4,"githubClicks":2},"dates":{"published":null,"modified":"2026-08-14T07:13:55.000Z"}}