A plug-and-play skill system for AI agents. Exposes USB catalog tools over JSON-RPC 2.0 compatible with the Model Context Protocol. Allows discovery, auditing, and installation of AI agent skills.
USB MCP server exposes 4 read-only tools with clear verb-noun naming (usb_search, usb_get_skill, usb_audit_skill, usb_render_install). All tools have descriptions (194 - 250 chars, within baseline 34 - 392 range) and complete JSON Schema input definitions with typed parameters. However, output schemas are not documented, LLMs cannot predict response structure for downstream chaining. Parameter descriptions are present but minimal (10 - 30 chars); several lack format/constraint guidance. No error handling guidance visible. No tool annotations (readOnlyHint, etc.). Composition is sound: each tool has one responsibility, and naming clearly distinguishes them. Security is adequate for read-only operations.
Dry-run audit for a single skill: shows what files would be created, which shell commands would run, and any risk warnings — without actually installing.
Fetch the full record of a single skill by its slug — including the full prompt template, inputs, outputs and examples.
Render a portable bash installer for a subset of the catalog. Filter by slug, domain, category, preset, or core.
Search the USB catalog by free-text. Matches against skill slug, name, category and description.
Output schemas not documented. LLMs cannot predict response structure (fields, types, pagination) for downstream tool chaining or data extraction.
Parameter descriptions are minimal (10 - 30 chars). 'target' param lacks format guidance (valid values: leosis, claude, hermes, cursor, openai, anthropic, langchain, mcp, openrouter, groq, mistral, ollama, lm-studio, vllm, auto, generic). Should be enum or explicitly listed.
No error handling guidance. Tools do not document what happens on invalid slug, missing skill, or unsupported target. LLMs cannot self-correct or retry intelligently.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 65 | 2026-07-28+ | v2 |
usb_render_install has 7 optional parameters with complex interdependencies (slug, domain, category, preset, core, exclude). No documentation of mutual exclusivity or precedence rules. LLMs may pass conflicting combinations.
No tool annotations (readOnlyHint, idempotentHint). MCP spec 2026-07-28 supports tool annotations to signal safety properties. All 4 tools are read-only and idempotent, should be annotated.