Content
75%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 a well-structured, actionable instruction set with clear sequencing and validation checkpoints, appropriately deferring detail to referenced materials. It is slightly verbose in places and leans on external references for a few specifics rather than inlining them.
Suggestions
Collapse the overlap between the intro and the 'Scope guard' paragraph into one concise scope statement to trim tokens.
Inline the key disclosure-wording rules and the most critical de-slop checks so the skill is self-contained without opening humanizer-slop.md / the claims ledger.
Add an explicit fix-and-retry loop for the claims-disclosure step (block → propose wording → re-check before unblocking publish-ready status) to strengthen the validation feedback path.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Information-dense and assumes Claude's competence (no explaining of social-platform basics), but the intro and 'Scope guard' paragraph overlap and several compound sentences are heavy with domain jargon that could be tightened. | 4 / 5 |
Actionability | Provides concrete, specific guidance — named hook taxonomy, per-platform formats, carousel char budgets (~70% of platform max), named artboards and file paths — but some specifics (exact disclosure wording, de-slop rules) are deferred to referenced files rather than inline. | 4 / 5 |
Workflow Clarity | Eight clearly sequenced steps with explicit validation (step 6 claims block, step 7 negative checklist) and a 'Done when' bar; the error path is mostly block-and-flag rather than a fix-and-retry loop, leaving minor checkpoint gaps. | 4 / 5 |
Progressive Disclosure | Well-organized into labeled sections with a dedicated, descriptive 'Reference Materials' list of one-level-deep links; no bundle files exist to verify, and a few deep relative paths point to files outside the skill's own bundle. | 4 / 5 |
Total | 16 / 20 Passed |