Content
57%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-organized instructional skill with unusually concrete numbers (slide counts, font sizes, poster dimensions) and a clear reference-file section, undermined by generic best-practice padding, one-line workflows without error checkpoints, and progressive-disclosure defects: a broken reference to examples/post-acceptance-plan.md, three bundle files never surfaced in SKILL.md, and a second-level pointer inside xquik-promotion.md.
Suggestions
Trim the Best Practices sections and the redundant "When to Use" and "Summary" sections — generic advice like "practice timing" and "arrive early" competes for context without adding information Claude lacks; keep only the numeric guidance.
Fix the reference structure: create or remove `examples/post-acceptance-plan.md`, add the three template/example files (`poster-templates/basic-poster-template.md`, `presentation-templates/basic-template.md`, `promotion-examples/twitter-example.md`) to the Reference Files list, and resolve or inline the `MCP_SETUP.md` pointer inside `references/xquik-promotion.md`.
Expand the three one-line workflows with validation checkpoints — e.g. after "Design slides", add a timing check against the talk length; after "Draft by platform", add a fact-check step against the verified-links list before co-author review.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The concrete numeric guidance ("15-minute talk: 10-15 slides", "Title font: 72-96pt", "24x36 inches or A0") earns its place, but the body pads with knowledge Claude already has — "Practice timing with a stopwatch", "Use animations sparingly", "Arrive early to test equipment", "Tell a story: problem -> insight -> solution -> impact" — plus a redundant "When to Use" section that restates the frontmatter description and a "Summary" section that repeats the intro. This is anchor 3 (mostly efficient with unnecessary sections that could be trimmed), below anchor 4 where such trimming would be minor. | 3 / 5 |
Actionability | As an instruction-only skill, the core guidance is genuinely actionable: exact slide counts per talk length, a slide-by-slide content structure, poster dimensions, font-size floors, a five-zone poster layout, and per-platform promotion templates ("Thread structure: Hook -> Problem -> Method -> Key Result -> Link", "Blog Post: 800-1500 words"). It sits at anchor 4 (mostly executable guidance with minor gaps) rather than 5 because the Best Practices sections drift into vague direction ("Start with the 'so what'", "Use visual hierarchy to guide the eye") without concrete examples. | 4 / 5 |
Workflow Clarity | Three workflows are given as single-line arrow chains ("Paper accepted -> Identify key messages -> Create slide outline -> Design slides -> Practice timing -> Prepare Q&A backup slides"). The poster chain includes a validation step ("Print test at reduced size") and the promotion chain includes "Verify claims and links" and "Publish or schedule after approval", but the presentation chain has no checkpoint at all, and none of the chains define what to do when a step fails. This matches anchor 3 (sequence present, checkpoints missing or implicit) and clearly not anchor 4, which requires most checkpoints present. | 3 / 5 |
Progressive Disclosure | The body appropriately stays a high-level overview and closes with a well-signaled "Reference Files — Load only what is needed" section, and the three named reference files exist one level deep. However, the referenced `examples/post-acceptance-plan.md` does not exist anywhere in the bundle, three real bundle files (`references/poster-templates/`, `references/presentation-templates/`, `references/promotion-examples/`) are never mentioned in SKILL.md and are undiscoverable, and `references/xquik-promotion.md` points onward to an `MCP_SETUP.md`. These are real organization gaps, not the minor ones of anchor 4 — closer to anchor 3 (references present but the structure has notable problems). | 3 / 5 |
Total | 13 / 20 Passed |