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.
An impressively lean skill body that treats the context window as scarce and encodes real operational guardrails (receipt-gated drilldown, scope correction, source separation). Its weakness is executability: the agent is told what constraints govern recall but given no concrete tool names, argument shapes, or ordered steps to actually perform it.
Suggestions
Add a short ordered workflow (1. discover the `memory` connection tools, 2. issue composed recall with project/workstream scope, 3. on `No projection head` correct scope and retry, 4. gate raw transcript access on `evidenceDrilldownReceipt`, 5. synthesize with receipts) so the sequence is explicit rather than implied across paragraphs.
Include one concrete example of a composed recall invocation — the MCP tool name and structured argument shape — so 'composed recall using the exact project/workstream scope and access envelope' becomes executable rather than descriptive.
Name the concrete artifacts the skill depends on (which tool serves composed recall, which accepts the drilldown receipt) or state where to discover them, since 'Discover the connection and callable tools for this session' currently leaves the key lookup step unspecified.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is five tight paragraphs (~200 words) with zero padding — phrases like 'historical examples do not prove availability' and 'A disconnected direct MCP server does not prove the saved connection is unavailable' deliver dense operational rules with no explanation of concepts Claude already knows. Every token carries a rule; nothing could be cut without losing guidance. | 5 / 5 |
Actionability | Guidance is high-level direction — 'Discover the connection and callable tools for this session', 'Start with composed recall using the exact project/workstream scope and access envelope' — with only two concrete identifiers (`evidenceDrilldownReceipt`, the `No projection head` error) and no named tools, commands, argument examples, or callable sequences. It describes guardrails rather than giving executable steps, matching the 'minimal concrete guidance; high-level hints but missing specific steps' anchor. | 2 / 5 |
Workflow Clarity | An implicit sequence exists (discover connection → composed recall → scope correction → receipt-gated drilldown → synthesis) and there are partial checkpoints ('Correct the scope on `No projection head`', 'report that gap and continue'), but steps are never listed or ordered explicitly. This sits between anchor 2 (poorly defined steps) and anchor 3 (sequence present, checkpoints implicit) — the recovery rules lift it to 3, while the lack of any explicit ordering keeps it below 4. | 3 / 5 |
Progressive Disclosure | The skill is well under 50 lines with no external reference files needed, and all content appropriately lives in SKILL.md with no nested references (the assets/ images are unreferenced but harmless). The only structural gap is that the body is header-less flowing paragraphs rather than 'well-organized sections', which keeps it below the 5 the simple-skill exception allows. | 4 / 5 |
Total | 14 / 20 Passed |