Content
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured workflow skill with clear step sequencing and good handling of edge cases (multiple handoffs, no handoffs, archived handoffs). The main weaknesses are that some operations lack executable code (frontmatter parsing, file moving) and there's mild verbosity in sections like 'When to Use' that explain obvious contexts. Overall a solid instructional skill that could be tightened.
Suggestions
Add executable code for key operations: parsing YAML frontmatter to check 'restored: false', updating frontmatter fields, and moving files to archive (e.g., using sed/awk or a script invocation).
Trim the 'When to Use' / 'Don't use when' section — these cases are largely inferrable from the overview and add tokens without adding clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but includes some unnecessary sections like 'When to Use' with obvious cases and 'Don't use when' that Claude could infer. The 'Announce at start' line and some explanatory text could be trimmed. | 2 / 3 |
Actionability | Provides concrete steps and bash commands, but key operations like parsing YAML frontmatter, updating frontmatter fields, and moving files lack executable code. The filtering for 'restored: false' is described abstractly rather than with concrete commands (e.g., grep or a script). | 2 / 3 |
Workflow Clarity | Clear 5-step sequential process with explicit branching logic for different scenarios (one handoff, multiple, none). Step 5 has a well-ordered sub-sequence for context restoration. The workflow handles edge cases and provides a logical progression. | 3 / 3 |
Progressive Disclosure | The skill references companion skills (handoff, handoff-list) at the end which is good, but all content is inline in a single file. The 'Pairs With' section provides useful navigation. However, there are no bundle files and no external references for deeper details, though the skill's complexity may not strictly require them. | 2 / 3 |
Total | 9 / 12 Passed |