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.
A tightly written, highly actionable body whose commands are executable as written and whose verification/feedback loop for the destructive upload operation is exemplary. The main weaknesses are the entirely-inline structure with a dangling reference to a script the bundle does not actually ship.
Suggestions
Either ship the referenced `gh-attach shot` script in the bundle (e.g., scripts/) or remove/correct the claim that this package ships it.
Consider moving the Sizing and Verify edge-case detail into a references/ file to shorten SKILL.md toward a lean overview.
Fold the version requirement ("gh 2.99 or later") into a prerequisites line or compatibility note rather than a bare sentence, so it ages more gracefully.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes competence throughout (no explanations of gh, GitHub, or markdown basics) and every section covers genuinely non-obvious gotchas, but a bare version requirement ("Needs `gh` 2.99 or later") and a few tightly-packed passages could be trimmed or restructured, keeping it just below the leanest anchor. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover the common cases end to end: attaching in one command, commenting, placing an image under an existing `## Evidence` heading via a working awk recipe, verifying embed counts, and resizing with an `<img>` tag. | 5 / 5 |
Workflow Clarity | The workflow has explicit validation checkpoints (the Verify section, with count-based checks for both embeds and leftover local paths) and clear feedback loops (short count → re-attach only the missing; misplaced reference → hand-rewrite rather than re-upload), plus a result table mapping exit-code/URL combinations to next actions. | 5 / 5 |
Progressive Disclosure | Sections are clear and well cross-referenced (Verify, Sizing, Place an image in an existing description), but all ~167 lines live inline in SKILL.md with no splitting, and the body references a shipped script `gh-attach shot` that is not present in the bundle (no scripts/ directory), leaving minor organization gaps. | 4 / 5 |
Total | 18 / 20 Passed |