Module skills 

Skills: named instruction bundles — the SKILL.md idiom — discovered from MCP servers as prompts (prompts/list = catalogue, prompts/get = body) or resources (skill://<name> URIs or mimeType: text/x-skill+markdown), referenced as @skill:<name> in the instruction, a step, or a chat message, and preloaded into the calling context (progressive disclosure: the catalogue is always visible, a body only when referenced or skills.loaded). Bodies are cached by hash, never stored; the loaded set [{name, hash}] is part of the context record.

Structs

Catalogue

The catalogue + body cache.

SkillBody

A loaded skill body (cached by hash).

SkillMeta

A catalogue entry (no body).

SkillSourceRef

Where a skill comes from.

Enums

Discover

How to discover on one source (skills.sources[].discover).

SkillSourceKind

Constants

DEFAULT_PREFIX

The default reference prefix (skills.reference_prefix).

SKILL_MIME

The mime type that marks a resource as a skill.

SKILL_SCHEME

The URI scheme skills-as-resources use.

Traits

SkillServer

The MCP surface skill discovery needs — implemented for the MCP client and by test fakes.

Functions

find_references

@skill:<name> references in text — a name is [A-Za-z0-9_.:-]+ (trailing punctuation stripped), deduplicated in order of appearance.

prompt_messages_text

A prompts/get result’s text: the concatenated text parts of its messages.

render_bodies

Render the loaded skill bodies as one system block.