audit-design-system

SkillMedia

Lets your agent audit code for old UI library usage and migrate imports to a new design system.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the audit-design-system skill

About this capability

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

What this skill tells your AI

The instructions your AI receives, as published by trycompai/comp in .agents/skills/audit-design-system/SKILL.md and read by ahel’s review.

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

Signals

GitHub stars
2k
Forks
412
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
audit-design-system
Source
github.com/trycompai/comp