> ## 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.ai and Claude Desktop

> Upload AdAdvisor Skills to Claude.ai (web) or Claude Desktop in a few clicks. One ZIP per skill, added through Settings, Capabilities, Skills.

Claude.ai (web) and Claude Desktop both accept Skills as ZIP uploads through the Settings menu. This is the easiest way to install AdAdvisor Skills if you are not using Claude Code.

<Note>
  Skills are available on Claude Pro, Max, Team, and Enterprise plans. They require the [AdAdvisor MCP server](/ai/setting-up-your-mcp-client) to be connected. Set up MCP first.
</Note>

## Download the AdAdvisor Skills

Claude.ai and Claude Desktop accept **one skill per ZIP**. Each upload must contain a single `SKILL.md` inside one top-level folder. Install whichever skills match how you actually work, one at a time. The **foundation** skill (`adadvisor`) is required and should be installed first. Every other skill assumes it has loaded.

<Note>
  If you have seen the upload error *"Zip must contain exactly one SKILL.md file"*, that is the validation rule above. Download an individual skill ZIP from the table below, not a multi-skill bundle.
</Note>

| Skill                                                  | Download                                                                                                        | What it does                                                                    |
| ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| **Foundation** ([details](/skills/adadvisor))          | [adadvisor.zip](https://github.com/AdAdvisor/skills/releases/latest/download/adadvisor.zip)                     | Required. Account discovery, business context, unit economics, KPI decoding.    |
| **Audit** ([details](/skills/adadvisor-audit))         | [adadvisor-audit.zip](https://github.com/AdAdvisor/skills/releases/latest/download/adadvisor-audit.zip)         | Full Meta ad account audit. Pixel, structure, performance, red flags.           |
| **Diagnose** ([details](/skills/adadvisor-diagnose))   | [adadvisor-diagnose.zip](https://github.com/AdAdvisor/skills/releases/latest/download/adadvisor-diagnose.zip)   | Performance diagnosis with kill, hold, and scale decision rules.                |
| **Launch** ([details](/skills/adadvisor-launch))       | [adadvisor-launch.zip](https://github.com/AdAdvisor/skills/releases/latest/download/adadvisor-launch.zip)       | End-to-end Facebook ads campaign launch.                                        |
| **Scale** ([details](/skills/adadvisor-scale))         | [adadvisor-scale.zip](https://github.com/AdAdvisor/skills/releases/latest/download/adadvisor-scale.zip)         | Scale proven winners using the 20% rule, bid-cap method, target-ROAS portfolio. |
| **Creative** ([details](/skills/adadvisor-creative))   | [adadvisor-creative.zip](https://github.com/AdAdvisor/skills/releases/latest/download/adadvisor-creative.zip)   | Creative testing frameworks and refresh cadence.                                |
| **Targeting** ([details](/skills/adadvisor-targeting)) | [adadvisor-targeting.zip](https://github.com/AdAdvisor/skills/releases/latest/download/adadvisor-targeting.zip) | Audience strategy. Broad-first, lookalikes, exclusions.                         |
| **Playbooks** ([details](/skills/adadvisor-playbooks)) | [adadvisor-playbooks.zip](https://github.com/AdAdvisor/skills/releases/latest/download/adadvisor-playbooks.zip) | BFCM, product launch, lead-gen, recovery, scale plan.                           |

## How do I install a skill in Claude.ai?

The full flow takes about 30 seconds. Walkthrough:

<Frame caption="Installing an AdAdvisor skill in Claude.ai: Settings, Capabilities, Skills, Upload skill, drag the ZIP.">
  <video controls playsInline muted className="w-full aspect-video rounded-xl" poster="/images/screenshots/claude-skills/install-claude-skill-walkthrough-poster.jpg">
    <source src="https://mintcdn.com/adadvisor/JnOp542Hz6pw7R-R/images/screenshots/claude-skills/install-claude-skill-walkthrough.mp4?fit=max&auto=format&n=JnOp542Hz6pw7R-R&q=85&s=b6b57f9513069639241157cfc1828a1d" type="video/mp4" data-path="images/screenshots/claude-skills/install-claude-skill-walkthrough.mp4" />

    Your browser does not support the video tag. <a href="/images/screenshots/claude-skills/install-claude-skill-walkthrough.mp4">Download the walkthrough</a> instead.
  </video>
</Frame>

Step by step:

<Steps>
  <Step title="Open Settings">
    Click your avatar in the bottom-left, then choose **Settings**.
  </Step>

  <Step title="Open Capabilities">
    Select **Capabilities** from the sidebar.
  </Step>

  <Step title="Open Skills">
    Click the **Skills** tab.
  </Step>

  <Step title="Upload the foundation first">
    Click **Upload skill** and drag in `adadvisor.zip`. Claude.ai unpacks the ZIP, validates that the top-level folder contains exactly one SKILL.md, and registers the skill.
  </Step>

  <Step title="Repeat for each additional skill">
    One ZIP at a time. The Settings panel shows your installed skills, so you can verify each one appears before uploading the next.
  </Step>

  <Step title="Verify">
    Open a new chat and try a trigger phrase like *"audit my AdAdvisor account"*. You should see Claude reference the skill in its reply and start calling MCP tools.
  </Step>
</Steps>

<Tip>
  Want all eight skills in one shot? Use [Claude Code](/skills/install-claude-code). The `/plugin install adadvisor@adadvisor` command installs the entire plugin in one step. Claude.ai's per-skill upload validator does not accept multi-skill bundles.
</Tip>

## How do I install a skill in Claude Desktop?

The flow is the same as the web app. Settings, Capabilities, Skills, Upload.

<Steps>
  <Step title="Open Claude Desktop">
    Launch the app and sign in if needed.
  </Step>

  <Step title="Open Settings">
    Click **Customize** (or **Settings** in newer builds) in the sidebar, then **Capabilities**, then **Skills**.
  </Step>

  <Step title="Upload the ZIPs">
    Click **Upload skill** and drag in `adadvisor.zip` first, then each additional skill ZIP one at a time. Claude Desktop applies the same one-skill-per-upload rule as Claude.ai.
  </Step>

  <Step title="Reload (if prompted)">
    Some Claude Desktop builds need a restart for new skills to register. If your trigger phrases do not fire, quit and reopen the app.
  </Step>
</Steps>

## How do skills trigger after install?

You do not have to do anything special to invoke them. Just type naturally:

```
You: "Can you audit my Meta ad account? CPAs feel like they have been climbing."

Claude: I'll run the audit. Loading the AdAdvisor audit and diagnose skills.

[Claude calls adadvisor:list_ad_accounts, reads your business context,
runs the audit workflow, returns a structured report.]
```

The trigger phrases for each skill are listed on its individual page (linked in the table above). They cover natural language, not just exact strings. *"Review my account"*, *"check my ads"*, *"what's wrong with this account"* all route to the audit skill.

## How do I update a skill?

When AdAdvisor publishes a new skill version, the procedure is:

<Steps>
  <Step title="Remove the old skill">
    In Settings, Capabilities, Skills, find the skill and click **Remove**.
  </Step>

  <Step title="Download the new ZIP">
    Re-download from the table above. The links always point to the latest version.
  </Step>

  <Step title="Upload the new ZIP">
    Same upload flow as the initial install.
  </Step>
</Steps>

<Tip>
  If you are using Claude Code instead of Claude.ai or Desktop, install via the plugin marketplace. Updates are automatic. See [Install in Claude Code](/skills/install-claude-code).
</Tip>

## Troubleshooting

### Why doesn't the skill trigger?

* Your phrasing might not match any of the skill's `Use when` triggers. Check the individual skill page for the exact phrases.
* Try invoking explicitly by saying *"use the adadvisor-audit skill to..."*. Claude can load a skill by name even if your prompt is ambiguous.
* Verify the skill is enabled in Settings, Capabilities, Skills. Some plans require manual enabling per skill.

### Why does the skill trigger but tools fail?

* The MCP server is not connected. Confirm the AdAdvisor connector is set up under Settings, Capabilities, Connectors (Claude.ai) or under your client's MCP settings. See [Setting Up Your MCP Client](/ai/setting-up-your-mcp-client).
* Your Meta access token may have expired. Reconnect through the AdAdvisor app under Settings, Connected Accounts.

### Why does the upload say "Skill format invalid"?

* Make sure you uploaded the ZIP without re-zipping. The downloads above are pre-built and ready.
* If your browser auto-extracted the ZIP, re-download and right-click "Save link as" instead.

### Why does the upload say "Zip must contain exactly one SKILL.md file"?

You uploaded a multi-skill bundle. Claude.ai requires one skill per ZIP. Download an individual skill ZIP from the table at the top of this page instead.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="How do I install AdAdvisor Skills in Claude.ai?">
    Download an individual skill ZIP from the table on this page (start with `adadvisor.zip`, the foundation). Open Claude.ai, go to Settings, Capabilities, Skills, click **Upload skill**, drag the ZIP in. Claude.ai validates the file (one SKILL.md per ZIP) and registers the skill. Repeat for each additional skill you want.
  </Accordion>

  <Accordion title="Can I install multiple AdAdvisor Skills at once?">
    Not in Claude.ai or Claude Desktop. Their upload validator accepts one skill per ZIP. To install all eight in a single step, use [Claude Code](/skills/install-claude-code) with `/plugin install adadvisor@adadvisor`.
  </Accordion>

  <Accordion title="Which AdAdvisor Skill should I install first?">
    The foundation skill (`adadvisor.zip`). Every other skill assumes its account discovery, business context, and KPI decoding logic has loaded. After the foundation, install the skills that match how you actually work. Auditing accounts means `adadvisor-audit`. Launching campaigns means `adadvisor-launch`. Diagnosing performance dips means `adadvisor-diagnose`.
  </Accordion>

  <Accordion title="Do AdAdvisor Skills work in Claude Pro?">
    Yes. Skills are available on Claude Pro, Max, Team, and Enterprise plans. The free tier does not currently support custom skill uploads.
  </Accordion>

  <Accordion title="Do I need to connect the AdAdvisor MCP server first?">
    Yes. The skills are workflows that call MCP tools. Without the MCP connector configured, the skill will load but cannot read your Meta (Facebook) ad data. See [Setting Up Your MCP Client](/ai/setting-up-your-mcp-client).
  </Accordion>

  <Accordion title="How do I update an installed AdAdvisor Skill?">
    In Claude.ai or Desktop, remove the old version through Settings, Capabilities, Skills, then re-download the latest ZIP from this page and re-upload it. The download links always point to the current release.
  </Accordion>
</AccordionGroup>

## Source code

Every skill is open source under Apache 2.0. The full repository is at [github.com/AdAdvisor/skills](https://github.com/AdAdvisor/skills). Fork it, tweak the thresholds for your business, repackage as ZIPs, and upload your customized version.