Crate sim_lib_skill 

Agent skills for the SIM runtime.

A skill is a callable capability that an agent can invoke – a tool, a model, a resource, a prompt, a memory, a retriever, a judge, or a router. Each skill is described by a SkillCard that pairs a stable identity and symbol with input and output sim_shape contracts, a SkillPolicy governing caching/recording/privacy, and the transport that actually runs the call. Cards are bound into a SkillRegistry and exposed as ordinary callable runtime objects through SkillCallable.

Behavior is provided by a SkillTransport: a backend (fixture, HTTP, MCP, process, OpenAI-compatible server, …) that knows how to discover and call skills. SkillLib registers the skill/* operations (install, bind, list, card, call, and the feature-gated audit/tool/runner/serve surfaces) when the library is loaded into a sim_kernel::Cx.

Optional Cargo features select transports and integrations: mcp, http, openai, process, agent, runner, serve, and the cache/cassette recording surfaces.

Structs

FixtureSkillSpec

Inputs for building a fixture SkillCard via SkillCard::fixture.

FixtureTransport

In-memory skill transport for tests and examples.

SkillCallable

Callable runtime object that invokes a single bound skill.

SkillCard

Full runtime description of a single skill.

SkillCardDescriptor

Serializable skill/Card projection of a SkillCard.

SkillFunction

Callable runtime object implementing one skill/* operation.

SkillLib

Loadable library that registers the skill/* operations and registry.

SkillPolicy

Privacy, caching, and recording policy attached to a SkillCard.

SkillRegistry

Live registry of skill transports and bound cards.

SkillTransportValue

Runtime Object wrapper around a shared SkillTransport.

Enums

FixtureBehavior

Deterministic behavior a FixtureTransport runs for an operation.

SkillCacheMode

Caching behavior for a skill’s results.

SkillCassetteMode

Cassette (record/replay) behavior for a skill’s calls.

SkillPrivacyPolicy

How much of a skill’s raw payload may leave the local boundary.

SkillRole

Role a skill plays for an agent.

Constants

SKILL_LIB_ID

Stable identifier for the skill library and its symbol namespace.

Statics

RECIPES

Cookbook recipes for this lib, embedded at build time.

Traits

SkillEventSink

Sink that receives streaming events emitted during a skill call.

SkillTransport

Backend that discovers and runs skills.

Functions

install_fixture_skill

Installs the skill library, registers transport, and binds card.

install_skill_lib

Installs the skill library into cx once and publishes its browse metadata.

manifest_name

Returns the manifest identifier symbol for SkillLib.

skill_bind_symbol

Returns the symbol for the skill/bind operation.

skill_call_capability

Returns the broad capability required to call any skill.

skill_call_symbol

Returns the symbol for the skill/call operation.

skill_card_descriptor_class_symbol

Returns the class symbol (skill/Card) for SkillCardDescriptor.

skill_card_symbol

Returns the symbol for the skill/card operation.

skill_exports

Returns the library exports: every skill/* function plus the registry value, with the feature-gated operations included when their feature is on.

skill_install_capability

Returns the capability required to call skill/install.

skill_install_symbol

Returns the symbol for the skill/install operation.

skill_list_symbol

Returns the symbol for the skill/list operation.

skill_registry

Resolves the SkillRegistry installed in cx.

skill_registry_symbol

Returns the symbol the SkillRegistry value is bound under.

skill_serve_capability

Returns the capability required to serve skills over a transport.

skill_specific_call_capability

Returns the per-skill call capability for the skill with the given id.

skill_transport_value

Wraps transport in an opaque SkillTransportValue runtime value.