Uncodixify

Attribution: this package builds on the original Uncodixfy work by cyxzdev at cyxzdev/Uncodixfy.

Portable skill package for constraining React and Tailwind UI away from generic AI-dashboard styling.

This package is designed to be copied between projects as a single folder. It includes:

• the skill prompt in SKILL.md
• the longer design reference in manifesto.md
• a deterministic validator in toolchain/uncodixify.ts
• a deterministic autofix pass in toolchain/autofix-uncodixify.ts
• isolated eval fixtures and assertions in evals/
• package-local CLI entrypoints in bin/

What It Enforces

The package pushes UI toward restrained, product-shaped layouts and away from common AI-generated defaults.

Core constraints:

• dark neutral surfaces
• restrained corner radius
• subtle white separators
• no purple utility classes
• no gradients or glassmorphism
• no eyebrow-label patterns like ``
• no ornamental dashboard hero copy in the bundled eval scenarios

Package Layout

uncodixify/
├── SKILL.md
├── README.md
├── manifesto.md
├── package.json
├── bin/
│   ├── run-uncodixify.sh
│   ├── validate-package.py
│   ├── run-evals.py
│   ├── grade-evals.py
│   └── run-package-evals.py
├── toolchain/
│   ├── uncodixify.ts
│   └── autofix-uncodixify.ts
├── evals/
│   ├── evals.json
│   └── files/
└── workspace/
    └── .gitignore

workspace/ is intentionally included but git-ignored for iteration outputs.

Requirements

• Node.js with npx
• Python 3
• tsx available through local dependencies or npx

This package ships its own package.json with tsx and typescript as dev dependencies.

Install

If you copy this folder into another repo, install dependencies from inside the package:

npm install

Validate The Package

Run this from inside the package directory:

python3 ./bin/validate-package.py

This checks:

• SKILL.md frontmatter shape
• evals/evals.json schema
• assertion definitions
• workspace scaffolding

Validate A Single File

To check one TSX file against the uncodixify rules:

./bin/run-uncodixify.sh path/to/component.tsx

Exit codes:

• 0: file passes
• 1: one or more violations were found

The validator is deterministic and regex-based. It does not rely on external APIs.

Autofix A File

The package autofix script normalizes class tokens and removes the banned patterns it knows how to rewrite safely.

npx tsx ./toolchain/autofix-uncodixify.ts path/to/component.tsx

What the autofix currently does:

• rewrites oversized radius classes to rounded-md
• removes gradient and glassmorphism utilities
• rewrites purple utility classes to neutral alternatives
• removes uppercase tracking-eyebrow utility patterns
• replaces with
• injects dark base and separator classes when missing