Struct SkillPlugin 

pub struct SkillPlugin { /* private fields */ }

A skill-only plugin that injects custom skills into the session’s skill registry without registering any tools.

This is the primary way to add custom LLM guidance from Python or Node.js without writing Rust. Provide skill YAML/markdown content strings and they will appear in the system prompt automatically.

Example

let plugin = SkillPlugin::new("my-plugin")
    .with_skill(r#"---
name: my-skill
description: Use bash when running shell commands
allowed-tools: "bash(*)"
kind: instruction
---
Always explain what command you're about to run before executing it."#);

let opts = SessionOptions::new().with_plugin(plugin);

Implementations

impl SkillPlugin

pub fn new(name: impl Into<String>) -> Self

pub fn with_skill(self, content: impl Into<String>) -> Self

pub fn with_skills( self, contents: impl IntoIterator<Item = impl Into<String>>, ) -> Self

Trait Implementations

impl Plugin for SkillPlugin

fn name(&self) -> &str

Unique plugin identifier (kebab-case, e.g. "agentic-search").

fn version(&self) -> &str

Plugin version string (semver, e.g. "1.0.0").

fn tool_names(&self) -> &[&str]

Names of all tools this plugin registers.

fn load( &self, _registry: &Arc<ToolRegistry>, _ctx: &PluginContext, ) -> Result<()>

Register this plugin’s tools into registry.

fn skills(&self) -> Vec<Arc<Skill>>

Skills bundled with this plugin.

fn unload(&self, registry: &Arc<ToolRegistry>)

Remove this plugin’s tools from registry.

fn description(&self) -> &str

Human-readable description shown in plugin listings.