👑 NT-SKILL SUPREME

es Español | us English

The Master AI Skill Framework providing end-to-end full-stack software architecture, type-safety, automated testing directives, OWASP security hardening, micro-interactions, and rapid agency web & app production across all modern AI platforms.

🌟 View Interactive Demo (DentalCare Pro)

---

⚡ Multi-AI Safe CLI Installation

Install NT-SKILL SUPREME safely across all your AI assistants using our atomic, manifest-driven CLI installer:

🌟 Universal Auto-Detection (Safe Default)

Automatically scans your system for active AI environment signatures and installs only to detected platforms:

npx nt-skill-supreme init

🎯 Targeted Platform Commands

Target AI Assistant	Terminal Command	Installation Route
Google Gemini Antigravity	npx nt-skill-supreme init --ai antigravity	~/.gemini/config/skills/nt-skill-supreme
Claude Code & Desktop	npx nt-skill-supreme init --ai claude	~/.claude/skills/nt-skill-supreme
Cursor Editor	npx nt-skill-supreme init --ai cursor	.cursor/rules/nt-skill-supreme.mdc
Windsurf IDE	npx nt-skill-supreme init --ai windsurf	.windsurfrules
Trae IDE	npx nt-skill-supreme init --ai trae	AGENTS.md
Codex CLI	npx nt-skill-supreme init --ai codex	.codex/rules/AGENTS.md
OpenCode	npx nt-skill-supreme init --ai opencode	AGENTS.md

🛡️ Safety Flags & Management Commands

• Dry Run Simulation (modifies zero disk files):
  npx nt-skill-supreme init --dry-run
• Safe Overwrite with Automatic Backups (.bak.[timestamp]):
  npx nt-skill-supreme init --force
• Inspect Installation Manifest:
  npx nt-skill-supreme status
• Atomic Manifest-Driven Uninstall:
  npx nt-skill-supreme remove

---

🎨 Contextual Visual Profiles

Adapt design intensity dynamically to match project objectives:

• minimal: Refined, editorial cleanliness, typography cadence, whitespace rhythm, subtle motion, zero neon/glow clutter. (Ideal for luxury, legal, blogs, executive portfolios).
• balanced (Default): Premium aesthetic, tactile micro-interactions, moderate depth, WCAG AA contrast, smooth spring physics. (Ideal for SaaS, agency sites, clinics, local services).
• supreme: High visual impact, 3D perspective hover tilt, spotlight tracking, native scroll-driven animations, parallax depth. (Ideal for product launches, web experiences, tech portfolios).

---

💥 The Real Transformation: Before vs After

Why do applications and websites generated with NT-SKILL SUPREME convert and perform flawlessly?

Feature	❌ Without Skill (Standard AI Generation)	🚀 With NT-SKILL SUPREME v3.0
Architecture & State	Mixes API state in global stores blindly	Strictly separates Server State (TanStack Query) & Client UI State
API & Type Safety	Any/unknown loose types and unvalidated payloads	Zod input validation, type-safe route handlers, and Drizzle/Prisma ORMs
Security & OWASP	Vulnerable to SQLi, XSS, and unauthenticated routes	OWASP defenses, DOMPurify HTML sanitization, CSP headers, HttpOnly cookies
Testing & Quality	Mutes or deletes failing tests to pretend success	Mandatory Test-Driven AI Verification (Vitest / Playwright 100% pass)
Design & Aesthetics	Plain white background, #3b82f6 blue buttons ("AI Slop")	Adaptive HSL palettes, glassmorphic depth, and tactile spring physics
Hover & Cursor	Flat static cards without depth	Dynamic 3D Card Hover Tilt with fine pointer media query guards
CRO & Grounded Data	Long forms and ungrounded fake reviews/stats	3-Second value rule, near-CTA social proof, zero fake numbers

---

🛠 Direct Commands & Agency Workflows

Command	Action
/build-fullstack-app [niche] [stack]	Full-Stack Production Engine: Generates a complete full-stack web application structure (Auth, DB schema, Zod API routes, Stripe, Admin UI).
/build-client-site [niche] [--style minimal|balanced|supreme]	Rapid Agency Engine: Generates a complete, multi-section client site in a single HTML file (Dental, Gym, Law, Restaurant, Agency, SaaS).
/refactor-codebase	Audits and restructures existing codebases following SOLID principles, type-safety standards, and clean architecture.
/security-audit	Analyzes code for OWASP Top 10 vulnerabilities, input sanitization gaps, rate-limiting deficits, and secret exposures.
/add-feature [type]	Injects full-stack feature modules (Auth Auth0/Supabase, Stripe Billing, User Admin Panel, S3/R2 Uploads).
/add-section [type]	Injects a production-ready UI section (Sticky Header, Floating WhatsApp, Pricing Switch, Accordion FAQ, Lead Capture Form).
/rapid-localize	Replaces placeholders with client-specific brand name, phone number, WhatsApp link, and local address.
/design-audit	Perform a visual hierarchy, accessibility, code hygiene, and slop scan of your current frontend components.
/polish-ui [--style minimal|balanced|supreme]	Elevate existing components with smooth transitions, refined typography, and glassmorphic depth.

---

📁 Repository Structure

nt-skill-supreme/
├── assets/
│   └── banner.png                    # Official Showcase Hero Banner Image
├── tests/
│   └── cli.test.js                   # Automated CLI Test Suite (node --test)
├── SKILL.md                          # Primary skill definition (YAML frontmatter + system instructions)
├── AGENTS.md                         # Rules for Cursor, Trae, Windsurf, OpenCode, Codex & Antigravity
├── AUDIT.md                          # Comprehensive Audit & Architecture Assessment
├── CHANGELOG.md                      # Version history (Semantic Versioning 3.0.0)
├── references/                       # Master technical reference manuals
│   ├── state-and-data-fetching.md    # [v3.0] Server vs Client state, TanStack Query, Zustand, loading states
│   ├── api-and-db-contracts.md       # [v3.0] Zod input validation, Drizzle/Prisma ORM standards, Postgres RLS
│   ├── auth-and-multi-tenancy.md     # [v3.0] OAuth, Passkeys, session cookies, multi-tenant middleware, RBAC
│   ├── testing-and-qa.md             # [v3.0] Vitest, Playwright E2E, AI test verification, anti-regression
│   ├── security-and-hardening.md     # [v3.0] OWASP defenses, input sanitization, rate-limiting, CSP headers
│   ├── fullstack-scaffolding.md      # [v3.0] Directory layout, Stripe webhook handlers, Cloud storage uploads
│   ├── niche-blueprints.md           # Commercial industry blueprints & conversion funnels
│   ├── component-blueprints.md       # Drop-in UI code snippets (Navbar, Hero, FAQs, WhatsApp Float)
│   ├── cro-and-performance.md        # 3-Second value rule, mobile ergonomics, Core Web Vitals
│   ├── motion-and-physics.md         # Scroll-driven CSS animations, 3D tilt & spring physics
│   ├── image-gen-and-fallbacks.md    # AI photo generation protocol & Unsplash/SVG fallbacks
│   ├── taste-anti-slop.md            # Zero-slop & palette generation guide
│   ├── ui-ux-wcag.md                 # UI/UX grids & WCAG accessibility rules
│   └── craft-and-polish.md           # Visual QA & design audit manual
├── bin/cli.js                        # Multi-AI universal installer CLI script
└── .claude-plugin/plugin.json        # Claude Desktop & Claude Code plugin metadata

---

🧪 Running Tests & Quality Verification

Run the automated test suite locally:

npm test

Inspect help banner and options:

npm run lint

---

📄 License

Released under the MIT License. Copyright (c) 2026 NachoTorresRD.