assistant-ui-primitives

What problem does it solve?

This Skill helps you customize Assistant UI chat experiences by providing composable, unstyled UI primitives for threads, message rendering, and the message composer—so you can implement your own design system without rewriting the core UI logic.

Core Features & Use Cases

• ThreadPrimitive for chat structure: Render the entire conversation container, message viewport, empty state, and “scroll to bottom” behavior.
• MessagePrimitive for message bodies: Render message content parts (text, images, tool calls, reasoning, sources/files) and handle conditional UI for branching and errors.
• ComposerPrimitive for message input: Provide a structured input form with send/cancel controls plus attachment and dictation support.
• ActionBarPrimitive for per-message actions: Add message-level controls like copy, edit, regenerate, speak, feedback, and markdown export while keeping UI behavior consistent.
• Use case: When you’re integrating AGH-backed chat into your product and need an opinionated, branded UI, you can use these primitives as the foundation and wire them into your app’s styling and components.

Quick Start

Implement your chat layout by composing ThreadPrimitive.Root with ThreadPrimitive.Viewport and ThreadPrimitive.Messages, then render custom UserMessage and AssistantMessage components using MessagePrimitive.Content and MessagePrimitive.Error.