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.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.
Skills are available on Claude Pro, Max, Team, and Enterprise plans. They require the AdAdvisor MCP server to be connected. Set up MCP first.

​
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.
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.
SkillDownloadWhat it does
Foundation (details)adadvisor.zipRequired. Account discovery, business context, unit economics, KPI decoding.
Audit (details)adadvisor-audit.zipFull Meta ad account audit. Pixel, structure, performance, red flags.
Diagnose (details)adadvisor-diagnose.zipPerformance diagnosis with kill, hold, and scale decision rules.
Launch (details)adadvisor-launch.zipEnd-to-end Facebook ads campaign launch.
Scale (details)adadvisor-scale.zipScale proven winners using the 20% rule, bid-cap method, target-ROAS portfolio.
Creative (details)adadvisor-creative.zipCreative testing frameworks and refresh cadence.
Targeting (details)adadvisor-targeting.zipAudience strategy. Broad-first, lookalikes, exclusions.
Playbooks (details)adadvisor-playbooks.zipBFCM, product launch, lead-gen, recovery, scale plan.

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

The full flow takes about 30 seconds. Walkthrough:
Step by step:
1

Open Settings

Click your avatar in the bottom-left, then choose Settings.
2

Open Capabilities

Select Capabilities from the sidebar.
3

Open Skills

Click the Skills tab.
4

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

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

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.
Want all eight skills in one shot? Use 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.

​
How do I install a skill in Claude Desktop?

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

Open Claude Desktop

Launch the app and sign in if needed.
2

Open Settings

Click Customize (or Settings in newer builds) in the sidebar, then Capabilities, then Skills.
3

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

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.

​
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:
1

Remove the old skill

In Settings, Capabilities, Skills, find the skill and click Remove.
2

Download the new ZIP

Re-download from the table above. The links always point to the latest version.
3

Upload the new ZIP

Same upload flow as the initial install.
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.

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

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.
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 with /plugin install adadvisor@adadvisor.
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.
Yes. Skills are available on Claude Pro, Max, Team, and Enterprise plans. The free tier does not currently support custom skill uploads.
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.
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.

​
Source code

Every skill is open source under Apache 2.0. The full repository is at github.com/AdAdvisor/skills. Fork it, tweak the thresholds for your business, repackage as ZIPs, and upload your customized version.
Last modified on May 13, 2026