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

# Install AdAdvisor Skills in Claude Code (Plugin Marketplace)

> Install the entire AdAdvisor skills plugin in Claude Code with two commands. The plugin marketplace handles installs, updates, and uninstalls automatically.

Claude Code supports AdAdvisor Skills through the plugin marketplace system. Two commands install all eight skills for managing Meta (Facebook) ads, with automatic updates whenever AdAdvisor ships changes.

<Note>
  Claude Code 2.1 or later is required. Run `claude --version` to check. Update with `claude update` (or your package manager equivalent) if you are below 2.1.
</Note>

## Prerequisites

1. **An AdAdvisor account** with at least one Meta ad account connected. [Sign up here](https://app.adadvisor.ai) if you have not already.
2. **The AdAdvisor MCP server connected** in Claude Code. See [Setting Up Your MCP Client](/ai/setting-up-your-mcp-client). The Claude Code tab has the exact commands.
3. **Claude Code 2.1+** with the `/plugin` command available.

## How do I install AdAdvisor Skills in Claude Code?

<Steps>
  <Step title="Add the marketplace">
    Open Claude Code and run:

    ```
    /plugin marketplace add AdAdvisor/skills
    ```

    Claude Code clones the public AdAdvisor skills repository and registers it as a marketplace. You will see a confirmation:

    ```
    ✔ Successfully added marketplace: adadvisor (declared in user settings)
    ```
  </Step>

  <Step title="Install the plugin">
    Run:

    ```
    /plugin install adadvisor@adadvisor
    ```

    This installs the full plugin (all eight skills). The format reads as `<plugin-name>@<marketplace-name>`. Both happen to be `adadvisor` since this is a single-plugin marketplace.

    You will see:

    ```
    ✔ Successfully installed plugin: adadvisor@adadvisor (scope: user)
    ```
  </Step>

  <Step title="Verify">
    Run `/plugin list` to see the installed plugin:

    ```
    Installed plugins:

      ❯ adadvisor@adadvisor
        Version: 0.1.0
        Scope: user
        Status: ✔ enabled
    ```

    Run `/plugin details adadvisor` to see the eight skills it bundles:

    ```
    Component inventory
      Skills (8)  adadvisor, adadvisor-audit, adadvisor-creative,
                  adadvisor-diagnose, adadvisor-launch, adadvisor-playbooks,
                  adadvisor-scale, adadvisor-targeting
    ```
  </Step>

  <Step title="Test">
    Start a fresh Claude Code session in any project and try a trigger:

    ```
    audit my AdAdvisor account
    ```

    Claude should load the audit skill, call MCP tools (`list_ad_accounts`, `get_pixel_health`, `get_performance`), and return a structured audit report.
  </Step>
</Steps>

## How do I install via the CLI?

If you prefer the terminal over the interactive `/plugin` command:

```bash theme={null}
# Add the marketplace
claude plugin marketplace add AdAdvisor/skills

# Install the plugin
claude plugin install adadvisor@adadvisor

# List installed plugins
claude plugin list

# Show details
claude plugin details adadvisor
```

Both routes do exactly the same thing.

## What gets installed?

The plugin clones into `~/.claude/plugins/cache/adadvisor/` and registers eight skills under the `adadvisor` namespace:

| Skill folder           | Slash command                    | Auto-trigger phrases                     |
| ---------------------- | -------------------------------- | ---------------------------------------- |
| `adadvisor/`           | `/adadvisor:adadvisor`           | "adadvisor", "meta ads", "my ad account" |
| `adadvisor-audit/`     | `/adadvisor:adadvisor-audit`     | "audit my account", "review my ads"      |
| `adadvisor-diagnose/`  | `/adadvisor:adadvisor-diagnose`  | "CPA went up", "should I kill this"      |
| `adadvisor-launch/`    | `/adadvisor:adadvisor-launch`    | "launch a campaign", "create an ad"      |
| `adadvisor-scale/`     | `/adadvisor:adadvisor-scale`     | "scale this winner", "increase budget"   |
| `adadvisor-creative/`  | `/adadvisor:adadvisor-creative`  | "test ads", "refresh creatives"          |
| `adadvisor-targeting/` | `/adadvisor:adadvisor-targeting` | "lookalike", "retargeting", "audience"   |
| `adadvisor-playbooks/` | `/adadvisor:adadvisor-playbooks` | "BFCM", "product launch", "recovery"     |

You do not need to type slash commands. Skills auto-trigger on natural phrasing. The slash form is just a manual override.

Token cost per session: about 1,900 tokens always-on (descriptions for routing), plus 2,000 to 3,000 extra when any single skill fires.

## How do I update AdAdvisor Skills in Claude Code?

```
/plugin marketplace update adadvisor
/plugin update adadvisor
```

Or via CLI:

```bash theme={null}
claude plugin marketplace update adadvisor
claude plugin update adadvisor
```

The marketplace points at the `main` branch of the [GitHub repository](https://github.com/AdAdvisor/skills), so update fetches whatever is current on main.

## How do I uninstall AdAdvisor Skills?

```
/plugin uninstall adadvisor
/plugin marketplace remove adadvisor
```

The first command removes the plugin. The second removes the marketplace entry from your settings.

## Can I install AdAdvisor Skills in just one project?

Yes. The default scope is `user` (installed for all your projects). To install only in the current project:

```bash theme={null}
claude plugin install adadvisor@adadvisor --scope project
```

This writes the plugin reference into `<project>/.claude/settings.json` instead of your user settings. Useful when you want one project to have AdAdvisor skills and others not to.

## Troubleshooting

### Why does the install say "Source type not supported"?

Update Claude Code. The plugin uses the `github` source type which requires CC 2.1.0 or later. Run `claude --version` to check, `claude update` to upgrade.

### Why don't the skills appear after install?

Run `/plugin list` to confirm the install succeeded. If it shows `Status: ✔ enabled` but skills do not trigger, run `/reload-plugins` to force CC to re-scan installed plugins.

### Why does it say "Failed to install: source not found"?

The marketplace cache may be stale. Try:

```
/plugin marketplace remove adadvisor
/plugin marketplace add AdAdvisor/skills
/plugin install adadvisor@adadvisor
```

### Why do MCP tools fail when a skill runs?

The AdAdvisor MCP server is not connected. Run `/mcp` and verify the `adadvisor` server appears and is authenticated. If not, set it up first. See [Setting Up Your MCP Client](/ai/setting-up-your-mcp-client).

## Frequently asked questions

<AccordionGroup>
  <Accordion title="How do I install AdAdvisor Skills in Claude Code?">
    Run two commands. First `/plugin marketplace add AdAdvisor/skills` to register the marketplace, then `/plugin install adadvisor@adadvisor` to install the plugin. The plugin includes all eight AdAdvisor skills (foundation, audit, diagnose, launch, scale, creative, targeting, playbooks). Verify with `/plugin list` and `/plugin details adadvisor`.
  </Accordion>

  <Accordion title="Which Claude Code version do AdAdvisor Skills require?">
    Claude Code 2.1.0 or later. Run `claude --version` to check, `claude update` to upgrade. Earlier versions do not support the `github` plugin source type.
  </Accordion>

  <Accordion title="What does `/plugin install adadvisor@adadvisor` mean?">
    The format is `<plugin-name>@<marketplace-name>`. Both are `adadvisor` because the AdAdvisor marketplace contains a single plugin also called `adadvisor`. You can think of it as "install the adadvisor plugin from the adadvisor marketplace".
  </Accordion>

  <Accordion title="How much context do AdAdvisor Skills consume?">
    About 1,900 tokens always-on per session (the description block for skill routing). When any single skill fires, it adds 2,000 to 3,000 tokens for its body content. Reference files load on demand from inside the skill, paid only when the agent reads them.
  </Accordion>

  <Accordion title="Can I install AdAdvisor Skills in just one project?">
    Yes. Use `claude plugin install adadvisor@adadvisor --scope project` from the project directory. The plugin reference goes into `<project>/.claude/settings.json` rather than your user settings, so it only applies to that project.
  </Accordion>

  <Accordion title="How do AdAdvisor Skills update?">
    Run `/plugin marketplace update adadvisor` then `/plugin update adadvisor`. The marketplace tracks the `main` branch of the AdAdvisor/skills GitHub repository, so update pulls whatever is current. No version-pinning required.
  </Accordion>
</AccordionGroup>

## Source code

[github.com/AdAdvisor/skills](https://github.com/AdAdvisor/skills) under Apache 2.0. Fork it, tweak the thresholds, point your own marketplace at your fork.

<Columns cols={2}>
  <Card title="Other clients" icon="cloud" href="/skills/install-claude">
    Using Claude.ai or Claude Desktop? Install via ZIP upload instead.
  </Card>

  <Card title="Skill reference" icon="book" href="/skills/welcome">
    See what each of the eight skills does in detail.
  </Card>
</Columns>