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.
The SKILL.md body is a tightly written overview: dense with version-specific, non-inferable API facts, executable code for every common case, symptom-to-fix gotchas, and a clean one-level-deep reference split that keeps deep dives out of the main file. Its only structural weakness is the absence of an explicitly numbered setup workflow for building a runtime from scratch, though the decision guidance and examples make the path largely unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and library-specific: every paragraph carries assistant-ui 0.15 facts Claude cannot know ("As of 0.15, aui.<scope> is a property, not a call", "raw object literals are a type error", "Selecting an unavailable scope no longer throws"), with no filler explaining what React hooks or state management are. Code blocks are minimal and each line demonstrates a rule (e.g., the correct-vs-wrong useAuiState selector pair). It matches the level-5 anchor 'Lean and efficient; assumes Claude's competence; every token earns its place'; level 4's 'minor instances of over-explanation' does not apply because no section restates general knowledge. | 5 / 5 |
Actionability | Guidance is fully executable: copy-paste TSX with imports for useAui ("aui.thread.append({ role: 'user', content: [{ type: 'text', text: 'Hello!' }] })"), useAuiState, useAuiEvent, all three AuiConfig/AuiProvider variants (runtime root, nested extends, isolated extends={null}), and the thread/message operation block ("thread.append", "message.switchToBranch({ position: 'next' })", "editComposer.beginEdit(); editComposer.setText('Updated'); editComposer.send()"). The gotchas map symptoms to concrete fixes. This matches level 5 ('Fully executable; copy-paste ready code or commands; specific examples cover the common cases'); it exceeds level 4 because both the happy paths and the common failure modes are shown as runnable code or exact guards ("if (aui.message.source != null)"). | 5 / 5 |
Workflow Clarity | The content is a reference guide rather than a multi-step procedure, and its structure is coherent: it opens with the build decision ("There are two ways to build one. LocalRuntime ... owns the message store for you ... ExternalStoreRuntime is the inverse"), then reading/driving state, then config mounting, then operations, events, capabilities, and a gotchas section that functions as diagnostic feedback loops ("'Cannot read property of undefined' → Ensure hooks are called inside AssistantRuntimeProvider ... or guard on aui.<scope>.source != null"). That satisfies level 4's 'Clear sequence with most checkpoints present'. It falls short of level 5 because no explicit stepwise creation flow (e.g., a numbered setup sequence from adapter to provider to hooks) is laid out — the path is inferable from the intro and examples but never sequenced. | 4 / 5 |
Progressive Disclosure | The body is a genuine overview with a dedicated References section where each of the seven one-level-deep pointers is annotated ("[./references/local-runtime.md] -- useLocalRuntime deep dive: streaming, tool calls, human-in-the-loop, approval gates, resumeRun"), all of which exist in ./references/, and in-body links route to the right file at the point of need ("See [runtime-concepts.md] ... for the unstable_ policy"). Deep-dive material is correctly kept out of SKILL.md, and Related Skills are listed for the cross-cutting cases. This matches the level-5 anchor ('Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'). | 5 / 5 |
Total | 19 / 20 Passed |