Skip to content

Add plex-ui skill to .curated catalog#352

Open
stomashevsky wants to merge 1 commit intoopenai:mainfrom
stomashevsky:add-plex-ui-skill
Open

Add plex-ui skill to .curated catalog#352
stomashevsky wants to merge 1 commit intoopenai:mainfrom
stomashevsky:add-plex-ui-skill

Conversation

@stomashevsky
Copy link
Copy Markdown

What

Adds a new curated skill for Plex UI — a production-grade React component library and Figma design system.

Upstream source of truth: https://github.com/plex-ui/docs/tree/master/skills/plexui/skills/plex-ui

Why

Plex UI is a large, opinionated component library (35+ components, 14 hooks, 22k+ Figma variants, a three-layer token system, a unified 9-step size scale). Without a skill, LLMs consistently guess wrong API shapes — raw Tailwind colors instead of semantic color props, wrong size values, root imports instead of subpath imports, etc. This skill encodes the right conventions.

What's in the skill

  • SKILL.md — imports, size scale (3xs3xl), semantic colors, variants, dark mode via light-dark(), 460+ icons
  • agents/openai.yaml — Codex UI metadata (display name, SVG + PNG icons, brand color, default prompt, implicit invocation policy)
  • rules/components.md, rules/styling.md, rules/icons.md — detailed reference files linked from SKILL.md
  • assets/icon.svg + assets/icon.png — Plex UI logo
  • LICENSE.txt — MIT (same as @plexui/ui)

Invocation

Auto-triggers when Codex sees @plexui/ui imports or Plex UI components in the codebase.

Maintainer

Plex UI is a production-grade React component library and Figma design
system (https://plexui.com) with 35+ components, 14 hooks, 22k+ Figma
variants, a three-layer token system, and a unified 9-step size scale.

This skill teaches the agent Plex UI's conventions:
- Subpath imports (@plexui/ui/components/Button, never package root)
- Unified size prop (3xs–3xl) across all controls
- Semantic color props (primary, danger, success, warning, info…)
- Variant props (solid, soft, outline, ghost, surface)
- Automatic dark mode via CSS light-dark() — no dark: prefixes
- 460+ Icon subpath imports with auto-sizing inside components

agents/openai.yaml supplies Codex UI metadata (display name, icons,
brand color, default prompt, implicit invocation policy). Additional
reference files in rules/ cover component composition, styling tokens,
and icon usage.

Upstream source of truth:
  https://github.com/plex-ui/docs/tree/master/skills/plexui/skills/plex-ui
@stomashevsky stomashevsky requested a review from a team April 16, 2026 08:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant