Skip to content
Skills Library
AI & agents · Building & coding

a2ui-rendering

/a2ui-rendering

Use when an agent renders rich UI back to a client surface (cards, dashboards, forms, modals) using the A2UI v0.8.0 declarative protocol. Required whenever the response should display structured components rather than plain text, or whenever the validate_and_emit_a2ui tool is in scope.

Licence
Apache-2.0
Last repository change
26.07.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
4
Scripts
1
HTML comments
4
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 26.07.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.
  • SKILL.md zawiera komentarze HTML (4). Nie widać ich w podglądzie Markdown, a model je czyta.

Scripts: tools.py

What it does and when to use it

Use when an agent renders rich UI back to a client surface (cards, dashboards, forms, modals) using the A2UI v0.8.0 declarative protocol. Required whenever the response should display structured components rather than plain text, or whenever the validate_and_emit_a2ui tool is in scope.

Original author description

Use when an agent renders rich UI back to a client surface (cards, dashboards, forms, modals) using the A2UI v0.8.0 declarative protocol. Required whenever the response should display structured components rather than plain text, or whenever the validate_and_emit_a2ui tool is in scope.

How it works

  1. When to Compose A2UI
  2. Workflow
  3. Message Structure
  4. Typed Value Wrappers
  5. Container Children
  6. Component ID Rules
  7. Component Catalog
  8. Examples
Original SKILL.md headings · 110 lines, 493 words
SKILL.md preview
---
name: a2ui-rendering
description: >
  Use when an agent renders rich UI back to a client surface (cards,
  dashboards, forms, modals) using the A2UI v0.8.0 declarative protocol.
  Required whenever the response should display structured components
  rather than plain text, or whenever the validate_and_emit_a2ui tool is
  in scope.
license: Apache-2.0
---

# A2UI Rendering

A2UI is a declarative JSON protocol for delivering rich UI from agents
to client surfaces. UI is composed as a flat list of components where
layout containers reference children by ID. The protocol enforces typed
value wrappers and a fixed catalog of 18 primitives.

## When to Compose A2UI

Compose A2UI **only** in response to a user message that needs rich
visual output. Do not generate A2UI on session creation or
proactively. Plain text remains the default for narrative responses.

## Workflow

```
A2UI Render Progress:
- [ ] Decide what information to present
- [ ] Choose primitives (Text, Card, Column/Row, etc.)
- [ ] Compose the surfaceUpdate JSON with unique component IDs
- [ ] Call validate_and_emit_a2ui with the surfaceUpdate JSON
- [ ] If validation fails, fix the violations and re-validate
- [ ] Compose the beginRendering JSON pointing to the root component
- [ ] Call validate_and_emit_a2ui with the beginRendering JSON
- [ ] Wrap both validated payloads in ```a2ui markdown fences
```

`validate_and_emit_a2ui` MUST be called **twice** per surface: once
for `surfaceUpdate` and once for `beginRendering`. Without
`beginRendering`, the frontend will not render the surface.

<!-- [START a2ui_skill_message_structure] -->
## Message Structure

### surfaceUpdate (defines components)

```json
{
  "surfaceUpdate": {
    "surfaceId": "my-surface",
    "components": [
      {"id": "unique-id", "component": {"TypeName": { ...props }}}
    ]
  }
}
```

- **`surfaceId`**: unique identifier for this UI surface.
- **`components`**: flat array of component definitions (NOT nested trees).
- Each component has **`id`** (unique string) and **`component`**
  (object with exactly one key = the type name).

### beginRendering (tells the frontend which component is root)

```json
{
  "beginRendering": {
    "surfaceId": "my-surface",
    "root": "root-component-id"
  }
}
```

- **`surfaceId`**: must match the surfaceUpdate's surfaceId.
- **`root`**: the `id` of the outermost component (usually a Card).
<!-- [END a2ui_skill_message_structure] -->

<!-- [START a2ui_skill_wrappers] -->
## Typed Value Wrappers

> **CRITICAL**: Never use raw JSON primitives. All values MUST be wrapped.

| Type    | Wrapper                       | Example                               |
|---------|-------------------------------|---------------------------------------|
| String  | `{"literalString": "value"}`  | `"text": {"literalString": "Hello"}`  |
| Number  | `{"literalNumber": 42.0}`     | `"value": {"literalNumber": 3.14}`    |
| Boolean | `{"literalBoolean": true}`    | `"autoplay": {"literalBoolean": true}`|
| Binding | `{"path": "some.data.path"}`  | `"text": {"path": "user.name"}`       |

Raw `"value"`, raw `42`, or raw `true` as property values will be
rejected by `validate_and_emit_a2ui`.
<!-- [END a2ui_skill_wrappers] -->

## Container Children

Layout containers reference children by ID:

- **Multiple children**: `"children": {"explicitList": ["child-id-1", "child-id-2"]}` (NEVER raw arrays)
- **Single child**: `"child": "child-id"` (used by Card, Button)

## Component ID Rules

- IDs **MUST** be unique within a `surfaceUpdate`.
- Use descriptive names: `"title-heading"`, `"main-card"`, `"details-column"`.
- All ID references (`child`, `children.explicitList`,
  `entryPointChild`, `contentChild`, `tabItems[].child`) **MUST**
  resolve to IDs in the same `components` array.

## Component Catalog

For the full catalog of 18 primitives, with required and optional
props plus per-type notes, see [components.md](components.md).

## Examples

For three complete `surfaceUpdate` + `beginRendering` payloads
(simple info card, data list card, dashboard with action button), see
[examples.md](examples.md).
Files in this package (4)
  • SKILL.md 4 KB
  • components.md 3 KB
  • examples.md 3 KB
  • tools.py 14 KB

Versions

The database has no other skills named a2ui-rendering.

Database snapshot: 13.11.2026 · package version 6863ab5f56b7 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100a2ui
    Lets an AI agent describe a user interface as declarative JSON that a client renders with its own trusted components. Use when a user asks to generate forms, cards or dashboards from an agent, wants an agent to return UI instead of text, asks about the A2UI protocol,…
  • 90declarative-agent-manifest-authoring
    Author and review a Microsoft 365 Copilot declarative-agent manifest — pin the schema version (v1.8), keep instructions within the ~8,000-char budget, declare only the needed capabilities, write scope-demonstrating conversation starters, wire API actions, and pass manifest +…
  • 100a2a-protocol
    Reference documentation for the Agent2Agent (A2A) protocol. Use when building A2A servers or clients, configuring Ark A2AServer resources, debugging A2A communication, or answering questions about the A2A specification, Agent Cards, task lifecycle, streaming, extensions, or protocol bindings.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.