CtrlK
BlogDocsLog inGet started
Tessl Logo

assistant-ui-elements

Installs and customizes assistant-ui elements, the styled shadcn-style component catalog served from the r.assistant-ui.com registry through `npx assistant-ui@latest add <item>`. Use when adding a prebuilt chat surface or widget (Thread, ThreadList, AssistantModal, AssistantSidebar, ToolFallback, ToolGroup, MarkdownText, Reasoning, Sources, Attachment, ModelSelector, Voice orb, McpConfig) or one of the 120 standalone elements (approval card, agent plan, code diff, data table, chart, and so on), choosing between runtime-connected `<name>.aui.tsx` files and props-driven standalone files, overriding Thread slots through the `components` prop, editing the copied source under `components/assistant-ui/elements/`, or picking the Radix versus Base UI flavor in `components.json`. Route here when an import from `@/components/assistant-ui/...` fails, an element renders unstyled, or the CLI installs the wrong flavor. For unstyled building blocks use primitives; for the CLI scaffold itself use setup.

76

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

93%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: concrete actions with commands and paths, explicit 'Use when' and 'Route here when' triggers including failure symptoms, and explicit disambiguation from sibling skills. It is long but dense rather than padded — every clause carries trigger or capability information.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with exact commands, props, and paths — "Installs and customizes assistant-ui elements… through `npx assistant-ui@latest add <item>`", "overriding Thread slots through the `components` prop", "editing the copied source under `components/assistant-ui/elements/`", "picking the Radix versus Base UI flavor in `components.json`" — matching the comprehensive multi-action anchor. It is dense rather than padded, so it does not fall to the 4 anchor, which requires minor gaps in coverage.

5 / 5

Completeness

Both what and when are explicit with concrete trigger phrases: "Use when adding a prebuilt chat surface or widget (Thread, ThreadList, AssistantModal…)" and "Route here when an import… fails, an element renders unstyled, or the CLI installs the wrong flavor." This is exactly the 5 anchor; the 4 anchor requires a less-explicit 'when', which does not apply.

5 / 5

Trigger Term Quality

Natural terms users would say are comprehensively covered: element names ("Thread, AssistantModal, approval card, agent plan, code diff"), file extensions/paths ("`<name>.aui.tsx`", "components.json"), and error-state triggers ("an import from `@/components/assistant-ui/...` fails, an element renders unstyled"). This matches the 5 anchor including synonyms and extensions; nothing common is missing, so it does not drop to 4.

5 / 5

Distinctiveness Conflict Risk

The niche is distinct (the styled element catalog, specifically) and it explicitly routes conflicts away: "For unstyled building blocks use primitives; for the CLI scaffold itself use setup." Minimal conflict risk, matching the 5 anchor; the 4 anchor's 'minor overlap risk with closely related skills' is already addressed by the explicit sibling routing.

5 / 5

Total

20

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 7 suspicious

Warning

Total

15

/

16

Passed

Repository
stevenknowswhy/ProfessionalBuyer
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.