Skip to content
AdCrunch
Esc
↑↓navigate↵open⌘Jpreview
On this page

Skills

Ad-ops playbooks your connected AI agents can run via the AdCrunch MCP server. Write them in the console, or import them from the Skill Catalog.

A Skill is an ad-ops playbook — a set of instructions that teaches an MCP-connected agent how to run a workflow using AdCrunch’s own tools (for example: “pull the last 14 days of Meta campaigns, then flag anything over target CPA”). You write a Skill once; every teammate’s connected agent can run it consistently, with no copy-paste.

Skills are private to your organization. New organizations start with an empty Skills store. AdCrunch also writes playbooks of its own, in the Skill Catalog. You can import one into your organization as a Skill.

Manage Skills in the console

Open Skills in the console sidebar. The Skills page has two tabs:

  • Your Skills lists the Skills of your organization.
  • Skill Catalog lists the playbooks that AdCrunch writes.

On the Skills page, you can:

  • Create a Skill with New skill. It opens the Adgent beside the list, and sends it “I want to create a new Skill.” The Adgent asks you what the playbook does, and when an agent must use it. It then writes the Skill at once, and the page of the new Skill opens on the left of the screen.
  • Create a Skill with the form: Cmd-click New skill (Ctrl-click on Windows and Linux). The form asks for a name, a description (what an agent reads to decide when to use it), and the body (the markdown instructions). Optionally set a custom slug.
  • Import a Skill from the Skill Catalog. See Import a Catalog Skill.
  • Edit a Skill on its own page — change the name, description, or body, copy its handle, rename its slug, or delete it.

The slug is the agent handle

Every Skill has a slug — its stable, per-organization handle. Agents fetch a Skill by slug (skill_get with skill_name: "weekly-meta-audit"). The slug is derived from the name when you create the Skill and shown with a copy button in the editor.

The Skill Catalog

The Skill Catalog holds the playbooks that AdCrunch writes. Each playbook in it is a Catalog Skill. The Skill Catalog tab of the Skills page lists the current Catalog Skills.

A Catalog Skill is not a Skill of your organization, and an agent cannot read it. An agent reads only the Skill that you import from it.

Each Catalog Skill shows its name, its description, and its version. The version is a date, for example 2026-10-09. A later date is a later version. The version is not the revision of a Skill: the revision counts the edits of one Skill of your organization.

A Catalog Skill gives an agent no new access. Each tool that the playbook names checks its own scope. For example, a Catalog Skill that pauses ads can pause an ad only when the agent has the mutation:write scope.

Import a Catalog Skill

  1. On the Skill Catalog tab, click Import on the Catalog Skill. The dialog Import name opens.
  2. The dialog shows the slug of the Catalog Skill. Keep it, or type another slug.
  3. Click Import.

AdCrunch makes a Skill in your organization from the name, the description, and the body of the Catalog Skill. The page of the new Skill opens. On the Skill Catalog tab, the Catalog Skill now shows Imported as slug, a link to your Skill.

The import is a copy. Your organization owns it, and an agent can use it at once, as any other Skill.

Your organization holds at most one import of each Catalog Skill. When your organization has an import of it, the Skill Catalog tab shows Imported as slug in place of Import. To import the Catalog Skill again, delete that Skill first.

Each member who can write Skills can import a Catalog Skill and re-import it.

If the slug is taken

A slug is unique in your organization. If a Skill of your organization has the slug already, the import makes no Skill. The dialog shows “A Skill of your organization has the slug slug. Give another slug.” Type another slug, and click Import again.

The new Skill has a different slug, and it still records the Catalog Skill as its source.

Edit an imported Skill

Edit an imported Skill on its page, as you edit any other Skill. You can change its name, its description, its body, and its slug, or delete it.

The page of an imported Skill shows its Source: the slug of the Catalog Skill, and the version that you imported. An edit keeps the source.

Re-import a later version

AdCrunch can publish a later version of a Catalog Skill. Your Skill does not change when it does. A later version gets to your organization only when you re-import it.

When the Skill Catalog has a later version, the Source of your Skill shows Re-import version. To re-import:

  1. Click Re-import version. A dialog tells you what the re-import replaces.
  2. Click Re-import.

The re-import replaces the name, the description, and the body of your Skill with the later version. The slug stays the same, so each agent finds the Skill with the same handle. The source then shows the later version.

If somebody saved the Skill after you opened it, the re-import makes no change. The console reloads the Skill. Read it, then re-import again.

No longer in the Skill Catalog

AdCrunch can remove a Catalog Skill from the Skill Catalog. Each Skill that your organization imported from it stays as it is, and it keeps its source. Agents can use it as before.

The Source of such a Skill shows No longer in the Skill Catalog, and the console offers no re-import.

Agents can edit Skills too

A connected agent with the skill:write scope can create, edit, and delete Skills over MCP, also in the middle of a conversation. It cannot import a Catalog Skill or re-import a Skill: no MCP tool does that. To keep a human edit and an agent edit from clobbering each other, every save is guarded by a revision: if the Skill changed since you opened it, the console shows a “reloaded the latest” notice instead of overwriting.

Was this page helpful?