/reimagine-it audit
SkillMediaDesign Health — runs 19 deterministic quality checks on HTML output. Use when the user says /reimagine-it audit, "audit this page", "check design quality", or wants to verify craft-floor compliance before shipping. Catches blank plates, missing focus rings, non-compositor motion, off-palette accents, dead motion, fabricated content. No LLM, no API key. CI-ready with --json and exit codes. Part of the reimagine-it Content-Derived Design suite.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the /reimagine-it audit skill
What this skill tells your AI
The instructions your AI receives, as published by kayforkind/reimagine-it in skills/reimagine-it/audit/SKILL.md and read by ahel’s review.
Parent: ../SKILL.md — the full Content-Derived Design engine. This sub-skill handles only the deterministic quality check.
Runs npx reimagine-it audit — 19 checks across 6 categories (src/audit.js; Python scripts/audit.py is the CI mirror):
| Category | Checks | What it catches |
|---|---|---|
| Typography | 3 | Banned default fonts, type-scale range, measure > 65ch |
| Palette | 3 | Palette drift, transition: all, un-styled ::selection |
| Motion | 4 | Outline removal, missing prefers-reduced-motion, missing :focus-visible, non-compositor animation |
| Content | 4 | Placeholder copy, vibe adjectives, emoji farm, <br><br> spacing |
| Structure | 3 | CDN, external font fetch, figure system doing no work |
| Performance | 2 | Images without dimensions, long pages without content-visibility |
Usage
# Agent
/reimagine-it audit path/to/page.html
# CLI (Node — no Python required)
npx reimagine-it audit gold/webpage/after.html
npx reimagine-it audit gold/webpage/after.html --verbose
npx reimagine-it audit gold/webpage/after.html --json
# CI mirror
python scripts/audit_all.py
Exit codes
| Code | Meaning |
|---|---|
| 0 | CLEAN — no issues |
| 1 | WARNINGS — advisory only, no blockers |
| 2 | FAIL — must fix before shipping |
Procedure
- If the user passed a file path, run
python scripts/audit.py <path>. - If no path, run
python scripts/audit_all.pyto audit all gold files. - Report the verdict with a summary table.
- For each failure, name the specific rule and the fix.
- If
--verbose, show per-category breakdown. - If
--json, output machine-readable JSON for CI.
Must not
- Use an LLM for the check — this is deterministic Python only
- Skip the craft-floor rules (MOT-02, MOT-03 are hard blockers)
- Report "clean" without actually running the script
- Invent checks not in
scripts/audit.py
Signals
- GitHub stars
- 139
- Forks
- 26
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
reimagine-it-audit- Source
- github.com/kayforkind/reimagine-it