# impeccable-audit

impeccable-audit is a Claude Code skill that reviews Mikka interfaces for UX resilience and visual clarity. It audits screens, responsive behavior, accessibility and interface states.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 88 repo stars
- Author: alexj11324
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/alexj11324/Mikka/tree/HEAD/.claude/skills/impeccable-audit/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/impeccable-audit

## What it does

impeccable-audit turns an interface review of Mikka into actionable, evidence-backed findings. It checks visual hierarchy and navigation, dialog placement, keyboard focus, touch targets and responsive panes. The review also covers long localized text, theme contrast, motion, and loading, error and recovery states. Behavior comes before cosmetic alignment.

The audit draws on `docs/design/README.md`, `docs/design/rules.md`, `docs/design/components.md`, an accepted Figma design and the running official UI. Each finding names a screen or route and includes evidence from exact input, a screenshot or the accessibility tree, plus severity, impact, the component responsible for the fix and a regression plan. Findings based only on source code or an old screenshot are marked unverified. The skill does not authorize speculative full-screen redesigns or changes to the supplied internals of BoardUI Pro, affectUI or beUI Pro.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill impeccable-audit -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/impeccable-audit/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/impeccable-audit/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill impeccable-audit -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/impeccable-audit/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill impeccable-audit -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/impeccable-audit/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install alexj11324/Mikka .claude/skills/impeccable-audit
```

2. **Manually: put the files in place**
- File: `.github/skills/impeccable-audit/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill impeccable-audit -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/alexj11324/Mikka --path .claude/skills/impeccable-audit
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/impeccable-audit/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/alexj11324/Mikka/tree/HEAD/.claude/skills/impeccable-audit/SKILL.md

## When to use it
- spot weak visual hierarchy and hidden navigation affordances
- check focus, touch targets and responsive panes
- find issues with long localized text and theme contrast
- record defects with evidence and regression steps

## Example prompts
- Audit the Mikka settings screen for navigation, focus and responsive issues.
- Review this route for dialog placement, contrast and error-state problems.
- Document the findings with evidence, severity and a regression plan.

## Similar
- [ux-audit](https://affpapa.org/en/nevibecode/skills/ux-audit.md) — skill · 3100 installs
- [impeccable-design-polish](https://affpapa.org/en/nevibecode/skills/impeccable-design-polish.md) — skill · 2800 installs
- [impeccable](https://affpapa.org/en/nevibecode/skills/typeuish-impeccable.md) — skill · 2700 installs
- [competitor-experience-audit](https://affpapa.org/en/nevibecode/skills/competitor-experience-audit.md) — skill · 305 installs
- [wcag-audit-patterns](https://affpapa.org/en/nevibecode/skills/wcag-audit-patterns.md) — skill · 12486 installs
- [accessibility-audit](https://affpapa.org/en/nevibecode/skills/accessibility-audit.md) — skill · 2600 installs

From the same set: [alexj11324/mikka](https://affpapa.org/en/nevibecode/by/alexj11324/mikka.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
