skill_get
Fetch one ad-ops playbook (Skill) by slug, including its full instructions and current revision.
Fetches a single Skill by its slug, returning the full instruction
body plus the current revision. Discover slugs first with
skill_list.
Input
| Field | Type | Required | Description |
|---|---|---|---|
skill_name | string | yes | The Skill slug (its per-organization handle). |
Output
{ slug, name, description, body, revision }. The body is the playbook the
agent follows; revision is the optimistic-concurrency token.
Example
“Load my weekly-meta-audit playbook and run it.”
skill_get({ skill_name: 'weekly-meta-audit' });
// → { slug: 'weekly-meta-audit', name: '…', body: '# Playbook\n…', revision: 3 }The agent reads the body as its instructions, then calls whatever AdCrunch
tools the playbook names (list_campaigns, query_insights, …).
Keep the revision
If you intend to edit the Skill, hold onto revision — pass it as
base_revision to skill_update or
skill_delete so a concurrent change can’t be
silently clobbered.
Errors
- Returns an error result when no Skill with that slug exists in your organization.
401 Unauthorized— the OAuth token has expired.403 insufficient_scope— the token lacks theskill:readscope.