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, actionable guidance skill with concrete CLI/MCP examples and a clear validated workflow. It is efficient and navigable, with only minor room to tighten prose and make the doctor feedback loop explicit.
Suggestions
Make the validation feedback loop explicit: after `ecc memory doctor`, state 'fix reported files, then re-run `ecc memory doctor` until clean' rather than only 'Repair reported files manually'.
Tighten the Runtime Prerequisite and Trust And Data Boundaries sections by moving explanatory rationale into a short rationale line, keeping the actionable rules up front.
Replace remaining placeholders (`<memory-id>`, `<repo>`) with a brief inline note on how to obtain them (e.g. from `ecc memory search` output) to make every example fully executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and well-sectioned with actionable commands, but the Runtime Prerequisite and Trust And Data Boundaries sections contain explanatory prose that could be trimmed slightly. | 4 / 5 |
Actionability | Provides concrete, copy-paste-ready CLI commands with full flags (e.g. the `ecc memory save` example) plus MCP equivalents; minor placeholders like `<memory-id>` and the external `--body-file` keep it just short of fully executable everywhere. | 4 / 5 |
Workflow Clarity | A clear four-step sequence (recall, save, hand off, validate) with an explicit validation step (`ecc memory doctor`); the fix-then-revalidate feedback loop is only implicit ('Repair reported files manually'). Operations are create-only/read-only, so the destructive-cap does not apply. | 4 / 5 |
Progressive Disclosure | No bundle files exist; the single SKILL.md is well-organized with clear headers and easy navigation. The MCP Setup and Trust And Data Boundaries sections are somewhat lengthy inline content that could optionally live in reference files, but inlining is reasonable for a guidance skill. | 4 / 5 |
Total | 16 / 20 Passed |