invoke

Open a skill and get everything needed to act on it in one call.

The returned markdown carries the skill's instructions, the assets and guides it depends on — each marked present or missing in this world — the toolboxes and tool names it runs through with their live signatures, and the subskills available underneath it.

Address a top-level skill by name ("scenes"), a subskill through its parent ("scenes/player-setup"), or by full asset identity when two skills share a name. An address that matches nothing comes back with the available names, so a wrong guess returns the right spelling.

Behavior

Resolves the address, takes the structured record from asset.inspect on the skill ref, and renders it. The asset produces the record and the tool renders it — the same split assets.describe uses. Reads only; nothing is mutated.

Returns

Markdown.

Examples

tools.use("skills", "invoke", "scenes")
tools.use("skills", "invoke", "scenes/player-setup")