Skills

Import a Catalog Skill

Imports a Catalog Skill into your organization. The import makes a Skill from the name, the description and the body of the Catalog Skill, and sets source. Your organization owns the Skill, and can edit it like any other Skill. Send {} to keep the slug of the Catalog Skill. Your organization holds at most one import of each Catalog Skill: a second import answers 409 with error=already_imported. If a Skill of your organization holds the slug, the answer is 409 with error=slug_conflict: send another slug.

post/context/skill-catalog/{catalogSlug}/import

Request

  • Base URL: https://api.adcrunch.dev
  • URL: https://api.adcrunch.dev/context/skill-catalog/{catalogSlug}/import
  • Auth: HTTP bearer

Path parameters

catalogSlugstring required

The slug of the Catalog Skill to import.

Request body

slugstring

Optional slug for the new Skill, normalized to kebab-case. It defaults to the slug of the Catalog Skill. Send one when a Skill of your organization holds that slug.

Example request

{
  "slug": "monday-review"
}

Response

The Skill as the import made it, at revision 1, with its source.

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. Call `list_campaigns` for each advertiser.\n2. Call `query_insights` for the last seven days.\n3. Write down the campaigns that missed their target.",
  "createdAt": 1790000000000,
  "createdBy": "usr_4d8b12",
  "description": "Use it every Monday to review the spend and the results of last week.",
  "id": "skl_7c1f90",
  "name": "Weekly performance review",
  "revision": 1,
  "slug": "weekly-performance-review",
  "source": {
    "slug": "weekly-performance-review",
    "version": "2026-10-09"
  },
  "updatedAt": null
}

Changes

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