Skip to content
Try for free
On this page

Commands

Skills

Create reusable agent instructions and manage their editors.

sim skills is also spelled sim skill.

These commands accept the global options.

Skill instructions

List skills

Code
sim skills list [options]

Options

OptionRequiredDescription
--search <value>NoCase-insensitive substring match against the skill name.
--sort-by <value>NoField used to sort the result. Do not rely on case-insensitive ordering when sorting by name. Defaults to "createdAt". Accepted values: name, createdAt, updatedAt.
--sort-order <value>NoSort direction. Defaults to "desc". Accepted values: asc, desc.
--limit <n>NoMaximum items to return (0 for everything). Defaults to 0.

API request and response schemas: listSkills.

Get skill

Code
sim skills get <skillId>

Arguments

ArgumentRequiredDescription
skillIdYesUnique skill identifier. A built-in skill is builtin- followed by its name, for example builtin-research.

API request and response schemas: getSkill.

Create skill

OAuth login or personal API key required.

Code
sim skills create [options]

Options

OptionRequiredDescription
--name <value>YesKebab-case name, unique within the workspace and not reserved by a built-in skill.
--description <value>YesOne-line summary of when the skill applies.
--content <value>YesSkill body containing the instructions given to the agent.

API request and response schemas: createSkill.

Update skill

OAuth login or personal API key required.

Code
sim skills update <skillId> [options]

Arguments

ArgumentRequiredDescription
skillIdYesUnique skill identifier. A built-in skill is builtin- followed by its name, for example builtin-research.

Options

OptionRequiredDescription
--name <value>NoNew kebab-case skill name.
--description <value>NoNew one-line summary of when the skill applies.
--content <value>NoReplacement skill body.

API request and response schemas: updateSkill.

Editors

List skill editors

Code
sim skills editors list <skillId> [options]

Arguments

ArgumentRequiredDescription
skillIdYesUnique skill identifier. A built-in skill is builtin- followed by its name, for example builtin-research.

Options

OptionRequiredDescription
--sort-by <value>NoField used to sort the result. Do not rely on case-insensitive ordering when sorting by name. Defaults to "email". Accepted values: email, name.
--sort-order <value>NoSort direction. Defaults to "asc". Accepted values: asc, desc.
--limit <n>NoMaximum items to return (0 for everything). Defaults to 0.

API request and response schemas: listSkillEditors.

Grant skill editor

OAuth login or personal API key required.

Code
sim skills editors create <skillId> [options]

Arguments

ArgumentRequiredDescription
skillIdYesUnique skill identifier. A built-in skill is builtin- followed by its name, for example builtin-research.

Options

OptionRequiredDescription
--email <value>YesEmail address of a current workspace member.

API request and response schemas: grantSkillEditor.

Revoke skill editor

OAuth login or personal API key required.

This revokes the explicit skill editor grant for the selected email.

Code
sim skills editors delete <skillId> [options]

Arguments

ArgumentRequiredDescription
skillIdYesUnique skill identifier. A built-in skill is builtin- followed by its name, for example builtin-research.

Options

OptionRequiredDescription
--email <value>YesEmail address of a current workspace member.
-y, --yesYesConfirm this operation.

API request and response schemas: revokeSkillEditor.

Delete skills

Delete skill

OAuth login or personal API key required.

This deletes the skill.

Code
sim skills delete <skillId> [options]

Arguments

ArgumentRequiredDescription
skillIdYesUnique skill identifier. A built-in skill is builtin- followed by its name, for example builtin-research.

Options

OptionRequiredDescription
-y, --yesYesConfirm this operation.

API request and response schemas: deleteSkill.

Related docs

Was this helpful?
Suggest an edit