Phoenix Design
Designphoenix-designPhoenix Design is an Agent Skill for design published in the Arize-ai/phoenix repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Design system conventions for the Phoenix frontend — layout, dialogs, error display, BEM CSS class naming, and CSS design tokens. Use when building UI, naming CSS classes, creating or consuming tokens, handling errors, or designing dialog interactions in app/src/.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/Arize-ai/phoenix/blob/HEAD/.agents/skills/phoenix-design/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/phoenix-design, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Phoenix Design System
The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this specification are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.
What Are You Doing?
Read the relevant reference(s) based on the task:
| Task | Reference |
|---|---|
| Layout stability, scroll behavior, interaction patterns | references/layout.md |
| Alert and form dialog usage, footer button styling, content writing | references/dialogs.md |
| Error scoping, inline alerts, input validation | references/error-display.md |
| Naming CSS classes | references/bem.md |
| Creating or consuming CSS design tokens | references/tokens.md |
| Picking an icon for a noun (project, trace, span, file, etc.) | references/icons.md |
| Displaying counts in tabs, headings, or filter buttons | references/counters.md |
Choosing or adding an EmptyStateGraphic variant (the per-region/topic empty-state graphics) | references/empty-states.md |