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.
A well-structured, compliance-heavy design skill with an explicit step sequence, a done-when validation checklist, and clear cross-skill routing. Its main costs are token weight from repeated guardrail restatements and the absence of any worked example (disclosure line, kit skeleton, blueprint outline) that would make deliverables copy-paste ready.
Suggestions
State the registry-write path ("advocate rows go to memory/events/channels.ndjson via an authorized `operation: propose` request to `registry-events.py`") once in the Skill Contract and reference it from steps 3 and Save Results instead of repeating the full invocation five times.
Consolidate the no-automation rule into the Scope Guard and the step-6 guardrail list, dropping the restatements in steps 2 and 7.
Add one short worked example — a sample per-person disclosure line and a fill-in-your-own-words kit skeleton — so the per-person variation and disclosure requirements are executable rather than descriptive.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body never explains concepts Claude already knows, but it restates the same guardrails repeatedly: "via an authorized `operation: propose` request to `registry-events.py`" appears five-plus times, and the no-posting/no-engagement-automation rule is repeated in the scope guard, step 2, step 6, and step 7. This matches 'mostly efficient but… could be tightened'; it is not score 2 because the redundancy is policy emphasis in a compliance skill rather than padded conceptual explanation. | 3 / 5 |
Actionability | Guidance is concrete for an instruction-only skill: exact roster fields (`advocate_ref`, disclosure line, opt-in date, voluntary-basis evidence), "3+ distinct angles", a 3-7 day stagger, and an enumerated receipt shape (channel/account, kit hash, actor ref, timestamp, status, live evidence). It falls short of fully copy-paste-ready because no worked example of a disclosure line, a per-person kit skeleton, or a blueprint outline is shown — minor gaps rather than the missing specifics of anchor 3. | 4 / 5 |
Workflow Clarity | Eight cleanly sequenced steps are backed by an explicit validation checklist ("Done when: the mode is decided; every roster row has all four fields; … posting windows are staggered; … rights; … remain planned until the advocate returns a matching human-action receipt") plus explicit failure handling ("block expired/revoked/disputed/unknown rights", "no receipt means not posted", missing opt-in evidence routed to open-loops). This matches the checklist-and-validation anchor; anchor 4 would leave checkpoints implicit, which they are not. | 5 / 5 |
Progressive Disclosure | Sections are well organized (Quick Start, Skill Contract, Instructions, Reference Materials, Next Best Skill) with one-level-deep, clearly signaled references. However, no bundle files exist in this skill (no references/, scripts/, or assets/ directories), all detail lives inline in a single ~75-line file, and several links route through other skills' folders (e.g., ../social-calendar-builder/references/human-action-control.md, ../../host/social-quality-auditor/SKILL.md) — minor organization gaps that keep it below the clean one-level-deep split of anchor 5. | 4 / 5 |
Total | 16 / 20 Passed |