> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getunblocked.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> Extend your AI coding agents with specialized Unblocked workflows

Skills are modular, prompt-driven packages that teach your AI coding agents how to best leverage Unblocked. Each [MCP tool](/unblocked-mcp/mcp-overview) has a corresponding skill -- where tools provide capabilities, skills provide the judgment to use them well, encoding when to reach for each tool, how to write effective queries, and how to interpret results. Skills follow the open [Agent Skills specification](https://agentskills.io/specification), work across Claude Code, Cursor, Windsurf, and other supported agents, and are open-source in the [unblocked/skills](https://github.com/unblocked/skills) repository.

## Install

### Quick install (macOS)

The macOS install script installs skills automatically alongside the MCP server:

```bash theme={null}
curl -fsSL https://getunblocked.com/install-mcp.sh | bash
```

### Other methods

<Tabs>
  <Tab title="Unblocked CLI">
    If the Unblocked CLI is already installed, you can install or update skills separately:

    ```bash theme={null}
    unblocked install-skills
    ```
  </Tab>

  <Tab title="Claude Code plugin">
    Install skills directly from the Claude Code plugin marketplace:

    ```
    /plugin marketplace add unblocked/skills
    /plugin install unblocked-skills
    ```
  </Tab>

  <Tab title="Skills CLI">
    Install using the standalone skills CLI:

    ```bash theme={null}
    npx skills add unblocked/skills
    ```
  </Tab>

  <Tab title="Manual copy">
    Copy the skill directory into your agent's skills folder:

    ```bash theme={null}
    # Claude Code
    cp -r skills/<skill-name> ~/.claude/skills/

    # Cursor
    cp -r skills/<skill-name> .cursor/skills/
    ```
  </Tab>
</Tabs>

## How skills are installed

Skills are stored in a canonical location at `~/.agents/skills/` and symlinked into each agent's own skills directory (e.g. `~/.claude/skills/`, `~/.cursor/skills/`, `~/.codeium/windsurf/skills/`). The installer auto-detects which agents you have installed and configures all of them.

## Automatic updates

Skills are automatically kept up to date. Each time the Unblocked CLI runs, it fetches the latest skills from GitHub and writes them to `~/.agents/skills/`. If you modify a skill locally, Unblocked detects the change and stops updating that specific skill so your customizations are never overwritten.

## Cookbook

The [Unblocked Cookbook](https://github.com/unblocked/cookbook) contains ready-made recipes that compose Unblocked skills for specific scenarios. Recipes are designed to be forked and customized for your environment.

Available recipes include workflows for code review, planning, ticket enrichment, bug validation, incident investigation, and more -- in both interactive and headless variants.

To use a recipe, copy its directory into your project's skills folder:

```bash theme={null}
cp -r recipes/<recipe-name> .claude/skills/<recipe-name>
```

See the [cookbook repository](https://github.com/unblocked/cookbook) for the full list of recipes and instructions for running them in CI/CD.