UI Development
Developmentui-developmentUI Development is an Agent Skill for development published in the redpanda-data/console repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Build UI with Redpanda Registry components, Tailwind v4, and accessibility best practices.
QUICK START
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.
Prompt to paste
Inspect the Agent Skill at https://github.com/redpanda-data/console/blob/HEAD/frontend/.claude/skills/ui-development/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/ui-development, 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.
UI Development
Build user interfaces with the Redpanda UI Registry.
Activation Conditions
- Building/creating UI components or pages
- Keywords: "design system", "ui", "frontend", "registry", "component"
- Modifying existing registry components
Quick Reference
| Action | Rule |
|---|---|
| Use components | use-ui-registry.md |
| Add spacing | style-no-margin-on-registry.md |
| Customize look | style-use-variants.md |
| Use icons | icon-system.md |
Workflow
1. Fetch Documentation
FIRST: Use MCP tool mcp__redpanda-ui__search-docs or mcp__redpanda-ui__get_component
2. Check Existing Components
ls src/components/redpanda-ui/
Critical Rules
ALWAYS
- Use Registry components from
src/components/redpanda-ui/ - Call
mcp__redpanda-ui__get_componentas first action before writing UI code - Install components via CLI
NEVER
- Use
@redpanda-data/ui(deprecated) - see no-legacy - Copy/paste registry source (install via CLI)
- Install external UI libraries without user request
- Use inline
styleprop on registry components - Add margin
classNamedirectly to registry components
WHEN MODIFYING REGISTRY COMPONENTS
If editing files in src/components/redpanda-ui/:
- Document the change in a comment with
// UPSTREAM: <reason> - Keep changes minimal and backwards-compatible
- Track for eventual contribution to upstream registry
Rules
See rules/ directory for detailed guidance.