Content
81%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 well-structured, highly actionable protocol: concrete tool usage, explicit field formats, sequenced workflows with validation and error-recovery branches, and lean imperative prose. The only real gaps are minor — a worked mem_save example, slight redundancy in the passive-capture section, and no reference split for the longer peripheral sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is an imperative, dense protocol with no explanations of concepts Claude already knows; every section adds Engram-specific rules. Minor redundancy (the passive-capture 'safety net, not a replacement' point appears twice, and 'Do not skip step 1. Without it...' restates the preceding line) keeps it below a 5. | 4 / 5 |
Actionability | Concrete tool names, a step-by-step search escalation ('First call mem_context... If not found, call mem_search... FTS5'), a full mem_save field spec with example titles, and a runnable fallback command ('engram setup claude-code'). Not 5 because a complete example mem_save call payload and several tool parameters are left unspecified. | 4 / 5 |
Workflow Clarity | Each multi-step process is explicitly sequenced with checkpoints and error-recovery branches: search escalation (1→2→3), topic-update rules mandating read-before-overwrite verification ('On ambiguous identity or failed lookup, do not overwrite', 'A failed read is not evidence of absence'), failure handling in the delivery guarantee, and ordered compaction recovery with 'Only THEN continue'. Validation precedes the potentially destructive mem_update overwrite, so no cap applies. | 5 / 5 |
Progressive Disclosure | A single-file skill with clear section headers, no buried or nested references, and nothing that requires external files to navigate. Not 5 because at ~101 lines it exceeds the under-50-line simple-skill exception and some content (the tool inventory, the fallback/troubleshooting details) could be offloaded to reference files. | 4 / 5 |
Total | 17 / 20 Passed |