Wrap a skill

skill_write links the canvas to a skill. kidCallable + ageRange are required. The skill is the trackable, deliverable unit.

The call

After canvas_create returns a canvasId, wrap it:

skill_write({
name: "Evening reflection",
description: "Three questions about the day. Mood scored.",
instructions: "Present the reflection form. Score the mood. ...",
canvasIds: ["757c5bb0-..."],
kidCallable: true,
ageRange: "6-12",
dryRun: false
})
# Returns: { skillId: "019e378f-...", nextStep: "skill_activate" }

Required fields

• name: human-readable name the parent sees.
• canvasIds: array of canvas IDs this skill uses. Can be empty for chat-only skills.
• kidCallable: whether the kid app can launch this skill. Usually true.
• ageRange: e.g. "6-12", "8-9", "5-7". Used for difficulty branching and catalog filtering.

Optional fields

• description: shown to the parent in skill listings.
• instructions: the skill body prompt. Runs on your agent when the skill is invoked.
• completionSchema: JSON schema for structured completion data.
• hands_referenced: tools the skill intends to use (documentation today, enforcement later).

Further reading

• Activate & deliver
• The skill lifecycle
• Author a canvas