Content
77%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, actionable instruction skill with a clear sequenced workflow, thoughtful fallbacks, and a validating checklist. Its main defects are a broken reference to a missing template file (which also weakens the otherwise fully executable guidance) and some repetition across the Include/Exclude table, Anti-patterns, and Definition of done.
Suggestions
Ship the referenced templates/handoff.template.md (or inline the template's section headings into the body) — step 5 instructs writing the file 'from templates/handoff.template.md', but no such file exists in the bundle.
Deduplicate the rules that appear in both the Include/Exclude table and Anti-patterns (secrets, no placeholders/TODOs, no raw transcripts) and trim the opening paragraph, which restates the frontmatter description.
Add short filled-in examples for the Goal and Current state sections to mirror the good/bad Plan example, so every section the reader must write has a concrete model.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly earns its tokens — tables, one-line anti-patterns, and a tight good/bad example pair — but the opening paragraph restates the frontmatter description, and the secrets, no-placeholder, and one-line-pointer rules each appear two to three times across the Include/Exclude table, Anti-patterns, and Definition of done. This matches 'efficient with minor instances that could be trimmed' rather than the noticeably-padded anchor 3. | 4 / 5 |
Actionability | Guidance is mostly executable: exact commands ("git rev-parse --abbrev-ref HEAD", "pbcopy < <path>"), a concrete path-resolution chain with fallbacks, and a good/bad example pair citing "src/cli.ts:parseArgs" and line 42. It falls short of anchor 5 because only the Plan section gets a worked example (Goal and Current state do not) and step 5 depends on templates/handoff.template.md, which is not present in the bundle. | 4 / 5 |
Workflow Clarity | Seven clearly sequenced steps with explicit error-recovery fallbacks at each fragile point (non-git cwd falls back to `.agent/handoff.md`, unwritable directory to the scratchpad, missing `pbcopy` is skipped and reported) and a Definition-of-done checklist that validates the output (no secrets, no placeholders, scope stated). This is not a destructive or batch operation, so no cap applies, and it matches the anchor-5 pattern of checkpoints plus feedback for error conditions. | 5 / 5 |
Progressive Disclosure | Sections are well organized with clear headers, and the sole reference ("[templates/handoff.template.md](./templates/handoff.template.md)") is one level deep and clearly signaled — but that file does not exist in the bundle (no templates/, references/, scripts/, or assets/ directories are present). Scored against the actual bundle structure, the single external reference is broken and the section content it should carry is missing, which fits anchor 3 rather than the 'minor organization gaps' of anchor 4. | 3 / 5 |
Total | 16 / 20 Passed |