Agent skill and MCP management system with Flutter UI and Go backend
22 tools with basic schemas and descriptions, but significant quality gaps. All tools have names starting with action verbs (List, Get, Create, Delete, Toggle, Export, Search, Install, Test) and descriptions present. However, descriptions are minimal (10-50 chars), parameter descriptions lack depth, and output schemas are entirely undocumented. No error handling guidance, no pagination info for list tools, no idempotency hints for write operations. Parameter schemas exist but lack constraints (enums, ranges, formats). No tool annotations (readOnlyHint, destructiveHint). Composition is reasonable (22 focused tools), but parameter naming inconsistencies (e.g., 'id' for agent ID vs 'skillId' for skill ID) and missing chaining IDs in responses force extra lookups.
Get available agent templates
Create a new agent
Create a new MCP for an agent
Create a new skill for an agent
Delete an agent by ID
Delete an MCP from an agent
Delete a skill from an agent
Export a skill from one agent to another agent (includes file copying)
Get a specific agent by ID
Output schemas completely undocumented. No tool returns a documented response structure. LLMs cannot plan downstream calls or extract required fields (e.g., agent_id after CreateAgent). Violates pattern:tool and pattern:response-shaper.
Descriptions are minimal (10-50 chars) and lack context. E.g., 'List all agents' does not explain when to call it, what structure it returns, or whether results are paginated. Baseline is 194 chars; these are 5-10x too short. Violates pattern:tool-description.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 49 | 2026-07-28+ | v2 |
Get README content for a marketplace repository
Get a specific marketplace repository
Get a specific MCP by ID
Get a specific skill by ID
Install a marketplace repository as a skill
List all agents
List marketplace repositories by category
List all MCPs for an agent
List all skills for an agent
Scan for agents in the system
Search marketplace repositories
Test an MCP connection
Toggle skill enabled/disabled status
No pagination info for list tools (ListAgents, ListSkills, ListMcps, ListMarketRepos). No limit, offset, or cursor parameters visible. Large result sets will blow context window. Violates pattern:paginated-result.
Destructive tools (DeleteAgent, DeleteSkill, DeleteMcp) lack confirmation/dry-run support and no error recovery guidance. No indication of whether operation is idempotent or retryable. Violates pattern:confirmation-request and pattern:error-classification.
Parameter schemas lack constraints. No enums for 'type' (CreateAgent), 'category' (ListMarketRepos), or 'skill' object structure (CreateSkill). Free-form strings invite hallucinated values. Violates pattern:constrained-input.