Skills

A skill is a reusable procedure stored as SKILL.md, optionally with scripts and reference files. Attach skills to an agent instead of putting every procedure in its system prompt: the agent sees each skill’s short description on every turn and loads the full instructions only when a skill fits the task. The TypeScript samples assume the rl client from Client setup.

Before you begin

You need the organization developer or admin role to create, change, or delete skills and skill groups. The organization user role can view them. See Organizations and roles.
For the API, create a key on API keys and export it as RECURSION_API_KEY.

How an agent uses a skill

When a session starts, it resolves the agent’s skills and skill groups and fixes the version of each skill for the whole session.
Every turn lists each skill’s name and, while the budget allows, its description. See Preview prompt disclosure.
When a skill fits, the agent calls activate_skill with the skill’s name. The full instructions and the list of bundled files enter the conversation and stay in effect for the rest of the session.
Bundled files are placed under /workspace/.managed-agents/skills in the sandbox. The agent reads or runs a file only when the instructions point it there.

activate_skill is offered only when the session has at least one usable skill.

Write SKILL.md

SKILL.md starts with YAML frontmatter on the first line, followed by Markdown instructions.

---
name: release-notes
description: Use when drafting customer-facing notes from merged pull requests.
---

# Draft release notes

1. Read every merged pull request in the requested range.
2. Group the changes by product area.
3. Write one plain sentence for each change.
4. Save the result with write_artifact as release-notes.md.

Frontmatter key	Rule
`name`	Required. Lowercase letters, digits, and single hyphens, at most 64 characters. The agent activates the skill by this name.
`description`	Required. At most 1,024 characters. Write it as a condition for using the skill, because it is what the model routes on.
`license`, `compatibility`, `metadata`, `allowed-tools`	Optional. Stored with the version. `compatibility` is at most 500 characters, and the agent sees it when it activates the skill. `allowed-tools` isn’t enforced.

Any other key has no effect. The whole SKILL.md can be at most 256 KiB, and it must have instructions below the frontmatter. When a session loads a skill, instructions longer than 64,000 bytes are cut off, and the agent is told they were cut off.

Create a skill

Creating a skill also creates version 1. Versions are immutable.

Console
TypeScript
cURL

In the sidebar, click Skills.
Click Create skill.
Enter the document in SKILL.md, and optionally a Display title and a Group.
Click Create skill.

const skill = await rl.managedAgents.createSkill({
  body: {
    display_title: 'Release notes',
    document:
      '---\nname: release-notes\ndescription: Use when drafting customer-facing notes from merged pull requests.\n---\n\n# Draft release notes\n\nRead the merged pull requests, group them by product area, and write one sentence for each change.',
  },
});
console.log(skill.skill_id, skill.latest_skill_version_id);

curl -X POST 'https://api.recursion.labelbox.com/managed-agents/v1/skills' \
  -H "Authorization: Bearer $RECURSION_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "display_title": "Release notes",
    "document": "---\nname: release-notes\ndescription: Use when drafting customer-facing notes from merged pull requests.\n---\n\n# Draft release notes\n\nRead the merged pull requests, group them by product area, and write one sentence for each change."
  }'

Field	Description
`document`	Required. The complete `SKILL.md`, frontmatter included.
`display_title`	Title shown in the catalog, at most 256 characters. Defaults to the frontmatter `name`.
`skill_group_id`	The group to file the skill under. Omit it to leave the skill ungrouped.
`metadata`	Your own JSON object. The API returns it unchanged.

Skill names are unique in your organization. A name that another live skill already uses returns 409 conflict on name. A 200 response is the catalog entry. Keep skill_id to attach the skill and latest_skill_version_id to publish the next version. Some fields are left out here.

{
  "skill_id": "4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64",
  "latest_skill_version_id": "8b1f5d73-2c94-467a-a0e6-4d9c7b3f1e52",
  "latest_version_number": 1,
  "latest_instruction_chars": 104,
  "name": "release-notes",
  "display_title": "Release notes",
  "description": "Use when drafting customer-facing notes from merged pull requests.",
  "organization_id": "cl9x2k4f1000008l5h3g7a2bq",
  "created_at": "2026-09-17T09:30:11Z",
  "updated_at": "2026-09-17T09:30:11Z"
}

Upload a bundle

A bundle is a zip archive of the skill’s directory. Put SKILL.md at the root of the archive, or inside one wrapper directory. Put runnable helpers in scripts/, supporting documents in references/, and other files in assets/. Files under scripts/ are made executable in the sandbox; all other files are not. If you use a wrapper directory, its name must match the skill’s name, and every file must be inside it. Symbolic links and other non-regular files are refused.

Console
cURL

In Skills, click Create skill.
Drop the zip on Upload a bundle, or pick it.
Click Review and upload, check the file list, then click Create skill in the Upload bundle dialog.

curl -X POST 'https://api.recursion.labelbox.com/managed-agents/v1/skills' \
  -H "Authorization: Bearer $RECURSION_API_KEY" \
  -F 'bundle=@release-notes.zip' \
  -F 'display_title=Release notes'

The multipart form also accepts skill_group_id, and metadata as a JSON string. The document, name, and description come from the SKILL.md inside the archive. The TypeScript SDK sends the JSON form only, so use the console or a multipart HTTP request for bundles.

Bundle limit	Value
Compressed archive	8 MiB
Unpacked contents	32 MiB
One file	4 MiB
Files	500
Directory depth below the skill root	3

Get a skill

Console
TypeScript
cURL

In the sidebar, click Skills.
Click the skill to open its latest version.

const skill = await rl.managedAgents.getSkill({
  skill_id: '4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64',
});

curl 'https://api.recursion.labelbox.com/managed-agents/v1/skills/4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64' \
  -H "Authorization: Bearer $RECURSION_API_KEY"

The response has the same shape as the create response. It does not include the instructions; get a version for those.

List skills

The list is newest first, leaves out deleted skills, and omits instructions. Follow next_page_token to read the whole catalog.

Query parameter	Description
`search`	2 to 256 characters. Matches part of the name, title, or description, ignoring case, or a complete skill id.
`skill_group_id`	Only skills in this group. An unknown group returns `404 not_found`.
`ungrouped`	`true` for only skills in no group. Cannot be combined with `skill_group_id`.
`limit`	Page size. Defaults to 100, at most 500.
`page_token`	The `next_page_token` from the previous page. Send the same filters and `limit` with it.

Console
TypeScript
cURL

In the sidebar, click Skills.
Search by name, description, or id, or expand a group in the catalog.

const page = await rl.managedAgents.listSkills({ search: 'release', limit: 100 });
console.log(page.skills, page.next_page_token);

curl 'https://api.recursion.labelbox.com/managed-agents/v1/skills?search=release&limit=100' \
  -H "Authorization: Bearer $RECURSION_API_KEY"

{
  "skills": [
    {
      "skill_id": "4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64",
      "latest_skill_version_id": "8b1f5d73-2c94-467a-a0e6-4d9c7b3f1e52",
      "name": "release-notes",
      "description": "Use when drafting customer-facing notes from merged pull requests."
    }
  ]
}

next_page_token is absent on the last page.

Publish a new version

Get the skill first, then send its current latest_skill_version_id as base_skill_version_id. The request is a full replacement: a display_title you leave out resets to the frontmatter name, and metadata you leave out is cleared. You cannot change the group here; use Move a skill to a group.

Console
TypeScript
cURL

In Skills, open the skill.
Edit SKILL.md, or drop a new zip on Upload a bundle.
Click Save new version. For a bundle, confirm in the Upload bundle dialog.

const skill = await rl.managedAgents.getSkill({
  skill_id: '4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64',
});
const version = await rl.managedAgents.createSkillVersion({
  skill_id: '4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64',
  body: {
    base_skill_version_id: skill.latest_skill_version_id,
    display_title: 'Release notes',
    document:
      '---\nname: release-notes\ndescription: Use when drafting customer-facing notes from merged pull requests.\n---\n\n# Draft release notes\n\nCheck that every pull request is merged before writing the notes.',
  },
});

curl -X POST 'https://api.recursion.labelbox.com/managed-agents/v1/skills/4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64/versions' \
  -H "Authorization: Bearer $RECURSION_API_KEY" \
  -F 'base_skill_version_id=8b1f5d73-2c94-467a-a0e6-4d9c7b3f1e52' \
  -F 'bundle=@release-notes.zip' \
  -F 'display_title=Release notes'

A 201 response is the new version. If another writer published first, the API returns 409 revision_conflict and saves nothing. Get the skill again, apply your change, and retry.

{
  "skill_id": "4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64",
  "skill_version_id": "13d8a6f4-5b27-49e1-8c30-7a2f9d6b4e85",
  "version_number": 2,
  "name": "release-notes",
  "description": "Use when drafting customer-facing notes from merged pull requests.",
  "created_at": "2026-09-18T14:02:37Z"
}

Agents that follow the latest version pick up version 2 in their next session. Sessions already running keep the version they started with.

List and get versions

listSkillVersions returns every version, newest first, without pages and without instructions. getSkillVersion returns one version with its instructions.

Console
TypeScript
cURL

In Skills, open the skill.
Use Compare with under Changes to see what changed between versions.

const { skill_versions } = await rl.managedAgents.listSkillVersions({
  skill_id: '4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64',
});
const version = await rl.managedAgents.getSkillVersion({
  skill_id: '4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64',
  skill_version_id: '13d8a6f4-5b27-49e1-8c30-7a2f9d6b4e85',
});

curl 'https://api.recursion.labelbox.com/managed-agents/v1/skills/4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64/versions/13d8a6f4-5b27-49e1-8c30-7a2f9d6b4e85' \
  -H "Authorization: Bearer $RECURSION_API_KEY"

A version with bundled files lists them in bundle.entries. mode is 493 (octal 0755) for files under scripts/ and 420 (octal 0644) for everything else. Every version has a bundle, and bundle.entries always includes SKILL.md. A skill created from a document alone has a bundle that holds only SKILL.md. Some fields are left out of this sample.

{
  "skill_id": "4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64",
  "skill_version_id": "13d8a6f4-5b27-49e1-8c30-7a2f9d6b4e85",
  "version_number": 2,
  "name": "release-notes",
  "description": "Use when drafting customer-facing notes from merged pull requests.",
  "instructions": "# Draft release notes\n\nCheck that every pull request is merged before writing the notes. Run scripts/collect.sh to list them.",
  "entrypoint_path": "SKILL.md",
  "file_manifest": ["scripts/collect.sh", "references/style.md"],
  "bundle": {
    "bytes": 1843,
    "entries": [
      { "path": "SKILL.md", "bytes": 214, "mode": 420 },
      { "path": "references/style.md", "bytes": 2210, "mode": 420 },
      { "path": "scripts/collect.sh", "bytes": 512, "mode": 493 }
    ]
  },
  "created_at": "2026-09-18T14:02:37Z"
}

Download a version’s files

getSkillVersionContent returns the version’s files as a gzipped tarball, exactly as a session receives them: SKILL.md plus any bundled files. The TypeScript SDK has no method for this call.

curl 'https://api.recursion.labelbox.com/managed-agents/v1/skills/4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64/versions/13d8a6f4-5b27-49e1-8c30-7a2f9d6b4e85/content' \
  -H "Authorization: Bearer $RECURSION_API_KEY" \
  -o release-notes-v2.tar.gz

Organize skills in groups

A skill group is a folder in the catalog and a way to attach a whole set of skills to an agent in one entry. The model never sees the group. Filing a skill in a group never creates a skill version.

Create a group

Console
TypeScript
cURL

In the sidebar, click Skills.
Click New group.
Fill in Name, and optionally Display title and Description.
Click Save group.

const group = await rl.managedAgents.createSkillGroup({
  body: {
    name: 'release-workflows',
    display_title: 'Release workflows',
    description: 'Procedures used while preparing a release.',
  },
});

curl -X POST 'https://api.recursion.labelbox.com/managed-agents/v1/skill-groups' \
  -H "Authorization: Bearer $RECURSION_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "release-workflows",
    "display_title": "Release workflows",
    "description": "Procedures used while preparing a release."
  }'

name is required, follows the same rule as a skill name, and must be unique among your organization’s groups; a taken name returns 409 conflict on name. display_title is at most 256 characters and defaults to name. description is for people browsing the catalog, at most 1,024 characters. A 201 response is the group.

{
  "skill_group_id": "6c2e9a47-1f83-45d0-b7a6-3e8c5f2d9a14",
  "organization_id": "cl9x2k4f1000008l5h3g7a2bq",
  "name": "release-workflows",
  "display_title": "Release workflows",
  "description": "Procedures used while preparing a release.",
  "skill_count": 0,
  "created_at": "2026-09-17T09:41:52Z",
  "updated_at": "2026-09-17T09:41:52Z"
}

List, get, and update groups

listSkillGroups returns skill_groups newest first, with limit (default 100, at most 500) and page_token. getSkillGroup returns one group. updateSkillGroup changes only the fields you send, so renaming a group is safe: agents attach it by id.

Console
TypeScript
cURL

In Skills, open the group’s menu in the catalog.
Click Edit group, change the fields, and click Save group.

const { skill_groups } = await rl.managedAgents.listSkillGroups({ limit: 100 });
await rl.managedAgents.updateSkillGroup({
  skill_group_id: '6c2e9a47-1f83-45d0-b7a6-3e8c5f2d9a14',
  body: { display_title: 'Release procedures' },
});

curl -X PATCH 'https://api.recursion.labelbox.com/managed-agents/v1/skill-groups/6c2e9a47-1f83-45d0-b7a6-3e8c5f2d9a14' \
  -H "Authorization: Bearer $RECURSION_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"display_title":"Release procedures"}'

Move a skill to a group

updateSkill files a skill under a group. Send an empty skill_group_id to take the skill out of its group. The skill’s versions don’t change.

Console
TypeScript
cURL

In Skills, open the skill.
In the header, pick a group in Group, or Ungrouped. The change saves at once.

await rl.managedAgents.updateSkill({
  skill_id: '4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64',
  body: { skill_group_id: '6c2e9a47-1f83-45d0-b7a6-3e8c5f2d9a14' },
});

curl -X PATCH 'https://api.recursion.labelbox.com/managed-agents/v1/skills/4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64' \
  -H "Authorization: Bearer $RECURSION_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"skill_group_id":"6c2e9a47-1f83-45d0-b7a6-3e8c5f2d9a14"}'

List the skills in a group

listSkillsInGroup returns the group’s skills in the order a group attachment expands them. That order decides whose description is dropped first when the disclosure budget runs out. It takes limit and page_token like listSkills.

Console
TypeScript
cURL

In Skills, expand the group in the catalog.

const page = await rl.managedAgents.listSkillsInGroup({
  skill_group_id: '6c2e9a47-1f83-45d0-b7a6-3e8c5f2d9a14',
});

curl 'https://api.recursion.labelbox.com/managed-agents/v1/skill-groups/6c2e9a47-1f83-45d0-b7a6-3e8c5f2d9a14/skills' \
  -H "Authorization: Bearer $RECURSION_API_KEY"

The response has the same shape as List skills.

Delete a group

Console
TypeScript
cURL

In Skills, open the group’s menu in the catalog.
Click Archive group, then confirm.

await rl.managedAgents.deleteSkillGroup({
  skill_group_id: '6c2e9a47-1f83-45d0-b7a6-3e8c5f2d9a14',
});

curl -X DELETE 'https://api.recursion.labelbox.com/managed-agents/v1/skill-groups/6c2e9a47-1f83-45d0-b7a6-3e8c5f2d9a14' \
  -H "Authorization: Bearer $RECURSION_API_KEY"

A delete returns { "deleted": true }. The group’s skills stay in the catalog. Agents that attach the group keep the entry, and their next session runs without the group’s skills.

Attach skills to an agent

Skills are part of an agent version, in the skills field. Each entry is one of these:

Entry	What the session gets
`{ "skill_id": "..." }`	The skill’s latest version when the session starts.
`{ "skill_id": "...", "version": "<skill_version_id>" }`	That exact version, every time. `"latest"` also works and means the same as leaving `version` out.
`{ "type": "group", "skill_group_id": "..." }`	The group’s current skills when the session starts. A skill added to the group later reaches the agent without an agent update.

An agent can have at most 100 entries. The API checks every id when you save the version; an unknown skill, version, or group returns 400 invalid_request naming the entry, such as skills[0].skill_id. Entry order matters, because descriptions past the disclosure budget are dropped from the end.

Console
TypeScript
cURL

Open the agent and stay on the Configuration tab.
In Skills, pick a skill or group in Attach a skill or group. Reorder the cards so the most important skills come first.
Click Save new version.

The console attaches the latest version. To pin a version, use the API.

const agent = await rl.managedAgents.getAgent({
  agent_id: '5f0c2a1e-8b7d-4c3a-9e21-6d4f0b9a7c55',
});
await rl.managedAgents.createAgentVersion({
  agent_id: '5f0c2a1e-8b7d-4c3a-9e21-6d4f0b9a7c55',
  body: {
    base_agent_version_id: agent.latest_agent_version_id,
    name: agent.name,
    model: agent.model,
    system: agent.system,
    disabled_integration_mcp_providers: ['github'],
    skills: [
      { skill_id: '4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64' },
      { type: 'group', skill_group_id: '6c2e9a47-1f83-45d0-b7a6-3e8c5f2d9a14' },
    ],
  },
});

curl -X POST 'https://api.recursion.labelbox.com/managed-agents/v1/agents/5f0c2a1e-8b7d-4c3a-9e21-6d4f0b9a7c55/versions' \
  -H "Authorization: Bearer $RECURSION_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "base_agent_version_id": "c1a94e07-2f6b-4d18-b3a5-0e7d8c6f4a21",
    "name": "Release notes writer",
    "model": "anthropic/claude-sonnet-5",
    "system": "Follow the attached procedures.",
    "disabled_integration_mcp_providers": ["github"],
    "skills": [
      {"skill_id": "4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64"},
      {"type": "group", "skill_group_id": "6c2e9a47-1f83-45d0-b7a6-3e8c5f2d9a14"}
    ]
  }'

A 201 response is the agent at its new version. A version is a full replacement, so resend every other setting you want to keep. See Update an agent.

{
  "agent_id": "5f0c2a1e-8b7d-4c3a-9e21-6d4f0b9a7c55",
  "latest_agent_version_id": "7a4e1c95-6d2f-4380-b915-3e7a0c6f2d84",
  "skills": [
    { "skill_id": "4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64" },
    { "type": "group", "skill_group_id": "6c2e9a47-1f83-45d0-b7a6-3e8c5f2d9a14" }
  ]
}

Preview prompt disclosure

Every turn lists the session’s skills within a character budget. When the descriptions don’t fit, the ones at the end of the list are dropped and the model sees only those skills’ names, which makes it less likely to pick them. The preview resolves groups exactly as a session start does and reports what fits.

Console
TypeScript
cURL

Open the agent and stay on the Configuration tab.
In Skills, attach the skills or groups you plan to use.
Read the budget meter. Cards past the line marked “Past this line the model sees only skill names.” are flagged Name only.

const preview = await rl.managedAgents.previewSkillDisclosure({
  body: {
    skills: [
      { skill_id: '4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64' },
      { type: 'group', skill_group_id: '6c2e9a47-1f83-45d0-b7a6-3e8c5f2d9a14' },
    ],
  },
});
console.log(preview.used_chars, preview.budget_chars);

curl -X POST 'https://api.recursion.labelbox.com/managed-agents/v1/skills/disclosure-preview' \
  -H "Authorization: Bearer $RECURSION_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"skills":[{"skill_id":"4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64"},{"type":"group","skill_group_id":"6c2e9a47-1f83-45d0-b7a6-3e8c5f2d9a14"}]}'

{
  "budget_chars": 8000,
  "used_chars": 291,
  "entries": [
    { "name": "release-notes", "description_included": true },
    { "name": "release-checklist", "description_included": true }
  ],
  "warnings": []
}

Here the group holds one skill, release-checklist, so the response lists it after release-notes. An entry with description_included: false can still be activated, but the model sees only its name. Move important skills earlier, or shorten descriptions, until they fit. warnings also names entries that could not be resolved, such as a deleted skill or group. context_window_tokens is optional; omit it to use a conservative default of 8,000 characters, which is also what the console’s meter uses.

Delete a skill

A delete is a soft delete. The skill leaves the catalog and stops resolving into new sessions, and its versions can no longer be read through the API. A session that already started keeps the version it loaded. Agents that reference the skill keep the entry, and their next session runs without it. A deleted skill cannot be restored.

Console
TypeScript
cURL

In Skills, open the skill.
At the bottom of the page, click Archive skill, then confirm Archive skill.

await rl.managedAgents.deleteSkill({
  skill_id: '4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64',
});

curl -X DELETE 'https://api.recursion.labelbox.com/managed-agents/v1/skills/4e7a2c91-6d35-4f80-b8a1-9c3e5d7f2a64' \
  -H "Authorization: Bearer $RECURSION_API_KEY"

{ "deleted": true }

What can go wrong

Symptom or code	Cause	Fix
The agent never activates a skill	Its description was dropped by the disclosure budget, or doesn’t say when to use the skill.	Run Preview prompt disclosure, move the skill earlier, and write the description as a condition.
A session runs without a skill the agent attaches	The skill or group was deleted after the agent attached it. Preview prompt disclosure names it in `warnings`.	Remove the entry in a new agent version, or attach a replacement.
A new skill version doesn’t reach a running session	Sessions fix skill versions when they start.	Start a new session. Pinned entries never move; update `version` to change them.
`400 invalid_request` on `document` or `bundle`	The frontmatter is missing, `name` or `description` is missing or malformed, there are no instructions below the frontmatter, the bundle has no `SKILL.md` at the root or one directory down, the wrapper directory’s name doesn’t match `name`, or the document or bundle is over a limit.	Fix the frontmatter or the archive layout, and check the limits.
`400 invalid_request` on a list filter	`skill_group_id` and `ungrouped` are combined, `search` is shorter than 2 characters, or `page_token` was sent with different filters.	Send one filter, and reuse the same filters with a page token.
`400 invalid_request` on `skills` or `skills[n]`	An agent has more than 100 entries, or an entry names a skill, version, or group that doesn’t exist, is deleted, or belongs to another organization.	Use groups to shorten the list, and check the ids in the named entry.
`404 not_found`	A skill, version, or group doesn’t exist, is deleted, or belongs to another organization.	Check the id.
`409 conflict` on `name`	Another skill or group already uses the name.	Pick another name, or publish a new version of the existing skill.
`409 revision_conflict`	`base_skill_version_id` is no longer the latest version.	Get the skill again, apply your change, and retry.
`413 payload_too_large`	The whole request is larger than the upload limit.	Shrink the bundle to fit the limits.
`429 rate_limit_exceeded`	Your organization is over its request rate.	Wait for the time in `Retry-After`, then retry.

The full error catalog is on Errors.

Limits

Limit	Value
Skill and group `name`	64 characters
`description` in frontmatter	1,024 characters
`compatibility` in frontmatter	500 characters
`SKILL.md`	256 KiB
Instructions a session loads	64,000 bytes, then cut off
Skill and group `display_title`	256 characters
Group `description`	1,024 characters
Bundle	8 MiB compressed, 32 MiB unpacked, 4 MiB per file, 500 files, depth 3
Skill entries on one agent	100
`listSkills`, `listSkillGroups`, and `listSkillsInGroup` page size	500, default 100
`search`	2 to 256 characters

See Limits for request sizes and rates.

Next steps

Agents

Publish an agent version with skills and groups attached.

Tools

See what else the agent can call once a skill is active.

Sessions

Start a session and watch the agent activate a skill.

Artifacts

Collect the files a skill tells the agent to produce.

Get started

Account and access

Build agents

Coordinate multiple agents

Configure environments

Run and observe sessions

Manage agent context

Automate

Tutorials

Before you begin

How an agent uses a skill

Write SKILL.md

Create a skill

Upload a bundle

Get a skill

List skills

Publish a new version

List and get versions

Download a version’s files

Organize skills in groups

Create a group

List, get, and update groups

Move a skill to a group

List the skills in a group

Delete a group

Attach skills to an agent

Preview prompt disclosure

Delete a skill

What can go wrong

Limits

Next steps

Agents

Tools

Sessions

Artifacts

​Before you begin

​How an agent uses a skill

​Write SKILL.md

​Create a skill

​Upload a bundle

​Get a skill

​List skills

​Publish a new version

​List and get versions

​Download a version’s files

​Organize skills in groups

​Create a group

​List, get, and update groups

​Move a skill to a group

​List the skills in a group

​Delete a group

​Attach skills to an agent

​Preview prompt disclosure

​Delete a skill

​What can go wrong

​Limits

​Next steps

Agents

Tools

Sessions

Artifacts

Before you begin

How an agent uses a skill

Write SKILL.md

Create a skill

Upload a bundle

Get a skill

List skills

Publish a new version

List and get versions

Download a version’s files

Organize skills in groups

Create a group

List, get, and update groups

Move a skill to a group

List the skills in a group

Delete a group

Attach skills to an agent

Preview prompt disclosure

Delete a skill

What can go wrong

Limits

Next steps