Content
93%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 dense, expert-level reference skill: executable commands and code, only genuinely novel information, well-signaled one-level-deep references verified against the actual bundle, and a strong troubleshooting section. The only relative weakness is workflow sequencing — the flow is implied by section order and error recovery is reactive via gotchas rather than explicit validation checkpoints in the install/customize path.
Suggestions
Add a brief numbered install sequence with an explicit verification step (e.g., after `add`, check that `components/assistant-ui/elements/<name>.aui.tsx` exists and the import resolves) so the install workflow has a proactive checkpoint rather than only reactive gotchas.
State the decision path explicitly at the top of the 'Two kinds of element' section (runtime data present → `.aui`, own state/tool result/mock → standalone) as a one-line rule before the table, making the routing decision unambiguous on first read.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section carries domain-specific facts Claude cannot know (the `.aui` suffix convention, registry item naming, Radix vs Base UI flavor rules, inline CSS variables on `ThreadPrimitive.Root`, surface tokens) with no padding and no explanation of concepts Claude already knows. Matches the 5 anchor 'every token earns its place'; the 4 anchor's 'minor instances of over-explanation' are absent. | 5 / 5 |
Actionability | Copy-paste-ready bash (`npx assistant-ui@latest add thread thread-list`), a complete runnable TSX example including the provider setup, the exact JSON registry block, and concrete gotcha fixes like "Fix the style, then re-add with `--overwrite`". Fully executable guidance covering the common cases, matching the 5 anchor. | 5 / 5 |
Workflow Clarity | The install → use → customize → troubleshoot flow is coherent and the Common Gotchas section provides explicit error-recovery feedback (symptom → cause → fix), and the non-destructive nature means the validation cap does not apply. However, the steps are conveyed through section order rather than an explicit sequence, and validation checkpoints (e.g., verifying an install succeeded or the element renders) are implicit — matching the 4 anchor 'most checkpoints present; minor validation gaps' rather than the 5 anchor's explicit validation steps. | 4 / 5 |
Progressive Disclosure | A dedicated References section signals three real one-level-deep files, each with a stated purpose (verified on disk: catalog.md is the per-element table, aui-elements.md and standalone-elements.md the two element kinds), the body keeps only key examples inline, and Related Skills link outward. This matches the 5 anchor's clear overview with well-signaled single-level references; the reference files link only to external docs and internal anchors, not to further nested local files, so it does not fall to 4. | 5 / 5 |
Total | 19 / 20 Passed |