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.
The body is well-sequenced with a strong validation gate and concrete commands, but its progressive disclosure is undermined by a missing bundle: every referenced script, reference, and asset file is absent, and the '17 scripts' claim is unsupported.
Suggestions
Ship the bundle: create scripts/, references/, and assets/ with the files the body links to (linkedin_policy_gate.py, linkedin_goal_router.py, linkedin_platform_canon.md, policy_and_account_safety.md, linkedin_operating_agreement.md), or remove the links.
Reconcile the script count: the body and footer say '17 stdlib-only Python scripts' but the Scripts table lists only 2 — either add the missing 15 or correct the number.
De-duplicate the safety message so the 'no credentials / no API / no scraping' rule appears once (e.g. in Hard rules) rather than in the top quote, the REFUSE bullets, and Hard rules.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and mostly efficient with no over-explanation of concepts Claude already knows, but the safety message ('No credentials, no API, no scraping, nothing auto-sent') is repeated across the top quote, the Step 1 REFUSE bullets, and the Hard rules section, which could be consolidated. | 4 / 5 |
Actionability | Provides concrete copy-paste commands with flags ('python3 scripts/linkedin_policy_gate.py --text "…" --output human') and explicit exit-code decision logic (exit 4/3/0, route 0/2/3), though the actual lane sub-skill invocations are delegated rather than shown as executable steps. | 4 / 5 |
Workflow Clarity | A clear Gate → Route → Forcing-questions sequence with an explicit pre-drafting validation checkpoint and feedback loops: REFUSE names the rule and offers the printed substitute then reroutes, CONSTRAIN states the constraint, ALLOW proceeds. | 5 / 5 |
Progressive Disclosure | The structure and signaling are good (clear one-level-deep markdown links to scripts, references, and assets), but the actual bundle contains none of the referenced files — scripts/, references/, and assets/ do not exist — so every link is a dead end, and the body claims '17 stdlib-only Python scripts' while only 2 are listed and 0 are present. | 3 / 5 |
Total | 16 / 20 Passed |