Content
92%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 instruction skill: an explicit ordered workflow, executable commands with validation via script refusal and exit codes, and clean progressive disclosure into real reference and asset files. The only minor drag is light editorial voice that could be tightened.
Suggestions
Tighten the rhetorical asides (e.g. 'an editorial constitution, not a wish', 'a positioning that excludes nothing is availability') into plainer decision statements to recover a few tokens without losing the rule.
Add a one-line 'if validation fails, fix and re-run' framing around the script commands to make the validate→fix→retry feedback loop explicit rather than implied by exit codes.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean, assumes Claude's competence, and never explains concepts Claude already knows; a few editorial flourishes ('an editorial constitution, not a wish', 'a positioning that excludes nothing is availability') are decision-relevant but could be trimmed, keeping it just below the lean anchor. | 4 / 5 |
Actionability | Each of the three decisions ships with a copy-paste-ready command and full arguments (e.g. 'python3 scripts/cadence_planner.py --minutes 240 --stage starting --target-posts 3 --output human'), covering the common cases concretely. | 5 / 5 |
Workflow Clarity | The three decisions are explicitly ordered ('in this order. Out of order is why most LinkedIn efforts... stop in week five'), and each script acts as a validation checkpoint with documented exit codes (0 fits / 2 below floor / 3 over budget), giving clear feedback on failure. | 5 / 5 |
Progressive Disclosure | The body is a concise overview with well-signaled one-level-deep references — a Scripts table, a References and assets section with links and one-line descriptions — and all referenced bundle files (references/, scripts/, assets/) exist on disk, so navigation is easy. | 5 / 5 |
Total | 19 / 20 Passed |