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 dense, well-structured instruction skill: a sequenced procedure with validation checkpoints, a copy-paste checkpoint template, and honest limitations. The main gaps are a changelog-style paragraph that costs tokens, a script reference that cannot be verified against the bundle, and missing exact commands for the reconciliation step.
Suggestions
Ship suggest-compact.sh in a scripts/ directory (or inline its trivial logic) so the referenced command is actually present in the bundle.
Add the exact reconciliation commands (e.g. git status, git log -1 --format=%H, git diff --stat) to procedure step 2 to make it fully executable.
Move the "Earlier versions incremented a shared user-state counter" migration note into a short 'Migration' or 'Deprecated behavior' subsection so the main procedure stays lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence ("A tool-call count is only a reminder; it cannot measure context quality or decide when compaction is safe") with no filler explanations, but the "Earlier versions incremented a shared user-state counter" changelog paragraph is history that could be trimmed, fitting anchor 4 rather than anchor 5's every-token-earns-its-place. | 4 / 5 |
Actionability | A copy-paste checkpoint template, an exact bash invocation with env vars (COMPACT_TOOL_COUNT, COMPACT_THRESHOLD) and a concrete worked example give mostly executable guidance; it falls short of anchor 5 because "Reconcile task state with the filesystem and Git" names no exact commands and the referenced suggest-compact.sh is absent from the bundle. | 4 / 5 |
Workflow Clarity | The six-step procedure is clearly sequenced with explicit validation checkpoints (step 4 checks the next action would not "repeat a merge, send a message twice, lose a constraint"; step 6 requires verifying mutable state on resumption), matching anchor 4; anchor 5 is not reached because there is no fix-and-retry feedback loop around the verification steps. | 4 / 5 |
Progressive Disclosure | Sections are well-organized and appropriately sized for a single-file skill, but the body is just over 50 lines and references a script path (skills/cc-skill-strategic-compact/suggest-compact.sh) that does not exist in the bundle, leaving a minor organization gap at anchor 4. | 4 / 5 |
Total | 16 / 20 Passed |