Content
88%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 excellent troubleshooting skill body: executable commands throughout, an explicit validation checklist with error-recovery steps, and tight domain-specific explanations with no filler. Remaining improvements are minor — trimming repeated statements and potentially offloading the backup-remote section to a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and imperative with commands instead of prose, and it explains only Letta/MemFS-specific behavior Claude would not know (layouts, harness push timing, enable flow side effects). It does not reach 5 because a few points are repeated (the rule to leave pushes to post-turn harness sync appears in three sections, and the credential-redaction warning appears twice), which could be trimmed. | 4 / 5 |
Actionability | Guidance is fully executable: copy-paste-ready commands such as `/memfs enable`, `letta memory pull --agent "$AGENT_ID"`, `git -C "$MEMORY_DIR" status --short --branch`, the sed-based URL redaction, `GIT_EDITOR=true git -C "$MEMORY_DIR" rebase --continue`, and `/memory-repository set git@github.com:you/my-memory.git` cover the common cases. The only placeholder (`<resolved-memory-path>`) is appropriately situational, matching the score 5 anchor. | 5 / 5 |
Workflow Clarity | The content is organized as a clear diagnostic sequence (harness commands first, then checkout inspection, uncommitted changes, conflicts, backup remote) and closes with an explicit seven-step Failure Checklist that includes validation checkpoints (confirm `$MEMORY_DIR`, check backend type, inspect git status) and an error-recovery feedback loop ("rerun it with `LETTA_DEBUG=1` and report the redacted error"), plus safety guardrails ("Do not reset, abort, or discard either side without the user's approval"). This matches the score 5 anchor with its checklist and feedback loop. | 5 / 5 |
Progressive Disclosure | The single file is well-sectioned with clear headers, one level of depth, and no buried or nested references (no bundle files exist, and every internal reference is to a named skill or command). It does not reach 5 because at ~175 lines all content is inline; sections like the Optional Backup Remote could plausibly live in a separate reference file, fitting the score 4 anchor of good structure with minor organization gaps. | 4 / 5 |
Total | 18 / 20 Passed |