Content
61%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.
The body is a genuinely lean, well-structured overview that correctly prioritizes rules (gateway-first, keys in Convex env, never client-side). Its main weaknesses are the complete absence of executable code or commands and missing validation checkpoints in the workflow, which leave Claude to fill in the actual API calls from prior knowledge or docs.
Suggestions
Add a minimal copy-paste code snippet for the core path: defining the agent with `languageModel: convexGateway("provider/model")` in convex.config.ts and creating/streaming a thread from an action.
Insert validation checkpoints into the workflow (e.g., verify the agent component is registered after `npx convex dev`, and test one streamed message before adding RAG).
Move the RAG/embedding setup and thread API details into one or two short reference files (e.g. references/rag.md) instead of compressing them into single-line workflow steps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence with no padding or explanation of known concepts ("Install @convex-dev/agent + @convex-dev/ai-sdk-provider; add the agent component to convex.config.ts"). A minor deduction applies for the inline time-sensitive version pin "(needs convex 1.45+ on a Convex Cloud deployment, paid plan)" which is not placed in a deprecated/old-patterns section; otherwise this would be a 5. | 4 / 5 |
Actionability | It names exact packages, the config file, and the `convexGateway("provider/model")` call, but contains zero executable code or commands — no install command, no agent-definition snippet, no thread-creation or embedding example. This matches anchor 3 ('Some concrete guidance but incomplete... missing key details') rather than 4's 'concrete code or commands with minor gaps'. | 3 / 5 |
Workflow Clarity | The Workflow section lists a clear 5-step sequence, but there are no validation checkpoints (e.g., confirming the component registered or testing a streamed message), and steps like "Create threads + stream messages; persist history in Convex" compress multiple actions. This matches anchor 3 ('Steps listed but validation gaps; checkpoints missing or implicit'). The destructive/batch cap does not apply since this is an additive integration task. | 3 / 5 |
Progressive Disclosure | The body is under 50 lines with well-organized Workflow and Rules sections, and no bundle files exist, so per the simple-skill note it could approach 5. However, the topic (agent API, RAG vector-index setup, env micro power) is complex enough that one-line compressed steps would benefit from one-level-deep reference files, matching anchor 4 ('Good structure... minor organization gaps'). | 4 / 5 |
Total | 14 / 20 Passed |