Skip to main content

audit-design-system

Audit & fix design system usage — migrate @trycompai/ui and lucide-react to @trycompai/design-system

Source facts

Repository
trycompai/comp
Last source activity
April 27, 2026 at 13:56
Detected SKILL.md language
English
Stars
2,074
Forks
441

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
audit-design-system
description
Audit & fix design system usage — migrate @trycompai/ui and lucide-react to @trycompai/design-system
Audit the specified files for design system compliance. **Fix every issue found immediately.** ## Rules 1. **`@trycompai/design-system`** is the primary component library. `@trycompai/ui` is legacy — only use as last resort when no DS equivalent exists. 2. **Always check DS exports first** before reaching for `@trycompai/ui`. Run `node -e "console.log(Object.keys(require('@trycompai/design-system')))"` to check. 3. **Icons**: Use `@trycompai/design-system/icons` (Carbon icons), NOT `lucide-react`. Check with `node -e "const i = require('@trycompai/design-system/icons'); console.log(Object.keys(i).filter(k => k.match(/YourSearch/i)))"`. 4. **DS components that do NOT accept `className`**: `Text`, `Stack`, `HStack`, `Badge`, `Button` — wrap in `<div>` for custom styling. 5. **Button**: Use DS `Button` with `loading`, `iconLeft`, `iconRight` props instead of manually rendering spinners/icons. 6. **Layout**: Use `PageLayout`, `PageHeader`, `Stack`, `HStack`, `Section`, `SettingGroup`. 7. **Patterns**: Sheet (`Sheet > SheetContent > SheetHeader + SheetBody`), Drawer, Collapsible. ## Process 1. Read files specified in `$ARGUMENTS` 2. Find `@trycompai/ui` imports — check if DS equivalent exists 3. Find `lucide-react` imports — find matching Carbon icons 4. Migrate components and icons 5. Run build to verify: `bunx turbo run typecheck --filter=@trycompai/app`
View on GitHub