Content
92%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.
An exemplary router/overview body: highly actionable with executable code, exact hooks, and a runtime decision tree, plus clean one-level-deep references that keep the body lean. The only real cost is mild duplication of reference-file detail in the architecture diagram and state-access sections, which slightly inflates token spend.
Suggestions
Trim or shrink the ASCII architecture diagram and the State Access / Providing Scopes sections to one-line pointers into ./references/architecture.md, since that file already covers them in depth.
Move version specifics ("0.15.x", "AI SDK v7") out of running prose into a short versioning note so they are easy to spot and update.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with tables, a decision tree, and compact code, with no padding explaining concepts Claude already knows. Not 5 because the ASCII architecture diagram and the State Access / Providing Scopes sections restate detail that lives in ./references/architecture.md and sibling skills, and time-sensitive version specifics ("0.15.x", "AI SDK v7") sit in prose rather than a versioning or deprecation section. | 4 / 5 |
Actionability | The Quick Start is copy-paste-ready TSX, the "Pick a Runtime" tree names the exact hook and package per backend, and commands like "npx assistant-ui@latest create" and "npx assistant-ui@latest add thread" are directly executable. Not 4: the examples cover the common cases completely rather than with minor gaps. | 5 / 5 |
Workflow Clarity | The skill's single task (routing) is unambiguous: the When to Use table, the runtime decision tree, and the per-skill Related Skills list form a clear decision sequence, and "Always consult assistant-ui.com/llms.txt for the latest API" acts as an upfront checkpoint. No destructive or batch operations exist, so no validation cap applies; the simple-skill exception holds. | 5 / 5 |
Progressive Disclosure | The body is a clear overview with a References section that signals the two one-level-deep files with per-file descriptions ("layers, the aui client, data flow, message model"; "every published package and when to install it"), both verified to exist, and detail is appropriately split out of the overview. Not 4: navigation and content placement are clean with no organization gaps. | 5 / 5 |
Total | 19 / 20 Passed |