cqbase.net · English & Chinese

CQBase

Context & Query Base

Skills

Addy Osmani’s 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.

This page is a guide, not the original text.

What problem it solves

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. The repository is MIT licensed and is not archived.

Verified on 2026-11-16 (Asia/Shanghai). The latest GitHub Release is 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 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 as checked on 2026-11-16. Official docs present the 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:

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:

npx skills add addyosmani/agent-skills

Claude Code

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

/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:

/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.

Codex CLI

The README requires Codex CLI v0.122 or later:

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. 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 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. 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. 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 repository is licensed under MIT. This page is a paraphrase, for CQBase — Context & Query Base, of the README, the 0.6.16 release notes, the Cursor setup doc, and issue #361, all checked on 2026-11-16. If install commands change, the repository README wins.

Subscribe to CQBase Weekly

One email a week with newly catalogued public AI skills, prompts, MCP servers, and methods. Unsubscribe at any time. We will not hand your address to a third party for their marketing.