NonGeneric (nongeneric)

The Anti-Generic AI Art Director, UI/UX Architect & GreenSock (GSAP) Motion Choreographer.

Build interfaces around real user tasks, deliberate visual direction, and purposeful motion. NonGeneric combines agent instructions with a local CLI for design seeds, tokens, animation blueprints, and static checks.

MIT license · Contributing · Changelog · Security · Code of conduct

nongeneric is a multi-harness AI agent plugin (Claude Code, OpenAI Codex, Cursor, Universal Agents, GitHub Copilot) and zero-dependency TypeScript CLI engine reverse-engineered via morluto/rea from pbakaus/impeccable and greensock/gsap-skills, fused with Kyaa-A/StockFish (KnightVision) editorial-interactive craft and Kyaa-A/doesntbreak 320px–1440px responsive discipline.

Why nongeneric Exists

Left unguided, LLMs converge on the statistical average of their training corpus:

• Visual Slop: Inter or Roboto, purple-to-indigo gradients (#8b5cf6 → #6366f1), background-clip: text rainbow headings, diffuse neon box-shadow glows, border-l-4 side stripes on rounded cards, and 3-column icon-in-colored-circle grids.
• Copy Slop: Sparkle emojis (✨), "Unleash the power of next-generation seamless workflows", em-dash overuse (—), and "Not a X. A Y." aphoristic tics.
• Motion Slop & Jank: animate-bounce, transition: all, GSAP tweens animating layout-thrashing width/height/top/left, nested ScrollTriggers inside timelines, containerAnimation without ease: "none", React useEffect memory leaks without useGSAP(), and missing prefers-reduced-motion support.
• Responsive Breakage: 100vw horizontal scrollbars, bare 100vh mobile jumps, missing min-width: 0 on flex/grid children, and <16px inputs triggering iOS Safari zoom.

nongeneric replaces template slop with committed Aesthetic Worlds, 4 Visitor Modes, 60fps GSAP Choreography, and a deterministic 82-rule static detector & source auditor.

Quickstart

Requirements

• Node.js 20 or newer.
• npm for development setup or local CLI installation.
• A compatible agent host to use the skills; the CLI also works independently.

The CLI has no runtime npm dependencies. Generated animation code requires GSAP and, for React examples, @gsap/react in the application where you use it.

Restrained interface sample

Open Fieldwork in a browser for two working views: a studio workspace and a reading page. Try project search, view navigation, and the native settings dialog. It uses one system font, shared type roles, quiet colors, and immediate state changes. Serve the repository locally to follow the reference links; GitHub displays the HTML source.

Keeping your installation current

Update notices compare the installed version with main. Changes that exist only on a PR branch are not announced.

• Claude Code / Codex plugins: installations that include our SessionStart hook check GitHub on a new session, at most once per 24 hours. A newer version produces a notice with host-specific update commands. Failed checks stay silent; checks time out after three seconds. Updates are never installed automatically.
• Terminal: from an updated repository checkout, run npm run check:update. This checks immediately and prints either update instructions or that no newer version is available. Network/metadata failures return a readable error and exit status 1. Normal audit/detect output stays unchanged.
• Cursor / copied skill files / older installs without hooks: there is no automatic notice. Repeat your original installation process against the latest repository version; preserve any local customizations first. For a clean Git checkout, use git pull --ff-only, then npm ci && npm run build. For npx usage, run the original GitHub package command again; an already cached copy may need refreshing through your package manager.

Set NONGENERIC_UPDATE_CHECK=0 to disable checks, including the manual checker. The checker sends no project files or usage data; it fetches only the public version manifest. How the session notice is displayed depends on the host. Copied files cannot retroactively acquire an update hook.

1. Run the CLI Instantly or Install the Skill Pack

# Run a static audit on any project without cloning (Node 20+)
npx --yes github:Kyaa-A/nongeneric audit ./src

# Claude Code plugin install
/plugin marketplace add Kyaa-A/nongeneric
/plugin install nongeneric@nongeneric

# Local checkout for Universal / Codex / Cursor / Antigravity
git clone https://github.com/Kyaa-A/nongeneric.git
cd nongeneric
npm ci
npm run build
node scripts/nongeneric.js doctor

Cloning makes the source available; it does not automatically activate skills in your agent host. The canonical entry point is skills/nongeneric/SKILL.md, with host manifests in .claude-plugin/, .codex-plugin/, and .cursor-plugin/. Configure your host to load the skill/plugin using its installation mechanism.

The relative commands below run from this repository root. From a different application directory, use the absolute path to this checkout's scripts/nongeneric.js, or run npm link in this checkout and use nongeneric:

# After npm link, run from the application you want to inspect:
nongeneric audit ./src

Example agent request: “Use NonGeneric to improve this booking flow. Preserve the brand, cover loading/error/recovery states, and verify the result in the browser.”

2. CLI Commands (node scripts/nongeneric.js)

# 1. Roll an offline-first Concept Seed, Challenger Worlds & Structural Compositions
node scripts/nongeneric.js seed --scope direction --mode persuade --grain product

# 2. Export OKLCH Design Tokens & Fluid Clamp Typography Scale (css | json | tailwind)
node scripts/nongeneric.js tokens --world knightvision-editorial-telemetry --format css

# 3. Generate Cleanup-Safe, Reduced-Motion-Safe GSAP Choreography Blueprints
node scripts/nongeneric.js motion-plan --pattern hero-reveal --framework react --world knightvision-editorial-telemetry

# 4. Scan Files or Directories with the 82-Rule Anti-Slop, Motion & Responsive Detector
node scripts/nongeneric.js detect src/ examples/crafted-knightvision.html

# 5. Run a 0-100 Static-Check Audit with Prioritized P0-P3 Remediation Plan
node scripts/nongeneric.js audit examples/crafted-knightvision.html

# 6. Inspect All 82 Rules or Curated Aesthetic Worlds
node scripts/nongeneric.js rules
node scripts/nongeneric.js worlds

Restrained Design and Typography

Clean interfaces can be distinctive through composition, consistent text roles, and precise feedback. The restrained-design guide selectively adapts Emil Kowalski's skills, with pinned provenance and the upstream MIT notice. It makes intentional stillness and a single-family type system valid choices, while retaining GSAP for motion that serves the task. Awwwards references help study visual craft; they do not certify usability or promise awards.

UX and Verification Workflow

Start with the Interaction Pattern Library when deciding between a modal, side panel, sidebar, popover, menu, tooltip, inline disclosure, toast, banner, or full page. It includes selection trade-offs, keyboard/focus and mobile behavior, acceptance checks, and links to live examples from open-source design systems.

Before styling, define the primary task, user flow, information hierarchy, and applicable loading, empty, success, error, and recovery states using the UX workflow.

Before claiming a surface is verified, follow the browser verification protocol: inspect rendered layouts, complete the task and a recovery path, and check keyboard access, reduced motion, and runtime behavior. Report tested scope and unavailable evidence explicitly.

The CLI audit score measures recognized source patterns only. Even an empty-body HTML page can score 100 when no patterns are detected; that is not a design-quality certificate. JSON exposes scoreKind: "static-checks" and separate verification fields marked not-verified. With no supported files, audit returns null score/grade and exit code 1. Browser evidence belongs in a separate review report.

The 4 Visitor Modes

Curated Aesthetic Worlds (Offline-First Catalog)

16 Slash Commands

Documentation, Expansion Packs & Reverse-Engineering Ledger

Core Documentation

• REA Reverse-Engineering Evidence Ledger
• NonGeneric System Architecture
• Main Skill Playbook
• GSAP Mastery Manual
• 82-Rule Anti-Slop Catalog

Expansion World Packs (packs/worlds/ & packs/index.mjs)

• broadcast-kinetic — High-velocity motorsport/esports broadcast telemetry (Showcase)
• monastic-washi — Monastic Washi & Sumi Ink editorial monograph (Showcase)
• avionics-cnc — Anodized CNC & flight-deck avionics console (Showcase)
• bauhaus-constructivist — Bauhaus Dessau & constructivist exhibition archive (Showcase)
• botanical-herbarium — Archival botanical herbarium & natural history (Showcase)
• fintech-ledger — Institutional ledger & high-density financial telemetry
• artifact-workbench — Spatial AI artifact workbench & provenance canvas
• atelier-lookbook — Independent luxury atelier & tactile lookbook

GSAP Motion Choreography Suites (packs/motion/ & docs/playbooks/)

• svg-choreography — DrawSVG, MorphSVG, and orbital MotionPath (Playbook)
• gesture-physics — Observer, Draggable, and WCAG keyboard parity (Playbook)
• velocity-marquee — Seamless xPercent loops & clamped scroll-velocity skew (Playbook)
• shader-stage-bridge — GSAP-to-WebGL/Three.js uniform proxy bridge (Playbook)
• text-scramble-telemetry — Screen-reader-safe cipher glyph decode & odometer rolls (Playbook)
• flip-shared-element — Shared-element Flip card-to-dossier & lightbox transitions (Playbook)

Domain Anti-Slop Playbooks (docs/playbooks/)

• Fintech, Trading & Telemetry Consoles
• AI-Native Workspaces (Anti-Chat-Bubble Slop)
• Luxury & Independent Editorial Commerce
• Creative Coding, WebGL & Shader Stages

Development and Support

Read CONTRIBUTING.md for setup, source/generated-file conventions, and pull request expectations. Required checks:

npm run build
npm run typecheck
npm run check:generated
npm run check:json
npm test

Use GitHub Issues for bugs, usage questions, and feature requests. Include the command or prompt, version/commit, and a small reproduction. Report vulnerabilities through SECURITY.md.

Troubleshooting

• Cannot find scripts/nongeneric.js: run from this checkout, use an absolute script path, or use the linked CLI.
• Generated files are out of date: run npm run build and include the generated changes.
• Audit says NOT SCORED: check that the target exists and contains supported source files.
• High static score but a broken interface: run the browser verification protocol; static checks do not execute the interface.

License and Acknowledgments

This repository is licensed under the MIT License, copyright © 2026 Asnari Pacalna (Kyaa-A).

The project draws on the projects credited above; see the evidence ledger for provenance. External libraries, fonts, assets, and referenced projects retain their respective licenses. The repository's MIT license does not relicense those materials.