Content
100%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.
The body exemplifies the skill format: a dense overview that contracts out mechanical work to three scripts, states exit codes and stop conditions instead of vague "check the output" advice, and enforces rules (no fabrication, fold discipline, accessibility floor) as memorable absolutes. The only unverifiable aspect is that the referenced bundle files were not present in the review directory.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~85-line body is lean and assumes competence: there is no explanation of what LinkedIn is or how posts work; every line is a command, an exit-code contract, a rule, or a scope boundary, and even the stylistic one-liners ("Posts without pillars are noise") carry routing signal. Not 4: no section could be trimmed without losing operative content. | 5 / 5 |
Actionability | Three fully executable commands with complete flags (e.g. "python3 scripts/post_linter.py --input draft.md --has-image --output human"), explicit exit-code semantics (0 SHIP / 2 REVISE / 3 REWRITE) with named consequences, a concrete fold budget ("the first ~140 characters"), and concrete drafting guidance ("the number, the mistake, the sentence someone said"). Not 4: the commands are copy-paste ready and the common cases are covered. | 5 / 5 |
Workflow Clarity | A five-step sequence with an explicit validation feedback loop: lint before shipping with exit-code outcomes, "Two passes is normal; the stop condition is exit 0 or a stated decision to accept a warning", plus tie-break and refusal rules in the format picker and a brief-check gate in step 1. This matches the anchor with validate → fix → retry and a stated stop condition. | 5 / 5 |
Progressive Disclosure | A clear overview that splits detail into one-level-deep, well-signaled resources: three scripts listed in a table with roles, four references each annotated with its scope ("the first 140 characters, and the openers to delete on sight"), and two assets — navigation is easy and nothing is buried. Note: no bundle files were present in the review directory to verify the paths against, but the structure as written is the reference ideal. Not 4: content is appropriately split with clear signals throughout, with no inlined bulk that belongs elsewhere. | 5 / 5 |
Total | 20 / 20 Passed |