# Addy Osmani’s agent skills

Canonical: https://cqbase.net/en/entry/agent-skills
Chinese: https://cqbase.net/zh/entry/agent-skills
English: https://cqbase.net/en/entry/agent-skills

> Engineering skills for coding agents, aimed at code you can keep rather than a one-shot generation.

Addy Osmani publishes a MIT-licensed set of skills that encode engineering habits he wants coding agents to follow. The repository describes them as production-grade skills: the point is code that can stay in a codebase, not a single generation that merely runs.

Pick a skill close to your stack, read what it tells the agent to check first, and only then copy it into your skill directory. Treat the repo as a source of checklists, not something to install wholesale.

## What problem it solves

[addyosmani/agent-skills](https://github.com/addyosmani/agent-skills) is a set of engineering skills for coding agents, maintained by Addy Osmani and collaborators. The repository presents them as reusable workflows and quality checks across a development cycle: specifying work, breaking it into tasks, implementing with tests, reviewing, and shipping. The companion site is [skills.addy.ie](https://skills.addy.ie). The repository is MIT licensed and is not archived.

Verified on 2026-11-16 (Asia/Shanghai). The latest GitHub Release is [0.6.16](https://github.com/addyosmani/agent-skills/releases/tag/0.6.16), published at 04:33 UTC on 14 November 2026, which is 12:33 Asia/Shanghai the same day. The current README describes 25 skills and nine slash commands that map to that lifecycle (including `/spec`, `/plan`, `/build`, `/test`, `/review`, and `/ship`). This is not a pack you must install in full. Official docs also show how to install a single skill.

## Who it is for

It is for people already using Claude Code, Cursor, Codex, or another skill-aware coding tool, who want the agent to spell out a spec and a verification bar before changing code. If you only need a one-off edit to a small file, you do not need the whole pack first.

The repository also has a [comparison document](https://github.com/addyosmani/agent-skills/blob/main/docs/comparison.md) that contrasts this pack with Superpowers and other skill sets. Read that yourself; do not treat star counts or second-hand summaries as the decision. Before installing, read the `SKILL.md` you actually plan to enable and see what it tells the agent to check first.

## How to install it

The commands below come from the repository [README](https://github.com/addyosmani/agent-skills/blob/main/README.md) as checked on 2026-11-16. Official docs present the [vercel-labs/skills](https://github.com/vercel-labs/skills) CLI as a shortcut across many agents. Browse first, then install only what you need, rather than defaulting to all 25 skills:

```bash
npx skills add addyosmani/agent-skills --list
npx skills add addyosmani/agent-skills --skill test-driven-development
```

If you do want the full pack, the official command is:

```bash
npx skills add addyosmani/agent-skills
```

**Claude Code**

The README marks Claude Code as a recommended integration. Register the marketplace, then install the plugin:

```text
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
```

If cloning fails over SSH, official docs suggest the full HTTPS URL:

```text
/plugin marketplace add https://github.com/addyosmani/agent-skills.git
/plugin install agent-skills@addy-agent-skills
```

If a built-in Claude Code command already uses the same name (the README explicitly mentions `/review`), use the namespaced form, such as `/agent-skills:review`.

**Cursor**

Official guidance is to place workflow skills under `.cursor/skills/` in your project (sync from the repo’s `skills/` directory) and to put short policies in `.cursor/rules/*.mdc`. Do not paste a full skill body into rules. This repository does not ship a `.cursor/` folder. Details are in [docs/cursor-setup.md](https://github.com/addyosmani/agent-skills/blob/main/docs/cursor-setup.md).

**Codex CLI**

The README requires Codex CLI v0.122 or later:

```bash
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills
```

Other tools (Gemini CLI, OpenCode, Copilot, and others) have their own setup pages. Use the links in the current README.

## A worked example

This example starts from the official `test-driven-development` skill and enables only that one skill on a tiny practice task. This guide did not run it, so it does not invent test output or the agent transcript.

1. Run `npx skills add addyosmani/agent-skills --list`, confirm the current skill name, then install just that skill as in the previous section (or, in Claude Code, install the official plugin and invoke only the testing skill).
2. In a disposable practice directory, give the agent a narrow task, such as adding a failing test for an existing function and then writing only enough code to make it pass. A starting prompt: `Use the test-driven-development skill. Add a failing unit test for the existing function that parses a date string, then write the minimum code to make it pass. Do not refactor unrelated files.`
3. Expected effect (from the skill’s purpose, not from a run on this machine): the agent should add a test and see it fail before changing production code.
4. Review the diff and the test command yourself. If the skill refers to a shared checklist under the repo-level `references/` directory and the file is missing, read the next section before reinstalling.

## Common pitfalls

- Installing all 25 skills on the first try. The full pack brings spec, test, and review workflows that may collide with conventions you already have. Read the `SKILL.md` and install one skill first.
- Using a per-skill `npx skills add ... --skill` install and then wondering why shared checklists are missing. The current README still says this path copies only `skills/<name>/` and not the repo-level `references/` directory; the skill still works, but those supplementary checklists are unavailable. The README points at [issue #361](https://github.com/addyosmani/agent-skills/issues/361). That issue was closed at 20:14 UTC on 3 August 2026 (04:14 Asia/Shanghai on 4 August 2026), with `state_reason` completed. This guide did not re-run `npx` to check whether the gap is fully gone, so follow the current README: use a whole-repo integration, clone the repository, or copy the needed checklist into the installed skill directory.
- Typing `/review` in Claude Code and invoking a built-in review command instead of this pack’s skill. Official docs say to use `/agent-skills:review`.
- Registering the marketplace with the default SSH URL on Windows or macOS and hitting `Permission denied (publickey)`. Switch to the HTTPS form in the README instead of retrying the same SSH command.
- Pasting a full `SKILL.md` into Cursor rules. Official Cursor setup says not to do that.

## FAQ

### Do I have to install all 25 skills at once?

No. Official docs also support `--list` to browse and `--skill` to install one skill. A safer path is to install one skill that matches the current task, confirm that its checks fit your repository, and only then add more.

### What is the Claude Code install command?

The README checked on 2026-11-16 says: `/plugin marketplace add addyosmani/agent-skills`, then `/plugin install agent-skills@addy-agent-skills`. If you hit SSH errors, use the HTTPS repository URL from the README.

### Why can’t the skill find a shared checklist?

The current README still says a per-skill install does not copy the repo-level `references/` directory. The [issue #361](https://github.com/addyosmani/agent-skills/issues/361) it cites is already closed. This guide did not run the installer to verify the behavior on 0.6.16, so treat the current README as authoritative.

### How is this different from Superpowers?

Both are skill packs for coding agents, but they are shaped differently and trigger differently. Read the repository’s own [comparison.md](https://github.com/addyosmani/agent-skills/blob/main/docs/comparison.md). This page does not treat a third-party write-up as a conclusion.

### What is the license, and which version is current?

The repository is MIT licensed; see [LICENSE](https://github.com/addyosmani/agent-skills/blob/main/LICENSE). As of 2026-11-16, the latest release is 0.6.16 (12:33 Asia/Shanghai on 14 November 2026). Read the full license before commercial use or redistribution.

## Sources and license

The [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills) repository is licensed under MIT. This page is a paraphrase, for CQBase — Context & Query Base, of the README, the [0.6.16 release notes](https://github.com/addyosmani/agent-skills/releases/tag/0.6.16), the [Cursor setup doc](https://github.com/addyosmani/agent-skills/blob/main/docs/cursor-setup.md), and [issue #361](https://github.com/addyosmani/agent-skills/issues/361), all checked on 2026-11-16. If install commands change, the repository README wins.

## Catalog record

- Author: addyosmani
- License: MIT
- Source: https://github.com/addyosmani/agent-skills
- Added: 2026-11-15
- GitHub stars: 117708 (captured 2026-11-15)

