A skill is a runbook: a name, a unique slug, a one-line description of when it applies, and the markdown body. A run only ever sees the slug and description (one load_skill tool carries them), and reads the whole body only when it calls the tool, so a long runbook costs nothing until needed. Skills are the third extension kind beside MCP servers and custom tools, on the same botExtensionsSql path, so per-bot, per-workspace and all-bots grants work the same way, and attachDefaultExtensions hands an every-bot skill to new bots. load_skill is a reserved tool name, so a custom tool cannot shadow it, and a built-in wins a clash. Managed on Settings > Skills; ExtensionRow links each kind to its own page and a skill never reports a failure, since nothing connects or runs.
17 lines
487 B
TypeScript
17 lines
487 B
TypeScript
/**
|
|
* What a skill is: a runbook a bot follows. It reads the name and
|
|
* description in its prompt and pulls the body with `load_skill` only when
|
|
* the skill applies, so a long runbook costs nothing until it's needed.
|
|
*/
|
|
export const SkillNoun = "skill";
|
|
|
|
/**
|
|
* The tool a bot calls to read a skill's body.
|
|
*/
|
|
export const LoadSkillToolName = "load_skill";
|
|
|
|
/**
|
|
* The slug format, for the settings form and its hint.
|
|
*/
|
|
export const SkillSlugPattern = /^[a-z0-9]+(-[a-z0-9]+)*$/;
|