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.
The content is highly actionable and the destructive-apply workflow is exceptionally well-gated with dry-run, path verification, user confirmation, and a backup-abort feedback loop. The only weaker dimension is progressive disclosure, constrained by the absence of any bundle reference files to split content into.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and largely assumes Claude's competence; the HNSW/pool-cap and Phase-1 limitation notes are project-specific and earn their place, with only minor redundancy (read-only emphasis repeated) keeping it below 5. | 4 / 5 |
Actionability | Provides fully executable, copy-paste-ready commands ('uv run python scripts/core/memory_review.py <project>', 'memory_apply.py ... --ids ... --execute') with flags and concrete examples covering the common cases. | 5 / 5 |
Workflow Clarity | Clear four-step sequence with explicit validation checkpoints for a destructive/database operation: dry-run first, verify resolved paths, confirm with user, and a pg_dump backup that aborts the apply on failure, with a feedback loop on backup failure. | 5 / 5 |
Progressive Disclosure | No bundle files exist, so the single well-sectioned SKILL.md (Usage, numbered Process, Rules) holds all content with clearly signaled script paths; good structure with minor organization gaps rather than the ideal one-level-deep reference split. | 4 / 5 |
Total | 18 / 20 Passed |