design-system

Enforces VNS design system rules, accessibility standards, and UI implementation guidelines for Next.js components.

Updated Jul 21, 2026
One-click install
npx skills add https://github.com/masakinihirota/2026src-ni --skill design-system-masakinihirota
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-system
Source: https://github.com/masakinihirota/2026src-ni/tree/main/.agents/skills/design-system
Command: npx skills add https://github.com/masakinihirota/2026src-ni --skill design-system-masakinihirota

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building consistent, accessible UI in a Next.js project requires juggling multiple design guidelines (DADS tokens, HID 24 principles, Shadcn UI patterns, UX psychology). This Skill consolidates all of them into a single authoritative reference so every component follows the same visual style, accessibility requirements, and interaction rules. ## Core Features & Use Cases - Design Token Enforcement: Defines project colors (brand primary #007EFE, accent yellow focus rings), DADS typography tokens, border radius, and Tailwind v4 configuration rules via CSS variables. - Accessibility Compliance: Mandates WCAG 2.1 AA contrast (4.5:1), aria-disabled instead of disabled, focus-visible ring styles, and aria-describedby wiring for form errors. - UX Principle Guidelines: Provides the HID 24 principles (Fitts's Law, Hick's Law, error prevention, progressive disclosure) and UX psychology patterns (goal gradient, social proof, peak-end rule) with concrete code examples. - Use Case: When implementing a new form page, consult this Skill to get the correct DADS form field pattern with Label, SupportText, ErrorText, proper aria attributes, and project-standard focus styling. ## Quick Start Use the design-system skill to review my new settings page component and fix any accessibility or styling violations.

Frequently Asked Questions about design-system

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

FAQPage Schema
How do I implement accessible forms in Next.js with Shadcn UI?▼

Use the DADS form field pattern: pair Label, SupportText, and ErrorText components with unique IDs, connect them to the Input via aria-describedby, and use aria-disabled instead of the disabled attribute so screen readers can still focus the element.

What design tokens should I use for buttons in this project?▼

Primary buttons use bg-brand-primary (#007EFE) with hover:bg-brand-primary-hover and active:bg-brand-primary-active states. All interactive elements need the standard focus ring: focus-visible:outline-4 outline-black plus ring-accent-yellow (#FFD600).

Does this design system support Tailwind CSS v4?▼

Yes, the project uses Tailwind CSS v4 with configuration defined in the @theme block inside globals.css. Colors and values must reference CSS variables rather than hardcoded values, and repeated styles should become shared component classes.

Why should I use aria-disabled instead of the disabled attribute?▼

The disabled attribute removes elements from the focus order, preventing screen reader users from discovering why an action is unavailable. aria-disabled keeps the element focusable so assistive technology can announce its state and reason.

What are the priority rules when DADS and Shadcn guidelines conflict?▼

DADS implementation instructions take highest priority for design tokens and accessibility, followed by the HID 24 principles for UX behavior. Shadcn UI guidance is prompt assistance only and must be overridden by DADS tokens when they conflict.