skill_wrapper: Wrap a Skill Directory as MCP Tool Generators

In shidashi: A Shiny Dashboard Template Modular System with Chat Bot Support

Wrap a Skill Directory as ⁠MCP⁠ Tool Generators

Description

Creates a closure that produces two ellmer::tool objects for a skill:

skill_load__<name>

Reads the skill. Its action argument is readme (the full ⁠SKILL.md⁠ instructions, the default) or reference (content from a reference file in the skill directory). It never changes anything.

skill_run__<name>

Executes a script in the scripts/ subdirectory via processx::run(). Only created when the skill has scripts.

Usage

skill_wrapper(skill_path)

Arguments

skill_path

Path to the skill directory containing SKILL.md. Can be absolute or relative to the project root.

Details

The two tools share a soft gate: reading a reference or running a script before the readme is allowed, but if the call errors the message is augmented with a condensed summary (~200 tokens) instructing the AI to read the full instructions first. This minimizes token waste (the summary is only sent on failure).

The gate state is per-instance: each call to the wrapper produces a pair of tools with an independent readme_unlocked flag.

Scripts inherit the app's environment variables, plus the ones the caller passes in envs. When an agent runs a script over ⁠MCP⁠, SHIDASHI_USING_MCP is "TRUE"; see mcp_call_active.

Value

A function with class c("shidashi_skill_wrapper", "function") that returns a list with elements load (an ellmer::ToolDef) and run (an ellmer::ToolDef, or NULL when the skill has no scripts).

Examples

skill_dir <- system.file(
  "builtin-templates/bslib-bare/agents/skills/greet",
  package = "shidashi"
)
wrapper <- skill_wrapper(skill_dir)
tools <- wrapper()
cat(tools$load(action = "readme"))

shidashi documentation built on Nov. 11, 2026, 1:06 a.m.