Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, actionable router skill that sequences routing decisions with explicit checkpoints and delegates detail to loaded-on-demand sibling skills. The main drag is conciseness — the 'Keeping skills current' section and some disambiguation prose carry explanatory padding.
Suggestions
Tighten the 'Keeping skills current' paragraph to the commands and their one-line effect; drop the network-hiccup and no-op rationale that explains behavior Claude can infer.
Consider moving the '--skip-skills neutered' aside and CI escape-hatch into a footnote or removing it, since it is operational minutiae that competes with routing context.
De-duplicate the disambiguation bullets that restate cheat-sheet rows (e.g. the product-vs-site and footage cases) to keep the routing section lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and avoids explaining known concepts, but contains padded passages (the 'Keeping skills current' paragraph — 'so a freshly init'd project always has the complete, latest set... so init never hard-fails on a network hiccup' and the '--skip-skills flag is currently neutered' aside) and some redundant disambiguation prose that could be tightened. | 2 / 3 |
Actionability | Provides concrete executable commands ('npx skills add heygen-com/hyperframes --skill <workflow-name>', 'npx hyperframes skills check --json', 'npx hyperframes skills update') plus per-workflow concrete Input/Output/Triggers, giving copy-paste-ready routing guidance. | 3 / 3 |
Workflow Clarity | The routing process is clearly sequenced with explicit checkpoints: confirm input before routing ('ask before entering any workflow'), disambiguate when unclear ('ask one question'), and verify the workflow is installed ('check it's actually available to you' → install → re-read). | 3 / 3 |
Progressive Disclosure | Acts as a lean overview/router that points one level deep to on-demand domain skills ('/hyperframes-core', '/hyperframes-animation', etc.) and workflows, each clearly signaled; no bundle files exist, and the inline workflow details are summaries rather than full workflows. | 3 / 3 |
Total | 11 / 12 Passed |