repowiseaddyosmani/agent-skills

addyosmani / agent-skills

Production-grade engineering skills for AI coding agents.

Shell★ 101,673
Use in your agentAsk this codebase

github.com/addyosmani/agent-skillsIndexed at 8c65303Up to date with upstream

What is agent-skills?

agent-skills is a collection of engineering skills for AI coding agents. It packages workflows, quality gates, and engineering practices so agents follow consistent steps across software development. The repository primarily uses Shell, with JavaScript files for validation.

Written by a model from the README and the source

93 files and 14 symbols in 3 modules, led by Shell (7 files) and JavaScript (2).

Start reading

Code health

9.3out of 10Excellent

This codebase scores 9.3 out of 10 for code health, which we rate excellent. It also scores maintainability 9.9 and static performance 9.8 out of 10. The three are scored separately and never blended into one number. Risk is concentrated, as it usually is: 1 of 93 files are git hotspots, and they average 7.6 — which is where the fixes pay off most.

Full health report

Use addyosmani/agent-skills in your agent

Point Claude Code, Cursor, Codex or VS Code at this repository. Your agent gets the index this page is built from: cited answers, callers, history and health for any file.

  1. 1.In Claude, open Customize → Connectors, click +, then Add custom connector. On a Team or Enterprise plan an owner adds it first under Organization settings → Connectors.
  2. 2.Paste the server URL below as the Remote MCP server URL, then click Add.
  3. 3.Click Connect. A Repowise sign-in window opens. Approve access.
  4. 4.Repowise's tools are now available in your Claude chats.

Connect with one click. Sign in with Repowise (OAuth), no API key to copy. Works in Claude on the web, desktop, and mobile.

Docs
bash
https://api.repowise.dev/mcp/addyosmani/agent-skills
Editors need an API key: sign in to create one.Sign in to connect

This repo is public, so anyone with a Repowise account and an API key can connect.

Try asking

  • get_overview()
  • get_answer("how is agent-skills put together?")
  • get_why("why is agent-skills structured this way?")

Explore agent-skills

Key features of agent-skills

  • agent-skills provides slash commands mapped to the development lifecycle from specification through shipping.
  • agent-skills activates skills automatically based on tasks such as API design and UI development.
  • agent-skills defines workflows with steps, checkpoints, exit criteria, and counter-arguments to common skipped steps.
  • agent-skills requires verification evidence at the end of every skill.
  • agent-skills supports progressive disclosure by loading supporting references only when needed.
  • agent-skills provides skills as plain Markdown for agents that accept system prompts or instruction files.

How addyosmani/agent-skills works

Input enters through slash commands such as /spec, /plan, /build, /test, /review, /webperf, /code-simplify, and /ship, which activate skills for development tasks. The skills directory stores the workflow definitions that agents follow. Each skill uses SKILL.md as its entry point and loads supporting references only when needed. The commands directory provides the lifecycle command definitions, while the references directory holds supporting material. The hooks directory and scripts/validate-skills.js support repository checks, and docs provides setup guidance for supported agent environments. Skills produce workflow progress and verification evidence such as tests passing, build output, or runtime data.

The codebase has 93 files and 14 symbols in 3 modules, led by Shell and JavaScript. Code health is 9.3 out of 10, rated excellent.

Getting started with agent-skills

  1. Install agent-skills as a Claude Code marketplace plugin.
    /plugin marketplace add addyosmani/agent-skills
  2. Install the Claude Code plugin.
    /plugin install agent-skills@addy-agent-skills
  3. Run Claude Code with the local plugin directory.
    claude --plugin-dir /path/to/agent-skills

Commands copied from the README

addyosmani/agent-skills FAQ

What is agent-skills?

agent-skills is a collection of production-grade engineering skills for AI coding agents. It packages workflows, quality gates, and best practices for software development.

How does agent-skills work?

agent-skills uses slash commands and automatically activated skills to guide agents through development workflows. Skills define steps, checkpoints, exit criteria, and verification evidence.

How do I install agent-skills?

agent-skills can be installed in Claude Code with the marketplace commands or run locally with claude --plugin-dir. It also provides installation commands for Antigravity CLI and Gemini CLI.

What language is agent-skills written in?

agent-skills is primarily written in Shell. The repository also includes JavaScript files, including scripts/validate-skills.js.

How is the agent-skills code organized?

agent-skills organizes workflow definitions in skills, documentation in docs, command definitions in commands, supporting material in references, and checks in hooks and scripts/validate-skills.js.

Who is agent-skills for?

agent-skills is for AI coding agents that need structured workflows for software development. Its skills cover activities including specification, planning, implementation, testing, review, and shipping.

What license does agent-skills use?

agent-skills uses the MIT license.

The summary, features and answers on this page are written by a model from the README and the source, and refreshed with each index.

About this page

Get a page like this for your own codebase

Repowise built this map of addyosmani/agent-skills from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Index your repo freeSee how Repowise worksFree for 2 public repos, with a page like this one.

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed.