Content
76%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 lean, well-organized instruction-only skill with copy-paste commands and concrete examples, held back by an implicit generation workflow and no validation: no character-count limit enforcement is specified for the tweet itself, trend sourcing is hand-waved, and the destructive '/tweets clear' has no confirmation step. Spelling out the generation sequence and a safety check for clear would lift it substantially.
Suggestions
Add an explicit generation workflow: 1. load saved style (or ask if unset), 2. gather trends or read CHANGELOG/README/package.json, 3. draft 3-5 tweets in style, 4. verify each is within the character limit, 5. present with IDs and offer '/tweets save <id>'.
Specify how trend data is actually obtained (which feeds/sources or search tools) and what to do when no data is available (e.g., ask the user for a topic).
Add a confirmation or validation checkpoint before '/tweets clear' discards saved drafts, and state the tweet character limit in the Output section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section earns its tokens: a terse command table, copy-paste examples, brief mode descriptions, and a compact output spec, with no explanation of concepts Claude already knows. This matches anchor 5 ('Lean and efficient; assumes Claude's competence; every token earns its place'); it is not 4 because there is no identifiable over-explanation to trim. | 5 / 5 |
Actionability | Concrete copy-paste slash commands with arguments ('/tweets generate "bitcoin etf"', '/tweets changelog /path/to/CHANGELOG.md') plus concrete style strings cover the common cases, matching anchor 4 ('Mostly executable guidance; concrete commands with minor gaps'). It falls short of 5 because the core generation step is underspecified: 'Pulls from crypto news feeds, market data, social signals' names no actual sources, tools, or fallback when no trend data is available, so execution of the central command is left to inference. | 4 / 5 |
Workflow Clarity | Modes and output are described, but the agent's actual sequence (load saved style, gather source data, draft, verify character count, present with IDs for saving) is implicit rather than listed, and there are no validation checkpoints. Additionally, '/tweets clear' destructively discards all saved drafts with no confirmation or safety step, and per the judging guidelines a destructive/batch operation without validation caps workflow clarity at 3. It is above 2 because the mode descriptions and command semantics do convey a rough sequence. | 3 / 5 |
Progressive Disclosure | The body is a single well-organized file (~70 lines) with clear sections (Commands, Examples, How It Works, Output) and no nested or buried references, matching anchor 4 ('Good structure; most content is appropriately placed; minor organization gaps'). It does not reach 5 because the under-50-lines exception does not apply and everything is inline with no signaled extension points (e.g., a styles/references file) if the skill grows. | 4 / 5 |
Total | 16 / 20 Passed |