# Source Command Audit

> Check existing code against your design system for spacing, depth, color, and pattern violations.

- Skill: `tangchunwu/source-command-audit` (Agent Skill)
- Install (CLI): `npx skillmds add tangchunwu/source-command-audit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tangchunwu/source-command-audit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Design & Media
- Author: tangchunwu (https://skillmd.com/u/tangchunwu)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/tangchunwu/source-command-audit

---


# source-command-audit

Use this skill when the user asks to run the migrated source command `audit`.

## Command Template

# interface-design audit

Check existing code against your design system.

## Usage

```
/audit <path>     # Audit specific file/directory
/audit            # Audit common UI paths
```

## What to Check

**If `.interface-design/system.md` exists:**

1. **Spacing violations**
   - Find spacing values not on defined grid
   - Example: 17px when base is 4px

2. **Depth violations**
   - Borders-only system → flag shadows
   - Subtle system → flag layered shadows
   - Allow ring shadows (0 0 0 1px)

3. **Color violations**
   - If palette defined → flag colors not in palette
   - Allow semantic grays

4. **Pattern drift**
   - Find buttons not matching Button pattern
   - Find cards not matching Card pattern

**Report format:**
```
Audit Results: src/components/

Violations:
  Button.tsx:12 - Height 38px (pattern: 36px)
  Card.tsx:8 - Shadow used (system: borders-only)
  Input.tsx:20 - Spacing 14px (grid: 4px, nearest: 12px or 16px)

Suggestions:
  - Update Button height to match pattern
  - Replace shadow with border
  - Adjust spacing to grid
```

**If no system.md:**

```
No design system to audit against.

Create a system first:
1. Build UI → establish system automatically
2. Run /extract → create system from existing code
```

## Implementation

1. Check for system.md
2. Parse system rules
3. Read target files (tsx, jsx, css, scss)
4. Compare against rules
5. Report violations with suggestions