Sample demonstrating Skills Over MCP pattern (SEP-2640). Serves workflow skills as MCP Resources using skill:// URI scheme with HTTP Streaming Transport.
Server declares 2 tools with basic schemas and descriptions. Both tools have input schemas with type definitions and parameter descriptions, meeting minimum requirements. However, descriptions are terse (under 100 chars), output schemas are not documented, and error handling guidance is absent. Tool naming follows verb_noun convention (create_branch, run_tests), which is good. Parameters lack constraints (enums, ranges, defaults). No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite create_branch being a WRITE operation. Resources feature is well-implemented with skill:// URIs and proper metadata, but tools themselves lack production-grade polish.
Create a new Git branch from the current HEAD. Referenced by the git-workflow skill.
Run the project test suite and return a pass/fail summary. Referenced by the git-workflow and deploy-service skills.
Missing tool annotations for destructive operations. create_branch modifies Git state but lacks destructiveHint annotation to signal irreversibility to agents.
No output schemas documented. Tools return results but LLMs cannot infer response structure. create_branch and run_tests lack documented return types.
Parameter constraints missing. branch_name accepts any string; suite parameter lacks enum constraint (unit|integration|all). Free-form strings invite hallucinated values.
Descriptions are terse (under 100 chars). 'Create a new Git branch from the current HEAD' lacks context on when to use this vs alternatives, prerequisites, or side effects.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 59 | 2026-07-28+ | v2 |
No error handling guidance. Tools do not document failure modes (branch already exists, tests fail, no test suite found) or recovery steps for agents.