audit
Installation
SKILL.md
Purpose
Evaluate MCP server tool definitions against design quality criteria drawn from two upstream authorities, cited (not recapped) so the current text always governs:
- MCP specification 2025-11-25 — Tools — the normative protocol (MUST / SHOULD / OPTIONAL requirements for names, schemas, annotations).
- Anthropic — Writing effective tools for AI agents — engineering guidance for descriptions, parameters, namespacing, and workflow-shaped granularity.
Produces a per-tool scorecard with actionable findings. Catches description gaps, missing annotations, and naming issues before they degrade LLM tool selection accuracy.
Server discovery configuration
Phase 1 enumerates MCP servers and their tool source files by scanning the project for the per-language
tool markers. The tool-marker, name-extraction, and description-extraction rules are upstream
MCP-SDK conventions, stable across repos. See reference/server-discovery.md
for the per-language discovery rules and how servers are grouped.