Content
30%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 template skeleton: it is short and sectioned but contains no actual instructions, code, workflow, or bundled references, delegating everything to an external GitHub link. As a skill it would leave Claude with nothing actionable to execute.
Suggestions
Replace the generic Instructions section with executable guidance: X API authentication setup, concrete request examples for creating/publishing articles, and formatting requirements.
Add a sequenced workflow (draft → format → attach media → publish) with an explicit verification step before public posting, since publishing is an outward-facing operation.
Either inline the essential how-to content or bundle it as one-level-deep reference files (e.g. references/api.md) instead of pointing only to the external source repository, and fix the garbled phrasing 'work with publish articles to x/twitter'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~90 tokens and explains nothing Claude already knows, but the tokens it does spend are redundant template filler: "Publish articles to X/Twitter", "work with publish articles to x/twitter", and "guidance and patterns for publish articles to x/twitter" repeat the same phrase three times. This matches anchor 4 ('efficient; minor instances... that could be trimmed') rather than anchor 5, whose 'every token earns its place' standard the boilerplate repetition fails. | 4 / 5 |
Actionability | The Instructions section states only "This skill provides guidance and patterns for publish articles to x/twitter" — no code, commands, API endpoints, authentication steps, or examples. This is a direct match for anchor 1 ('entirely vague or abstract; no concrete code or commands; only describes rather than instructs'); it cannot be 2 because not even high-level hints toward executable steps are present. | 1 / 5 |
Workflow Clarity | Publishing to X is a multi-step, outward-facing operation (authenticate, draft, attach media, publish), yet the body contains no sequence of steps whatsoever and no validation before posting. This matches anchor 1 ('steps missing or incoherent; no sequence; no validation for risky operations'); anchor 2 would require at least a rough sequence, which is absent. | 1 / 5 |
Progressive Disclosure | Sections are present and well-labeled (Overview, When to Use, Instructions) and no bundle files exist to organize, but the skill's entire substance is delegated to an external URL ("see the [source repository](...)") rather than bundled one-level references, so the actual instructions are neither inline nor discoverable. This fits anchor 3 ('some structure but could be better organized'); it is not 2 since nothing is inlined or buried, and not 4 because the content is not 'appropriately placed' — it is missing. | 3 / 5 |
Total | 9 / 20 Passed |