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
sim skills list [options]Options
API request and response schemas: listSkills.
Get skill
sim skills get <skillId>Arguments
| Argument | Required | Description |
|---|---|---|
skillId | Yes | Unique 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.
sim skills create [options]Options
| Option | Required | Description |
|---|---|---|
--name <value> | Yes | Kebab-case name, unique within the workspace and not reserved by a built-in skill. |
--description <value> | Yes | One-line summary of when the skill applies. |
--content <value> | Yes | Skill body containing the instructions given to the agent. |
API request and response schemas: createSkill.
Update skill
OAuth login or personal API key required.
sim skills update <skillId> [options]Arguments
| Argument | Required | Description |
|---|---|---|
skillId | Yes | Unique skill identifier. A built-in skill is builtin- followed by its name, for example builtin-research. |
Options
| Option | Required | Description |
|---|---|---|
--name <value> | No | New kebab-case skill name. |
--description <value> | No | New one-line summary of when the skill applies. |
--content <value> | No | Replacement skill body. |
API request and response schemas: updateSkill.
Editors
List skill editors
sim skills editors list <skillId> [options]Arguments
| Argument | Required | Description |
|---|---|---|
skillId | Yes | Unique skill identifier. A built-in skill is builtin- followed by its name, for example builtin-research. |
Options
| Option | Required | Description |
|---|---|---|
--sort-by <value> | No | Field 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> | No | Sort direction. Defaults to "asc". Accepted values: asc, desc. |
--limit <n> | No | Maximum 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.
sim skills editors create <skillId> [options]Arguments
| Argument | Required | Description |
|---|---|---|
skillId | Yes | Unique skill identifier. A built-in skill is builtin- followed by its name, for example builtin-research. |
Options
| Option | Required | Description |
|---|---|---|
--email <value> | Yes | Email 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.
sim skills editors delete <skillId> [options]Arguments
| Argument | Required | Description |
|---|---|---|
skillId | Yes | Unique skill identifier. A built-in skill is builtin- followed by its name, for example builtin-research. |
Options
| Option | Required | Description |
|---|---|---|
--email <value> | Yes | Email address of a current workspace member. |
-y, --yes | Yes | Confirm this operation. |
API request and response schemas: revokeSkillEditor.
Delete skills
Delete skill
OAuth login or personal API key required.
This deletes the skill.
sim skills delete <skillId> [options]Arguments
| Argument | Required | Description |
|---|---|---|
skillId | Yes | Unique skill identifier. A built-in skill is builtin- followed by its name, for example builtin-research. |
Options
API request and response schemas: deleteSkill.