Content
86%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 capability skill: executable commands with concrete output-destination guidance, clean one-level-deep reference files, and a sharp when/when-not-to-use framing. The only deductions are minor philosophical padding and an operating sequence that must be assembled from multiple sections rather than read as one flow.
Suggestions
Trim the meta-commentary sentences ('It is a tool, not a ceremony', 'Forcing every recall into a fixed file makes the file grow into noise') to their operative guidance.
Add a short ordered recall flow (e.g., 1. search/list → 2. context/extract → 3. choose destination) so the multi-subcommand workflow reads as a sequence instead of parallel sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence (no explaining what session logs or CLIs are), but carries minor trimmable padding — e.g., 'It is a tool, not a ceremony', 'Forcing every recall into a fixed file makes the file grow into noise', and 'keep that handy when training instinct'. These are philosophical justifications rather than instructions, matching the 'efficient; minor instances of over-explanation' anchor rather than the every-token-earns-its-place anchor. | 4 / 5 |
Actionability | Copy-paste-ready bash covering all 80% cases with flags and their semantics ('trellis mem search "<keyword>"', 'trellis mem extract <session-id> --phase brainstorm', 'trellis mem list --cwd <project-path>'), plus a concrete decision list for what to do with results. This matches the fully-executable top anchor. | 5 / 5 |
Workflow Clarity | Read-only capability skill, so the destructive/batch cap does not apply, and sections are clearly organized (when / when not / what to do with output / how to call). However, the operating sequence (projects or list → search → context/extract → decide destination) is distributed across sections with only one explicit sequencing hint ('When you do not know the session id yet, start with list + filter'), fitting the 'clear sequence with minor gaps' anchor rather than anchor 5's explicit end-to-end flow. | 4 / 5 |
Progressive Disclosure | The body keeps only the 80% cases inline and cleanly splits the full flag reference to references/cli-quick-reference.md and verbatim trigger phrasings to references/triggering-patterns.md. Both files exist, are one level deep, and are clearly signaled with their content described — matching the 'clear overview with well-signaled one-level-deep references' anchor. | 5 / 5 |
Total | 18 / 20 Passed |