Skills

Create a Skill

Creates a Skill in your organization. The body is the playbook itself, and the description is what an agent reads to choose it. AdCrunch makes the slug from the name. To set a different slug, send one. The answer is 409 if the slug already exists in your organization.

post/context/skills

Request

  • Base URL: https://api.adcrunch.dev
  • URL: https://api.adcrunch.dev/context/skills
  • Auth: HTTP bearer

Request body

bodystring required

The playbook instructions (markdown).

descriptionstring required

When to use this Skill — what agents read to discover it.

namestring required

Display name.

slugstring

Optional explicit slug handle; normalized to kebab-case. Defaults to one derived from the name.

Example request

{
  "body": "## When to run\n\nEvery Monday, before the week starts.\n\n## Steps\n\n1. Read the last seven days of spend for each live campaign.\n2. Move budget to the campaigns under the target cost per action.\n3. Write down what you changed, and why.",
  "description": "Use this every Monday to move budget towards the campaigns that reach the target cost per action.",
  "name": "Weekly budget review",
  "slug": "weekly-budget-review"
}

Response

The Skill as created, at revision 1. Send that revision back as base_revision on your first edit.

bodystring required

The agent instructions themselves — the SKILL.md-equivalent, in markdown.

createdAtnumber required

Milliseconds since the Unix epoch, UTC.

createdBystring required
descriptionstring required
idstring required
namestring required
revisionnumber required

Increments on every write. Send it back as base_revision to edit; a stale one answers 409.

slugstring required
updatedAtnumber nullable required

Milliseconds since the Unix epoch, UTC.

Example response

{
  "body": "## When to run\n\nEvery Monday, before the week starts.\n\n## Steps\n\n1. Read the last seven days of spend for each live campaign.\n2. Move budget to the campaigns under the target cost per action.\n3. Write down what you changed, and why.",
  "createdAt": 1790000000000,
  "createdBy": "usr_4d8b12",
  "description": "Use this every Monday to move budget towards the campaigns that reach the target cost per action.",
  "id": "skl_2d7e14",
  "name": "Weekly budget review",
  "revision": 1,
  "slug": "weekly-budget-review",
  "source": null,
  "updatedAt": null
}

Changes

No recorded changes to this operation across all 1 revision of this API.