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 well-orchestrated router skill: concrete commands with exit-code-driven branching, validation gating before any drafting, and verified one-level-deep references. Its two minor weaknesses are near-verbatim duplication of the safety statement between the blockquote and hard rules, and incomplete navigation to the five forked sub-skills that hold the remaining scripts.
Suggestions
Drop the duplicated automation/safety sentence from either the opening blockquote or the first hard rule (they say the same thing about credentials, API, scraping, and auto-sending).
Give the five lane sub-skills explicit paths or skill identifiers in the lane table so the fork target is navigable, and clarify that the other 15 of the 17 scripts live in those sub-skills.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — no explanation of known concepts, dense tables, commands only. However, the opening blockquote ('No LinkedIn credentials, no API calls, no scraping, nothing auto-sent') nearly verbatim duplicates the first hard rule, and the footer repeats '17 stdlib scripts · nothing auto-sent', so minor trims remain. | 4 / 5 |
Actionability | Fully executable guidance: copy-paste commands for both scripts ('python3 scripts/linkedin_policy_gate.py --text "<the user's own words>" --output human') with complete exit-code semantics (REFUSE=4/CONSTRAIN=3/ALLOW=0, route=0/ambiguous=2/no-signal=3), a lane table with typical asks, and five concrete forcing questions with recommendations. | 5 / 5 |
Workflow Clarity | Clear gate-before-draft sequence with the policy gate as an explicit validation checkpoint, precedence rules ('A REFUSE outranks any route below'), a refuse→substitute→reroute feedback loop, and a stop condition ('Stop as soon as the lane can run honestly'). No destructive or batch operations exist, so the validation cap does not apply. | 5 / 5 |
Progressive Disclosure | The overview is lean, references are one level deep, clearly signaled with roles, and all linked files (2 scripts, 2 references, 1 asset) verify as real bundle files. But the five lane sub-skills are named ('linkedin-profile', etc.) without paths, and the '17 stdlib-only Python scripts' claim versus 2 scripts present in this bundle leaves a navigation ambiguity for the other 15. | 4 / 5 |
Total | 18 / 20 Passed |