Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-structured, actionable QA workflow with concrete tool calls, explicit validation/feedback checkpoints, a complete output template, and a worked example. Its only real weakness is moderate verbosity in a few explanatory and meta sections that could be trimmed without losing clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and avoids explaining basic concepts Claude already knows, but sections like 'How It Works', the Step 3.5 acting-verification prose, the iterative-loop meta, and the RFC breadcrumb footer add length that could be tightened. It is not score 1 (no padded beginner explanations like 'a PDF is a file format') and not score 3 (some passages restate or over-explain rather than earning every token). | 2 / 3 |
Actionability | It gives concrete commands (`ooo qa`, `tool discovery query: "+ouroboros qa"`), a fully specified MCP tool call with named arguments, a complete verdict output template, and a worked end-to-end example. It is not score 2 (the guidance is specific and copy-paste ready, not pseudocode) and clearly meets the score-3 'executable commands + specific examples' anchor for an instruction skill. | 3 / 3 |
Workflow Clarity | The process is clearly sequenced (Step 0 mode selection, QA Steps 1-5 with sub-step 3.5), includes explicit validation (acting-verification: run, observe real effects, probe adversarial classes, capture evidence) and feedback loops (iterative QA loop until pass/fail, re-run after revise). It is not score 2 (checkpoints are explicit, not implicit) and matches the score-3 anchor with validation steps and error-recovery loops. | 3 / 3 |
Progressive Disclosure | The body is organized into clear navigable sections (Usage, How It Works, Instructions, Fallback, Example) and its single external reference (`<project-root>/src/ouroboros/agents/qa-judge.md`) is one level deep and clearly signaled; no nested 2+-level reference chains exist. It is not score 2 (organization is clean and the reference is well signaled, with no inline content that obviously belongs in a separate file) and not below 3. | 3 / 3 |
Total | 11 / 12 Passed |