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.
A well-structured orchestrator body with a genuine validation-first workflow, exit-code-driven branching, and lean token usage. The main defects are that none of the referenced bundle files (2 scripts, 2 references, 1 asset) are actually present, and the post-routing step — invoking a lane sub-skill — lacks executable detail.
Suggestions
Ship the referenced bundle files (scripts/linkedin_policy_gate.py, scripts/linkedin_goal_router.py, references/linkedin_platform_canon.md, references/policy_and_account_safety.md, assets/linkedin_operating_agreement.md) or remove/trim the references so no path in the body dangles.
Add one concrete line for Step 2's outcome — the path or invocation pattern for the five lane sub-skills (e.g. where linkedin-profile lives and how to load it) so 'invoke that lane' is executable.
Reconcile the '17 stdlib-only Python scripts' claim with the 2 scripts documented, or move the full script inventory into a referenced file the bundle actually contains.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence: no explaining what LinkedIn is, no library tutorials — just a gate command, router command, exit-code semantics, a lane table, five forcing questions, and hard rules. Not 5: minor trimmable content exists — the editorial framing 'The five lanes cover what actually moves' and a 'Distinct from' section that duplicates the frontmatter's distinct_from field. | 4 / 5 |
Actionability | Concrete copy-paste commands with flags and placeholders ('python3 scripts/linkedin_policy_gate.py --text "<the user's own words>" --output human'), branch-by-exit-code instructions, and a lane-to-ask table. Not 5: after routing, the main action 'invoke that lane' has no path or command for the five sub-skills, '/cs:grill-linkedin' is referenced without saying where it lives, and only 2 of the claimed 17 scripts are shown — so the common cases aren't fully covered by executable guidance. | 4 / 5 |
Workflow Clarity | Clear three-step sequence (gate → route → forcing questions) with an explicit validation checkpoint before any drafting, prescribed error-recovery per branch (exit 4 REFUSE: name the rule and route to the printed substitute; exit 2: ask one question with a recommendation; exit 3: ask what they want), and a hard-rules checklist. Feedback loops and 'A REFUSE outranks any route below' precedence are explicit. | 5 / 5 |
Progressive Disclosure | The in-file structure is good — a lean overview with clearly signaled, one-level-deep references (scripts table, references list with one-line descriptions). But scored against the actual bundle: no scripts/, references/, or assets/ directories exist, so every referenced path (linkedin_policy_gate.py, linkedin_platform_canon.md, linkedin_operating_agreement.md) is dangling and the '17 stdlib scripts' claim is unverifiable. Not 4 because navigation to the referenced material is broken as delivered; not 2 because the SKILL.md itself is well organized and references are not buried or nested. | 3 / 5 |
Total | 16 / 20 Passed |