qualia-polish

Detect and remove AI-generated UI patterns while enforcing design standards.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Qualiasolutions/qualia-framework --skill qualia-polish
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qualia-polish
Source: https://github.com/Qualiasolutions/qualia-framework/tree/main/skills/qualia-polish
Command: npx skills add https://github.com/Qualiasolutions/qualia-framework --skill qualia-polish

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Qualia-polish removes AI-generated UI artifacts and enforces a coherent, human-crafted design system so products feel intentionally designed rather than templated. It targets visual sameness, scattered styles, poor accessibility, and missing interactive states that degrade user trust and usability.

Core Features & Use Cases

  • AI Slop Detection: Run deterministic grep-based checks to find generic fonts, repetitive card grids, blue-purple gradients, hardcoded widths, and other common AI-generated patterns.
  • Typography, Color & Layout Passes: Establish hierarchy, fluid type scaling, a single source of color tokens, layered surfaces, and responsive full-width layouts.
  • Interaction, Motion & Accessibility: Add hover/focus states, loading skeletons, reduced-motion fallbacks, semantic HTML, and WCAG checks.
  • Harden & Verify: Read DESIGN.md when present, run TypeScript checks, produce a single commit, and transition the project state to polished.
  • Use Case: Run after the verify phase to convert a verified feature release into a production-quality UI that meets brand, accessibility, and responsive requirements.

Quick Start

Run the design polish pass on the current project to remove AI-generated artifacts and enforce typography, color, interaction, and accessibility standards.

Frequently Asked Questions about qualia-polish

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I remove AI-generated UI patterns from a frontend codebase?

Remove AI-generated UI patterns using deterministic grep-based checks to detect generic fonts, repetitive card grids, and blue-purple gradients, then enforce design standards for typography and color. This process cleans templated artifacts and establishes a coherent, human-crafted design system.

What is the best way to enforce accessibility and WCAG standards in an existing web project?

Enforce accessibility standards by adding semantic HTML, hover and focus states, and reduced-motion fallbacks, then run WCAG checks. This ensures the web project meets accessibility requirements and hardens interactive states for user usability and trust.

How do I fix scattered CSS and Tailwind conventions during a design polish pass?

Fix scattered styles by enforcing CSS and Tailwind conventions, establishing a single source of color tokens, and applying fluid type scaling. This creates a unified visual hierarchy and removes hardcoded widths from the frontend repository.

Can I use a DESIGN.md file to apply custom design standards to my repository?

Yes, you can use a DESIGN.md file to apply custom design standards. The polish pass reads the DESIGN.md specification when present, enforcing its rules alongside static detectors to ensure the UI meets your specific brand and responsive requirements.

When do I need to run a post-verification design pass on my web application?

Run a post-verification design pass after the verify phase to convert a verified feature release into a production-quality UI. This is when you fix layout, motion, and typography issues, transitioning the project state to polished.

Does this UI polish process run TypeScript checks before committing changes?

Yes, the UI polish process runs TypeScript checks to harden the codebase before producing a single commit. It combines these type checks with static grep detectors to ensure the final commit marks the project as polished without breaking types.