Content
73%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 delivers an unusually rigorous, well-sequenced workflow with validation gates and error-routing at every stage, backed by real, well-signaled one-level-deep reference files. Its main cost is density and repetition: governance rules are restated in multiple sections in heavy internal jargon, inflating token cost without adding guidance for the common plan-authoring path.
Suggestions
Consolidate the repeated governance rules (opaque refs, transient raw locators, fresh exact authorization, never-invent) into a single 'Artifact rules' block in the Skill Contract and reference it from the Instructions instead of restating each rule 3-4 times.
Move the tracker state-machine detail (receipt chains, supersession, close/reopen mechanics) into a dedicated reference file like references/tracker-protocol.md, keeping only the mode gate and close-eligibility rules inline to slim the SKILL.md body.
Replace internal jargon such as 'qualified-resolver-backed opaque ref' and 'single non-forked current head' with a short defined-terms list or plainer phrasing so the guidance is followable without cross-document context.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body never explains concepts Claude already knows, but the same governance constraints (opaque refs, raw locators stay transient, fresh exact authorization, never invent values) are restated across Skill Contract, Instructions, and the tracker paragraphs in dense legalese ('qualified-resolver-backed opaque ref', 'single non-forked current head'), so it could be materially tightened. | 3 / 5 |
Actionability | Concrete, executable instruction guidance: explicit mode-selection rules ('plan-only | tracker-only | both'), nine ordered steps each mapped to a named template block, exact save paths (memory/influencer/campaign-planner/YYYY-MM-DD-<topic>.md), and named artifacts/authorizations; minor gaps remain because the 'five-kind control schema' and §10 gate checklist are delegated to references rather than stated. | 4 / 5 |
Workflow Clarity | Clear sequence with explicit validation and error recovery: a mode gate precedes all work, steps 1–9 run in order with template mapping, binding gaps return NEEDS_INPUT instead of proceeding, validation failures surface 'PARTIAL CHECKPOINT COVERAGE — NOT CLOSE-ELIGIBLE', and failed gates route to creator-content-auditor — matching the checklist-plus-feedback-loop anchor. | 5 / 5 |
Progressive Disclosure | References are one level deep, verified to exist (references/templates.md contains §§1–10 and the cited worked example; references/influencer-tiers.md exists), and clearly signaled with anchors and per-file descriptions in a Reference Materials section; however, ~104 lines of dense contract prose are inlined in SKILL.md itself, which is heavier than the lean-overview anchor. | 4 / 5 |
Total | 16 / 20 Passed |