capabilities

Routes tasks to Paseo plugins, pi extensions, and shared skills using a generated capability map.

Updated Nov 25, 2024
One-click install
npx skills add https://github.com/cbrostrom/dotfiles --skill capabilities-cbrostrom
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: capabilities
Source: https://github.com/cbrostrom/dotfiles/tree/main/stow/agents/.agents/skills/capabilities
Command: npx skills add https://github.com/cbrostrom/dotfiles --skill capabilities-cbrostrom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working in an environment with many custom tools (Paseo plugins, pi extensions, shared skills), it is hard to know which tool handles a given task or whether one exists at all. This Skill reads the generated capability map and routes each task to the right tool, with a staleness check to avoid trusting outdated entries. ## Core Features & Use Cases - Capability Map Routing: Reads ~/.agents/capabilities.md and matches the task to Paseo plugins, pi extensions, or shared skills with invocation details. - Staleness Safety Net: Verifies the manifest's listed paths exist before trusting any entry, and reruns gen-capabilities.py to regenerate the map when entries are stale. - Structured Route Output: Produces a concise route listing one to three matching tools with trigger, location, and invocation method. - Use Case: You wonder whether there is a tool for saving step plans. The Skill checks the map, finds the paseo-steps-viewer MCP tools (save_steps, update_steps, list_steps), and tells you exactly how to invoke them. ## Quick Start Ask the agent to check the capability map and tell you which tool handles saving step plans.

Frequently Asked Questions about capabilities

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find which tool handles a task in my agent environment?▼

Read the generated capability map at ~/.agents/capabilities.md, which lists Paseo plugins, pi extensions, and shared skills with their triggers. Match your task against the entries and invoke the tool as documented.

How do I invoke a shared skill from the capability map?▼

Shared skills listed in the map are invoked with the /skill:<name> command. The map entry shows the skill name and its trigger conditions so you can pick the right one.

What MCP tools does the paseo-steps-viewer plugin expose?▼

The paseo-steps-viewer plugin exposes three MCP tools: save_steps, update_steps, and list_steps. Most other Paseo plugins are UI-only and require no agent action.

What should I do when a capability map entry points to a missing file?▼

Rerun the generator script at ~/dotfiles/scripts/gen-capabilities.py to rebuild the map, then re-read it and route again. Never route to an entry you could not verify; flag it to the user instead.

Can I edit the capabilities.md map by hand?▼

No. The capability map is a build artifact generated by gen-capabilities.py and must never be edited manually. Fix the source configuration and regenerate the map instead.