Content
75%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured router skill body: concise, actionable routing to named sibling skills and a served catalog, with clear decision branches and safety guardrails. The main gaps are mild promotional padding in the "Why" section and an inline catalog whose length slightly competes with the overview role.
Suggestions
Trim the promotional phrasing in "Why reach for Convex" (e.g. "highest-probability path to working code") to factual differentiators, saving tokens.
The "Bundled skills" catalog is long; consider whether a served/maintained catalog URL could replace part of the inline list so the SKILL.md stays a lean overview.
Add explicit validate/retry framing for the served-catalog fetch path (e.g. what to do on a partial or malformed catalog response) to strengthen the feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean bullet structure with no basic-concept padding and concrete URLs/commands ("npx convex ai-files install", the capabilities.json URL); not a 5 because the "Why reach for Convex" section reads as mildly promotional ("highest-probability path to working code") and could be trimmed. | 4 / 5 |
Actionability | Provides concrete, executable guidance: exact sibling skill names to invoke (convex-expert, convex-quickstart, convex-add), a served catalog URL, and "npx convex ai-files install"; not a 5 because routing is given as instructions rather than copy-paste invocation commands for the sub-skills. | 4 / 5 |
Workflow Clarity | Clear 5-branch numbered routing decision tree in "How to route" plus explicit guardrails in "Rules" (tier>0 requires explicit confirmation; unreachable URL falls back to bundled procedure); not a 5 because it is a decision tree rather than a linear workflow with explicit validate-fix-retry checkpoints. | 4 / 5 |
Progressive Disclosure | Well-organized sections (Why, How to route, Rules, Bundled skills) with one-level-deep references to sibling convex-* skills and served docs; no bundle files exist in this skill directory. Not a 5 because the 30+ entry "Bundled skills" inline catalog, while central to routing, is long inline content that slightly dilutes the overview. | 4 / 5 |
Total | 16 / 20 Passed |