MCP server that exposes Claude-style skills to any MCP client using progressive disclosure pattern
Three tools with clear naming (load_skill, read_skill_file, list_skill_files) and reasonable descriptions (100-150 chars each). All tools have input schemas with type definitions and parameter descriptions. However, output schemas are not documented in the source code, the tool implementations return unstructured responses without explicit schema declarations. Parameter descriptions are minimal (10-30 chars) and lack detail on expected formats, constraints, or error conditions. No error handling guidance visible. Tools follow a single responsibility pattern (read-only operations on skill resources), but lack pagination, result limits, and recovery hints.
List files available in a skill's directory. Use this to discover what reference files, scripts, or resources a skill provides. Optionally specify a subdirectory like 'references' or 'scripts'.
Load the complete instructions for a skill. Use this when you've decided a skill is relevant based on the skill metadata in your system prompt. Returns the full SKILL.md content without frontmatter.
Read a specific file from a skill's directory. Use this when skill instructions reference a file (e.g., 'See references/api_reference.md'). Provide the skill name and relative file path.
Output schemas not documented. Tool implementations return unstructured responses (Markdown text, file lists, directory contents) without explicit schema declarations. LLMs cannot plan downstream operations or extract structured data reliably.
Parameter descriptions are too brief (10-30 chars). 'The name of the skill' and 'Relative file path within the skill directory' lack actionable detail on format, constraints, or examples. Rubric baseline: param descriptions should average 72 chars.
No error handling guidance. Tools do not document what happens when a skill is not found, a file path is invalid, or a subdirectory does not exist. LLMs receive no recovery hints.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 65 | <=2025-11-25 | v2 |
No pagination or result limits documented. list_skill_files could return hundreds of files without limit or cursor support. Large responses waste tokens and risk context window exhaustion.
Tool descriptions do not explain when to use each tool or dependencies between them. E.g., 'Use load_skill after list_skill_files to get full instructions' would guide agent planning.