uidetox 0.1.0__tar.gz

uidetox-0.1.0/AGENTS.md

@@ -0,0 +1,227 @@
+# UIdetox
+
+An agent harness that eliminates "AI slop" from frontend code and enforces quality across frontend, backend, and database layers. It combines design taste enforcement, anti-pattern detection, mechanical linting, and structured remediation into a repeatable scan→fix loop.
+
+UIdetox merges knowledge from three specialized projects:
+- **taste-skill** — Generative design rules, creative arsenal, motion engine
+- **Uncodixfy** — Anti-AI-aesthetic pattern catalog
+- **impeccable** — Design commands, references, and quality workflows
+
+## 1. Philosophy
+
+AI-generated UI has a recognizable aesthetic: Inter font, purple-blue gradients, glassmorphism cards, hero metric dashboards, bounce animations, gray text on colored backgrounds. These patterns emerge because LLMs follow the path of least resistance through their training data.
+
+UIdetox fights that bias. Its instructions teach the agent what NOT to do (anti-patterns), what TO do instead (design engineering), and HOW to apply fixes systematically (the loop).
+
+The goal is frontend code that makes someone ask "how was this made?" — not "which AI made this?"
+
+## 2. The Loop
+
+Run `uidetox scan` on the project. The scan auto-detects tooling (TypeScript, biome/eslint/prettier, backend frameworks, database ORMs, API layers) and guides the agent through four steps:
+
+**Step 1 — Mechanical Checks:** Run `uidetox check` to execute tsc → lint → format in sequence. Errors are automatically queued as T1 issues.
+
+**Step 1.5 — Static Slop Analysis:** A 18-rule deterministic analyzer scans all frontend files for known AI anti-patterns (glassmorphism, purple-blue gradients, bounce animations, oversized shadows, gray-on-color text, missing dark mode, etc.). Detected violations are auto-queued with appropriate tiers.
+
+**Step 2 — Design Audit:** The agent reads frontend files and evaluates against SKILL.md. For each issue found:
+`uidetox add-issue --file <path> --tier <T1-T4> --issue <description> --fix-command <command>`
+
+**Step 3 — Full-Stack Integration:** If backend/database/API layers are detected, the agent checks for DTO mismatches, schema misalignment, missing error states, and type safety gaps across boundaries.
+
+The issues cover:
+- TypeScript compilation errors
+- Lint and formatting violations
+- Anti-pattern detection (AI slop fingerprints)
+- Typography audit
+- Color and contrast review
+- Layout and spacing analysis
+- Motion and interaction quality
+- Responsiveness
+- Accessibility
+- Frontend→Backend→Database integration
+- Code quality
+
+The scan generates a prioritized issue list. Issues are tiered:
+- **T1**: Quick fix (font swap, color replacement, spacing adjustment)
+- **T2**: Targeted refactor (component pattern replacement, state additions)
+- **T3**: Design judgment call (layout restructure, interaction rethinking)
+- **T4**: Major redesign (full section or page overhaul)
+
+### Phase 2: Plan — decide what to fix first
+
+Run `uidetox plan` to view the queue. The recommended fix order:
+
+1. Font swap — biggest instant improvement, lowest risk
+2. Color palette cleanup — remove clashing or oversaturated colors
+3. Hover and active states — makes the interface feel alive
+4. Layout and spacing — proper grid, max-width, consistent padding
+5. Replace generic components — swap cliché patterns for modern alternatives
+6. Add loading, empty, and error states — makes it feel finished
+7. Polish typography scale and spacing — the premium final touch
+
+### Phase 3: Execute — fix issues file by file
+
+Run `uidetox next`. The CLI batches all pending issues for the highest-priority file and injects relevant SKILL.md design rules directly into the output.
+1. Read the file and all issues listed
+2. Follow the injected SKILL.md context rules for each issue type
+3. Fix ALL issues in one pass
+4. Verify the fixes don't break functionality
+5. Run `uidetox resolve <issue_id> --note "what you changed"` for each issue
+6. Run `uidetox next` to loop (self-propagating).
+
+Use the design skills directly from the CLI for targeted work:
+- `uidetox normalize <target>` for design system alignment
+- `uidetox polish <target>` for final quality pass
+- `uidetox animate <target>` for motion work
+- `uidetox colorize <target>` for color introduction
+- `uidetox harden <target>` for edge cases and resilience
+- `uidetox distill <target>` for simplification
+- See full command list below
+
+### Phase 4: Verify — confirm improvement
+
+Run `uidetox rescan` to clear old issues and re-audit the project. `rescan` automatically runs the 18-rule static slop analyzer and queues any detected anti-patterns before the agent begins its fresh design audit. Run `uidetox status` to see your Design Score. The interface should now:
+- Pass the AI Slop Test (no obvious AI tells)
+- Have consistent typography with intentional font choices
+- Use a cohesive, non-generic color palette
+- Have proper interaction states (hover, focus, active, loading, error, empty)
+- Be responsive and accessible
+- Feel designed, not generated
+
+## 3. Skills
+
+The combined SKILL.md contains the full design knowledge base. It is structured as:
+
+| Section | Source | Purpose |
+|---------|--------|---------|
+| Design Direction | impeccable | Bold aesthetic commitment |
+| Design Engineering | taste-skill | Bias-correcting rules (typography, color, layout, materiality, states) |
+| Anti-Pattern Catalog | Uncodixfy + impeccable + taste-skill | Comprehensive list of banned AI UI patterns |
+| Creative Arsenal | taste-skill | Advanced design concepts for premium output |
+| Motion Engine | taste-skill | Perpetual micro-interaction framework |
+| Output Enforcement | taste-skill | Anti-laziness rules for complete code generation |
+| Redesign Protocol | taste-skill | Audit-first upgrade workflow |
+| Color Palettes | Uncodixfy | Curated dark/light color schemes |
+
+Reference files in `reference/` provide deep-dive guidance for each design domain.
+
+## 4. Commands
+
+### Python CLI Commands (the loop engine)
+
+| Command | Purpose |
+|---------|---------|
+| `uidetox setup` | Initialize project config and design dials (use `--auto-commit` to enable Git tracking) |
+| `uidetox scan` | Full audit: auto-detect tooling → static analyzer → design review |
+| `uidetox detect` | Auto-discover linters, formatters, tsc, backend, database, API |
+| `uidetox check` | Run tsc → lint → format in sequence, queue errors as T1 (use `--fix` to auto-solve) |
+| `uidetox tsc` | Run TypeScript compiler, parse and queue errors |
+| `uidetox lint` | Run detected linter (biome/eslint), parse and queue errors |
+| `uidetox format` | Run detected formatter (biome/prettier), auto-fix with --fix |
+| `uidetox add-issue` | Queue a detected issue with tier and fix command |
+| `uidetox plan` | View and reorder the issue queue by priority |
+| `uidetox next` | Batch issues for top-priority file with SKILL.md context injection |
+| `uidetox resolve <id> --note "..."` | Mark an issue as fixed (note is mandatory) |
+| `uidetox loop` | Enter autonomous self-propagation fix loop |
+| `uidetox loop --orchestrator` | Sub-agent mode with auto-parallel (1-5) and memory injection |
+| `uidetox subagent` | Manage sub-agent sessions and generate stage prompts |
+| `uidetox memory` | Read/write persistent agent memory (patterns, notes, reviewed files) |
+| `uidetox history` | View run history and score progression (use `--full` for deep inspection) |
+| `uidetox status` | Health dashboard with Design Score (1-100) (use `--json` for automation) |
+| `uidetox show [pattern]` | Filter/inspect issues by file, tier, or ID |
+| `uidetox autofix` | Batch all safe T1 fixes for the agent to apply (use `--dry-run` to preview only) |
+| `uidetox rescan` | Clear queue, run 18-rule static analyzer, re-audit from scratch |
+| `uidetox exclude <path>` | Skip a directory during scanning |
+| `uidetox review` | Prompt a subjective UX quality review |
+| `uidetox update-skill <agent>` | Install SKILL.md to claude/cursor/gemini/codex |
+| `uidetox viz` | Generate an HTML heatmap of codebase issues |
+| `uidetox tree` | Print a terminal tree of codebase issue density |
+| `uidetox zone` | Show/set/clear file zone classifications (production, test, vendor, etc.) |
+| `uidetox suppress` | Permanently silence issues matching a pattern |
+
+### Slash Commands (design skills — natively executable via CLI)
+
+| Command | Purpose |
+|---------|---------|
+| `uidetox audit [target]` | Technical quality checks (a11y, perf, theming, responsive) |
+| `uidetox critique [target]` | UX design review (hierarchy, emotion, composition) |
+| `uidetox normalize [target]` | Align with design system standards |
+| `uidetox polish [target]` | Final pre-ship quality pass |
+| `uidetox distill [target]` | Strip to essence, remove complexity |
+| `uidetox clarify [target]` | Improve unclear UX copy |
+| `uidetox optimize [target]` | Performance improvements |
+| `uidetox harden [target]` | Error handling, i18n, edge cases |
+| `uidetox animate [target]` | Add purposeful motion |
+| `uidetox colorize [target]` | Introduce strategic color |
+| `uidetox bolder [target]` | Amplify boring designs |
+| `uidetox quieter [target]` | Tone down overly bold designs |
+| `uidetox delight [target]` | Add moments of joy |
+| `uidetox extract [target]` | Pull into reusable components |
+| `uidetox adapt [target]` | Adapt for different devices |
+| `uidetox onboard [target]` | Design onboarding flows |
+
+Slash commands are dynamically loaded from `commands/*.md` and accept an optional target argument (e.g., `uidetox audit src/components/`, `uidetox polish checkout-form`).
+
+## 5. Configuration
+
+The harness supports three design dials that control output aesthetic:
+
+**DESIGN_VARIANCE** (1-10) — How experimental the layout is.
+- 1-3: Clean, centered, standard grids
+- 4-7: Overlapping elements, varied sizes, offset margins
+- 8-10: Asymmetric, masonry, massive whitespace zones
+
+**MOTION_INTENSITY** (1-10) — How much animation.
+- 1-3: CSS hover/active states only
+- 4-7: Fade-ins, smooth transitions, staggered entry
+- 8-10: Scroll-triggered reveals, spring physics, magnetic effects
+
+**VISUAL_DENSITY** (1-10) — How much content per screen.
+- 1-3: Art gallery mode, spacious, luxury feel
+- 4-7: Standard web app spacing
+- 8-10: Cockpit mode, dense data, monospace numbers
+
+Default baseline: `(8, 6, 4)`. Override via `/setup` or direct instruction.
+
+## 6. Provider Installation
+
+UIdetox supports tailored integration with all major AI coding platforms.
+
+Run `uidetox update-skill <agent>` (choices: `claude`, `cursor`, `gemini`, `codex`, `windsurf`, `copilot`) to receive exact configuration instructions and setup commands.
+
+UIdetox reads from its `docs/` catalog to output platform-specific workflows, covering native rules (like `.cursor/rules/`), system memory integrations, and specific prompt structures.
+
+## 7. Repository Structure
+
+```
+UIdetox/
+├── pyproject.toml                # Python packaging
+├── AGENTS.md                     # This file — master agent entry point
+├── SKILL.md                      # Combined design skill (all three repos)
+├── README.md                     # User documentation + quick-start prompt
+├── uidetox/                      # Python CLI package
+│   ├── cli.py                    # Argparse router (30+ commands, dynamic slash-command loading)
+│   ├── state.py                  # Issue queue + config in .uidetox/
+│   ├── tooling.py                # Auto-detection (tsc, biome, eslint, NestJS, etc.)
+│   ├── analyzer.py               # 18-rule static slop detector (deterministic anti-pattern scan)
+│   ├── history.py                # Run snapshot storage and progression tracking
+│   ├── memory.py                 # Persistent agent memory (reviewed files, patterns, notes)
+│   ├── subagent.py               # Sub-agent session infrastructure (5-stage pipeline)
+│   └── commands/                 # Command implementations
+│       ├── scan.py, next.py, resolve.py, plan.py
+│       ├── setup.py, review.py, update_skill.py
+│       ├── status.py, show.py, autofix.py, loop.py
+│       ├── exclude.py, rescan.py, add_issue.py
+│       ├── detect.py, check.py, tsc.py, lint.py, format_cmd.py
+│       ├── subagent_cmd.py, history_cmd.py
+│       ├── memory_cmd.py, skill_cmd.py
+│       ├── viz.py, zone.py, suppress.py
+├── commands/                     # Slash commands (19 total, dynamically loaded by CLI)
+│   ├── scan.md, fix.md, setup.md
+│   ├── audit.md, critique.md, normalize.md, ...
+├── reference/                    # Deep-dive design references
+│   ├── anti-patterns.md, color-palettes.md, creative-arsenal.md
+│   ├── typography.md, color-and-contrast.md, ...
+├── .agents/workflows/
+│   └── detox.md                  # Guided workflow
+```

uidetox-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 artmanuky
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

uidetox-0.1.0/MANIFEST.in

@@ -0,0 +1,12 @@
+include README.md
+include SKILL.md
+include AGENTS.md
+include LICENSE
+recursive-include commands *.md
+recursive-include reference *.md
+recursive-include docs *.md
+
+# Exclude generated directories from package
+prune .uidetox
+prune .claude
+global-exclude *.egg-info

uidetox-0.1.0/PKG-INFO

@@ -0,0 +1,251 @@
+Metadata-Version: 2.4
+Name: uidetox
+Version: 0.1.0
+Summary: Agent harness and CLI to eliminate AI slop from frontend code
+Author: artmanuky
+License: MIT
+Project-URL: Homepage, https://github.com/Naustudents22/UIdetox
+Project-URL: Repository, https://github.com/Naustudents22/UIdetox
+Project-URL: Issues, https://github.com/Naustudents22/UIdetox/issues
+Keywords: code-quality,frontend,design,ai-slop,agent,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyYAML>=6.0
+Dynamic: license-file
+
+# UIdetox
+
+> An agent harness that eliminates "AI slop" from frontend code.
+
+UIdetox gives your AI coding agent the instructions to identify, understand, and systematically fix generic AI-generated UI. It combines design taste enforcement, anti-pattern detection, and structured remediation into a repeatable scan→fix loop.
+
+The goal: frontend code that makes someone ask "how was this made?" — not "which AI made this?"
+
+## For your agent's consideration...
+
+Paste this prompt into your agent:
+
+```
+I want you to eliminate AI slop from this codebase and make the UI indistinguishable from
+hand-crafted design. To do this, install and run UIdetox.
+Run ALL of the following (requires Python 3.11+):
+
+pip install -e .
+uidetox update-skill claude    # installs the full design skill — pick yours: claude, cursor, gemini, codex, windsurf, copilot
+uidetox setup                  # initialize design dials (DESIGN_VARIANCE, MOTION_INTENSITY, VISUAL_DENSITY)
+
+Before scanning, exclude directories that should be skipped (vendor, build output, generated
+code, node_modules, dist) with `uidetox exclude <path>`. Check `uidetox zone show` to verify
+file classifications. Share anything questionable with me before excluding.
+
+uidetox scan --path .
+uidetox next
+
+--path is the directory to scan (use "." for the whole project, or "src/" etc).
+
+Your goal is to get the Design Score as high as possible. The scoring is weighted across
+typography, color, layout, motion, states, accessibility, and full-stack integration — the
+only way to improve it is to actually make the interface better.
+
+THE LOOP: run `next`. It batches all pending issues for the highest-priority file so you fix
+files holistically, not one issue at a time. Each batch includes relevant SKILL.md design
+rules injected automatically — follow them, don't substitute your own analysis. Fix all
+issues in the batch, resolve each with:
+  uidetox resolve <ID> --note "what you changed"
+The --note is mandatory — you must explain what you did. Then run `next` again. Over and over.
+When the queue empties, run `uidetox rescan` to re-audit with fresh eyes. `rescan` runs an
+18-rule static slop analyzer automatically, catching glassmorphism, purple-blue gradients,
+bounce animations, oversized shadows, missing dark mode, generic copy, and more. Keep looping
+until `uidetox status` shows Score >= 95 and zero pending issues. Do NOT stop before that.
+
+For safety during autonomous loops, enable auto-commit:
+  uidetox setup --auto-commit
+This makes every `uidetox resolve` atomically commit the fixed file to git, creating a clean
+patch history you can review or rollback. Highly recommended for orchestrator mode.
+
+Don't be lazy. Large redesigns and small detail fixes — do both with equal energy. No task
+is too big or too small. Replace entire components if they reek of AI slop. Rewrite files
+from scratch if the structure is unsalvageable. Fix things properly, not minimally.
+
+Use `plan` to reorder priorities or cluster related issues. Use `uidetox tree` to see where
+issues concentrate. Use `uidetox viz` to generate a visual heatmap. Rescan periodically.
+
+For targeted design work, use the slash commands directly from the CLI:
+  uidetox polish src/Header.tsx     # final quality pass
+  uidetox audit src/components/     # technical a11y/perf/theming checks
+  uidetox critique src/pages/       # UX design review
+  uidetox harden src/forms/         # error handling, i18n, edge cases
+  uidetox animate src/hero/         # add purposeful motion
+All 16 design skills (audit, critique, normalize, polish, distill, harden, animate, colorize,
+bolder, quieter, delight, extract, adapt, onboard, clarify, optimize) are available as native
+CLI commands. Each loads its full design ruleset and targets the file or directory you specify.
+
+For complex passes, use orchestrator mode: `uidetox loop --orchestrator`. This breaks work
+into five sub-agent stages (observe → diagnose → prioritize → fix → verify), each with an
+isolated prompt generated by `uidetox subagent --stage-prompt <stage>`. The orchestrator
+automatically calculates optimal parallelism (1-5 agents) based on queue spread and injects
+all saved memory context into the bootstrap. Launch sub-agents concurrently. Record
+completions with `uidetox subagent --record`.
+
+The agent memory persists across sessions. Save architectural decisions you discover:
+  uidetox memory pattern "This project uses Radix UI, not shadcn"
+  uidetox memory note "Custom SVG icon set in src/icons/, don't use lucide"
+View memory with `uidetox memory show`. Clear with `uidetox memory clear`. What you learn
+about this codebase stays in `.uidetox/memory.json` and is automatically injected into every
+`uidetox loop` invocation so you never repeat mistakes or revert prior decisions.
+History of every scan lives in `.uidetox/history/`.
+
+If you have access to MCP servers, filesystem tools, or browser automation — use them.
+Read files directly. Run terminal commands. Open the app in a browser and verify visually.
+You are not a chatbot suggesting changes. You are an operator grinding through a queue until
+this codebase is unrecognizable from its AI-generated origin.
+```
+
+## From Vibe Coding to Vibe Design
+
+Vibe coding gets things built fast. But the interfaces it produces have a smell — Inter font, purple-blue gradients, glassmorphism cards, bounce animations, hero metric dashboards. These patterns emerge because LLMs follow the path of least resistance through their training data. The result is an interface that *works*, but screams "AI made this" to anyone who's seen enough of them.
+
+The core bet here is that an LLM with the right constraints can hold a frontend to a standard that used to require a senior designer paying close attention. Not by generating more of the same, but by knowing what *not* to do — and having a systematic loop to enforce it.
+
+UIdetox defines what "designed" looks like as a Design Score worth optimizing. Not a lint score you game by suppressing warnings. Something where improving the number means the interface genuinely got better — better typography, better color, better states, better motion. The anti-slop rules are the difference between a useful signal and a vanity metric.
+
+The hope is that anyone can use AI to build something a seasoned designer would look at and respect. That's the bar.
+
+## Installation
+
+### Cursor
+Copy `AGENTS.md`, `SKILL.md`, `commands/`, and `reference/` into your project root.
+
+> **Note:** Cursor Agent Skills require Nightly channel. Enable in Settings → Beta, then enable Agent Skills in Settings → Rules.
+
+### Claude Code
+```bash
+# Project-specific
+cp AGENTS.md SKILL.md your-project/
+cp -r commands/ reference/ your-project/
+
+# Or copy into .claude/skills/
+mkdir -p your-project/.claude/skills/uidetox
+cp SKILL.md your-project/.claude/skills/uidetox/
+cp -r reference/ your-project/.claude/skills/uidetox/
+```
+
+### Gemini CLI
+```bash
+cp SKILL.md your-project/
+# Reference in GEMINI.md:
+echo '@./SKILL.md' >> your-project/GEMINI.md
+```
+
+### Codex CLI
+```bash
+mkdir -p ~/.codex/skills/uidetox
+cp SKILL.md ~/.codex/skills/uidetox/
+cp -r reference/ ~/.codex/skills/uidetox/
+cp -r commands/ ~/.codex/prompts/
+```
+
+## Commands
+
+### CLI Commands (the loop engine)
+
+| Command | Purpose |
+|---------|---------|
+| `uidetox scan` | Full audit: auto-detect tooling → static analyzer → design review |
+| `uidetox check` | Run tsc → lint → format in sequence, queue errors as T1 (`--fix` to auto-solve) |
+| `uidetox next` | Batch issues for the top-priority file with SKILL.md context injection |
+| `uidetox resolve <id> --note "..."` | Mark an issue as fixed (note is mandatory) |
+| `uidetox loop` | Enter autonomous fix loop until target score is reached |
+| `uidetox loop --orchestrator` | Sub-agent mode with auto-parallel (1-5 agents) and memory injection |
+| `uidetox status` | Health dashboard with Design Score (`--json` for automation payload) |
+| `uidetox plan` | Reorder the issue queue by priority |
+| `uidetox autofix` | Batch-apply all safe T1 quick fixes (`--dry-run` to preview only) |
+| `uidetox memory` | Read/write persistent agent memory (patterns, notes) |
+| `uidetox tree` | Terminal tree of issue density |
+| `uidetox viz` | HTML heatmap of the codebase |
+| `uidetox history` | Score progression across runs (`--full` for details) |
+| `uidetox zone` | Show/set/clear file zone classifications |
+| `uidetox suppress` | Permanently silence false positive patterns |
+| `uidetox subagent` | Manage sub-agent sessions and prompts |
+| `uidetox detect` | Auto-discover linters, formatters, backends, databases, APIs |
+| `uidetox rescan` | Clear queue, run 18-rule static analyzer, re-audit from scratch |
+
+### Slash Commands (design skills)
+
+All slash commands are now **natively executable from the CLI** — no need to read `.md` files manually:
+
+| Command | Purpose |
+|---------|---------|
+| `uidetox audit [target]` | Technical quality checks (a11y, perf, theming, responsive) |
+| `uidetox critique [target]` | UX design review (hierarchy, emotion, composition) |
+| `uidetox normalize [target]` | Align with design system standards |
+| `uidetox polish [target]` | Final pre-ship quality pass |
+| `uidetox distill [target]` | Strip to essence, remove complexity |
+| `uidetox clarify [target]` | Improve unclear UX copy |
+| `uidetox optimize [target]` | Performance improvements |
+| `uidetox harden [target]` | Error handling, i18n, edge cases |
+| `uidetox animate [target]` | Add purposeful motion |
+| `uidetox colorize [target]` | Introduce strategic color |
+| `uidetox bolder [target]` | Amplify boring designs |
+| `uidetox quieter [target]` | Tone down overly bold designs |
+| `uidetox delight [target]` | Add moments of joy |
+| `uidetox extract [target]` | Pull into reusable components |
+| `uidetox adapt [target]` | Adapt for different devices |
+| `uidetox onboard [target]` | Design onboarding flows |
+
+Target can be a file, directory, or component name:
+```
+uidetox audit src/components/
+uidetox polish src/Header.tsx
+uidetox animate src/hero/
+```
+
+## Configuration
+
+Three design dials control output aesthetic (default: 8, 6, 4):
+
+| Dial | Low (1-3) | Mid (4-7) | High (8-10) |
+|------|-----------|-----------|-------------|
+| **DESIGN_VARIANCE** | Clean, centered, standard grids | Overlapping, varied sizes | Asymmetric, masonry, massive whitespace |
+| **MOTION_INTENSITY** | CSS hover/active only | Fade-ins, smooth transitions | Scroll reveals, spring physics, magnetic effects |
+| **VISUAL_DENSITY** | Art gallery, spacious | Standard web app | Cockpit mode, dense data |
+
+Override by editing `SKILL.md` or telling your agent directly: "Set DESIGN_VARIANCE to 3."
+
+## The AI Slop Test
+
+If you showed this interface to someone and said "AI made this," would they believe you immediately? If yes, that's the problem.
+
+UIdetox trains your agent to avoid the telltale patterns:
+- Inter font everywhere
+- Purple-blue gradients
+- Card grids with identical layouts
+- Glassmorphism panels
+- Hero metric dashboards
+- Bounce animations
+- Gray text on colored backgrounds
+- Generic startup copy
+
+## Credits
+
+UIdetox combines knowledge from:
+- [taste-skill](https://github.com/Leonxlnx/taste-skill) by [@lexnlin](https://x.com/lexnlin) — Design dials, creative arsenal, motion engine, output enforcement
+- [Uncodixfy](https://github.com/cyxzdev/Uncodixfy) — Anti-AI-aesthetic pattern catalog, curated color palettes
+- [impeccable](https://github.com/pbakaus/impeccable) by [Paul Bakaus](https://www.paulbakaus.com) — Frontend design skill, 17 commands, domain references
+
+Inspired by [desloppify](https://github.com/peteromallet/desloppify) by Pete O'Mallet.
+
+## License
+
+See individual source repositories for their respective licenses.