Content
85%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A concise, well-structured instruction skill with a clear workflow and good progressive disclosure. Its main gap is actionability: the actual crafting method is delegated to the style guide rather than summarized inline with at least one example post.
Suggestions
Include one short example post inline in the body so the target output is concrete without needing to open the reference first.
Summarize the structure template (benefit -> what it does -> optional example -> hashtags) inline rather than only in references/style-guide.md.
Make the 'Craft the post' step state the concrete drafting order explicitly instead of pointing entirely to the style guide.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean, uses tight bullets, and does not explain concepts Claude already knows; the brief intro is only mildly redundant with the constraints but every token largely earns its place. | 3 / 3 |
Actionability | The inline constraints are concrete (length, banned phrases, naming, structure, hashtags) and there is an approval step, but the core drafting guidance ("Craft the post: follow the constraints in references/style-guide.md") delegates the key how-to details such as the structure template, examples, and approved hashtags to the reference rather than providing them inline, leaving the guidance incomplete. | 2 / 3 |
Workflow Clarity | A clear three-step sequence (Understand feature -> Craft post -> Present for approval) with an explicit approval checkpoint before finalizing; for a simple single-task skill this is unambiguous and includes a feedback loop. | 3 / 3 |
Progressive Disclosure | Well-organized sections with a single clearly signaled, one-level-deep reference to references/style-guide.md (a real bundle file), with the overview staying concise and details pushed to the reference. | 3 / 3 |
Total | 11 / 12 Passed |