Skip to main content

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.

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

​
Prerequisites

  1. An AdAdvisor account with at least one Meta ad account connected. Sign up here if you have not already.
  2. The AdAdvisor MCP server connected in Claude Code. See 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?

1

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)
2

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)
3

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
4

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.

​
How do I install via the CLI?

If you prefer the terminal over the interactive /plugin command: 
# 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 folderSlash commandAuto-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: 
claude plugin marketplace update adadvisor
claude plugin update adadvisor
The marketplace points at the main branch of the GitHub repository, 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: 
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.

​
Frequently asked questions

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

​
Source code

github.com/AdAdvisor/skills under Apache 2.0. Fork it, tweak the thresholds, point your own marketplace at your fork.

Other clients

Using Claude.ai or Claude Desktop? Install via ZIP upload instead.

Skill reference

See what each of the eight skills does in detail.
Last modified on May 13, 2026