Skip to content

DefineSkillConfig

optional allowedTools?: string[];

Restricts this skill to a subset of the agent’s tools. Unknown names fail at wiring time.


description: string;

When the model should reach for this skill. Disclosed up front, so keep it specific. ≤1024 chars.


instructions: string;

The skill body — Level 2, loaded only when the model calls load_skill.


name: string;

Lowercase, hyphen-separated, ≤64 chars — the Agent Skills naming rule.


optional resources?: Record<string, string | Uint8Array<ArrayBufferLike>>;

Level 3: fetched individually via read_skill_resource, never loaded up front.