Skip to content
Back to search

naksha

SkillWorks with Gemini CLIGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/adityaraj0421-naksha-studio/badge.svg)](/listings/adityaraj0421-naksha-studio)

HTML

<a href="/listings/adityaraj0421-naksha-studio"><img src="/api/listings/adityaraj0421-naksha-studio/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code (full plugin — 70 commands, agents, hooks)

**From the marketplace** (Claude Code 2.1.72+) — run inside Claude Code:

/plugin marketplace add https://github.com/Adityaraj0421/naksha-studio.git
/plugin install naksha@naksha

**Or from a local clone** (best if you want to edit naksha):

git clone https://github.com/Adityaraj0421/naksha-studio.git
cd naksha-studio && bash install.sh

Then restart Claude Code and try:

/design Build a landing page for a SaaS analytics product

> **✨ New in v6 — Naksha Live:** watch your design team work in a local dashboard (`/naksha-dashboard setup`), get free instant design lint after every edit (`/design-detect`), see what each command costs (`/naksha-stats`), keep your design system in the open DESIGN.md format (`/design-md`), and teach naksha with `/naksha-vote`. Optional, local-only, no telemetry. See the [CHANGELOG](CHANGELOG.md).

> **✨ New in v5.3 — taste memory:** `/design-variants Design a pricing page` builds three genuinely different directions side by side; tell naksha which you like with `/naksha-taste approve A`, and every later `/design` starts from your taste.

> **✨ New in v5.1 — `/design-reel`:** record the design team working and render a share-able video of it (9:16 + 16:9). `/design-reel Design a pricing page for a SaaS analytics product` → a post-ready clip of your screen being designed, live. [Learn more ↓](#design-reel-task--watch-the-team-new-in-v51)

> **Updates:** Marketplace installs update with `claude plugin update naksha` (it moves when a new version is released). Local clones: `git pull && bash install.sh` — Claude Code runs its own cached copy of the plugin, so re-running the installer is what picks up the new code.

Cursor

Copy `.cursor/rules/naksha.mdc` to your project's `.cursor/rules/` directory. The design team activates automatically for CSS, HTML, TSX, SVG, and token files.

Windsurf

Copy `.windsurfrules` to your project root. Windsurf reads it automatically at session start.

Gemini CLI

Copy `GEMINI.md` to your project root. Gemini CLI reads it at session start.

VS Code Copilot

Copy `.github/copilot-instructions.md` to your project's `.github/` directory. Copilot Chat and inline completions will apply the design team's rules.

Autohand Code CLI

Copy `AGENTS.md` to your project root and copy `skills/design/` to `.autohand/skills/naksha-design/`. Autohand Code CLI will read the project instructions and load the Naksha design skill from its project-level skills directory.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 21 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "naksha",
  3. "owner": {
  4. "name": "Aditya Raj",
  5. "url": "https://github.com/Adityaraj0421"
  6. },
  7. "plugins": [
  8. {
  9. "name": "naksha",
  10. "source": "./",
  11. "description": "A virtual design team for Claude Code — 30 roles, 70 commands, 16,000+ lines of expert design knowledge. Your agency's design brain, inside your terminal.",
  12. "version": "6.0.0",
  13. "author": {
  14. "name": "Aditya Raj"
  15. },
  16. "repository": "https://github.com/Adityaraj0421/naksha-studio",
  17. "license": "MIT",
  18. "keywords": ["design", "ui", "ux", "figma", "frontend", "design-system", "components"]
  19. }
  20. ]
  21. }
README.md · README · 1,078 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. # naksha
  3. **Your agency's design brain. Always on, always yours.**
  4. *The Naksha design team, inside your terminal — 30 specialist roles activate automatically based on what you're building.*
  5. <br>
  6. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  7. [![Claude Code](https://img.shields.io/badge/Claude_Code-Plugin-blueviolet)](https://claude.ai/claude-code)
  8. [![Cursor](https://img.shields.io/badge/Cursor-Rules-black)]()
  9. [![Windsurf](https://img.shields.io/badge/Windsurf-Rules-0099ff)]()
  10. [![Gemini CLI](https://img.shields.io/badge/Gemini_CLI-GEMINI.md-4285F4)]()
  11. [![Copilot](https://img.shields.io/badge/Copilot-Instructions-24292e)]()
  12. [![Autohand Code CLI](https://img.shields.io/badge/Autohand_Code_CLI-AGENTS.md-0A84FF)](https://github.com/autohandai/code-cli)
  13. [![Roles](https://img.shields.io/badge/Specialist_Roles-30-orange)]()
  14. [![Commands](https://img.shields.io/badge/Slash_Commands-70-green)]()
  15. [![Design Knowledge](https://img.shields.io/badge/Design_Knowledge-16000%2B_lines-E8633A)]()
  16. [Quick Start](#-quick-start) · [Commands](#-commands) · [The Team](#-the-team) · [How It Works](#-how-it-works) · [Changelog](CHANGELOG.md)
  17. </div>
  18. ---
  19. ## 🚀 Quick Start
  20. ### Claude Code (full plugin — 70 commands, agents, hooks)
  21. **From the marketplace** (Claude Code 2.1.72+) — run inside Claude Code:
  22. ```
  23. /plugin marketplace add https://github.com/Adityaraj0421/naksha-studio.git
  24. /plugin install naksha@naksha
  25. ```
  26. **Or from a local clone** (best if you want to edit naksha):
  27. ```bash
  28. git clone https://github.com/Adityaraj0421/naksha-studio.git
  29. cd naksha-studio && bash install.sh
  30. ```
  31. Then restart Claude Code and try:
  32. ```
  33. /design Build a landing page for a SaaS analytics product
  34. ```
  35. > **✨ New in v6 — Naksha Live:** watch your design team work in a local dashboard (`/naksha-dashboard setup`), get free instant design lint after every edit (`/design-detect`), see what each command costs (`/naksha-stats`), keep your design system in the open DESIGN.md format (`/design-md`), and teach naksha with `/naksha-vote`. Optional, local-only, no telemetry. See the [CHANGELOG](CHANGELOG.md).
  36. > **✨ New in v5.3 — taste memory:** `/design-variants Design a pricing page` builds three genuinely different directions side by side; tell naksha which you like with `/naksha-taste approve A`, and every later `/design` starts from your taste.
  37. > **✨ New in v5.1 — `/design-reel`:** record the design team working and render a share-able video of it (9:16 + 16:9). `/design-reel Design a pricing page for a SaaS analytics product` → a post-ready clip of your screen being designed, live. [Learn more ↓](#design-reel-task--watch-the-team-new-in-v51)
  38. > **Updates:** Marketplace installs update with `claude plugin update naksha` (it moves when a new version is released). Local clones: `git pull && bash install.sh` — Claude Code runs its own cached copy of the plugin, so re-running the installer is what picks up the new code.
  39. ### Cursor
  40. Copy `.cursor/rules/naksha.mdc` to your project's `.cursor/rules/` directory. The design team activates automatically for CSS, HTML, TSX, SVG, and token files.
  41. ### Windsurf
  42. Copy `.windsurfrules` to your project root. Windsurf reads it automatically at session start.
  43. ### Gemini CLI
  44. Copy `GEMINI.md` to your project root. Gemini CLI reads it at session start.
  45. ### VS Code Copilot
  46. Copy `.github/copilot-instructions.md` to your project's `.github/` directory. Copilot Chat and inline completions will apply the design team's rules.
  47. ### Autohand Code CLI
  48. Copy `AGENTS.md` to your project root and copy `skills/design/` to `.autohand/skills/naksha-design/`. Autohand Code CLI will read the project instructions and load the Naksha design skill from its project-level skills directory.
  49. ---
  50. ## 👥 The Team
  51. <!-- naksha:generated roles — edit adapters/, then run: node scripts/build-adapters.js -->
  52. <table>
  53. <tr>
  54. <td align="center" width="14%">
  55. **Design Manager**
  56. Orchestrates
  57. </td>
  58. <td align="center" width="14%">
  59. **Creative Director**
  60. Vision
  61. </td>
  62. <td align="center" width="14%">
  63. **Product Designer**
  64. Strategy
  65. </td>
  66. <td align="center" width="14%">
  67. **UX Designer**
  68. Flows
  69. </td>
  70. <td align="center" width="14%">
  71. **UI Designer**
  72. Visual
  73. </td>
  74. <td align="center" width="14%">
  75. **UX Researcher**
  76. Insights
  77. </td>
  78. <td align="center" width="14%">
  79. **Content Designer**
  80. Copy
  81. </td>
  82. </tr>
  83. <tr>
  84. <td align="center">
  85. **Design System Lead**
  86. Tokens
  87. </td>
  88. <td align="center">
  89. **Motion Designer**
  90. Animation
  91. </td>
  92. <td align="center">
  93. **Illustration Director**
  94. Icons & Art
  95. </td>
  96. <td align="center">
  97. **Presentation Designer**
  98. Decks
  99. </td>
  100. <td align="center">
  101. **Brand Strategist**
  102. Positioning
  103. </td>
  104. <td align="center">
  105. **Print Designer**
  106. Print & PDF
  107. </td>
  108. <td align="center">
  109. **Video/Content Producer**
  110. Scripts
  111. </td>
  112. </tr>
  113. <tr>
  114. <td align="center">
  115. **Social Media Designer**
  116. Social Visuals
  117. </td>
  118. <td align="center">
  119. **Social Media Strategist**
  120. Campaigns
  121. </td>
  122. <td align="center">
  123. **Social Media Copywriter**
  124. Captions
  125. </td>
  126. <td align="center">
  127. **Growth/Analytics Specialist**
  128. Metrics
  129. </td>
  130. <td align="center">
  131. **Email Designer**
  132. HTML Email
  133. </td>
  134. <td align="center">
  135. **Email Copywriter**
  136. Subject Lines
  137. </td>
  138. <td align="center">
  139. **Data Viz Designer**
  140. Charts
  141. </td>
  142. </tr>
  143. <tr>
  144. <td align="center">
  145. **Dashboard Architect**
  146. Layouts
  147. </td>
  148. <td align="center">
  149. **Framework Specialist**
  150. Components
  151. </td>
  152. <td align="center">
  153. **AI Image Director**
  154. Image Gen
  155. </td>
  156. <td align="center">
  157. **AI Video Director**
  158. Video Gen
  159. </td>
  160. <td align="center">
  161. **AI Audio & Voice Producer**
  162. Voiceover & Music
  163. </td>
  164. <td align="center">
  165. **AI Prompt Engineer**
  166. Prompt Systems
  167. </td>
  168. <td align="center">
  169. **Conversational Designer**
  170. Chat & Voice UI
  171. </td>
  172. </tr>
  173. <tr>
  174. <td align="center">
  175. **Spatial Designer**
  176. Spatial & AR
  177. </td>
  178. <td align="center">
  179. **Compliance Designer**
  180. Regulated UX
  181. </td>
  182. <td align="center" colspan="5">
  183. </td>
  184. </tr>
  185. <tr>
  186. <td align="center" colspan="7">
  187. _The skill loads only the references your task actually needs_
  188. </td>
  189. </tr>
  190. </table>
  191. <!-- /naksha:generated roles -->
  192. ---
  193. ## 🎯 Commands
  194. | Command | What It Does |
  195. |---------|-------------|
  196. | `/design <task>` | Full design workflow with team assembly |
  197. | `/design-review <file or screenshot>` | Quality audit — accepts HTML, Figma URLs, or screenshots for visual AI critique (6 design principles scored 0–10) |
  198. | `/design-system` | Generate, extract, or audit design tokens |
  199. | `/design-md <lint\|import\|export\|page\|show>` | Read, lint (incl. WCAG AA contrast) and write [DESIGN.md](https://github.com/google-labs-code/design.md) design systems; import DTCG/CSS tokens, export DTCG, CSS or Tailwind, and keep `.naksha/design-system/MASTER.md` plus per-page overrides (v6) |
  200. | `/figma <URL>` | Convert Figma designs to production code |
  201. | `/figma-create <task>` | Build pages, wireframes, components in Figma |
  202. | `/ux-audit <brief>` | Audit Figma file against a design brief |
  203. | `/design-handoff` | Developer handoff docs (tokens, specs, APIs) |
  204. | `/figma-responsive` | Generate mobile/tablet variants from desktop |
  205. | `/figma-sync` | Detect design–code drift |
  206. | `/design-present` | Interactive HTML presentation from Figma |
  207. | `/brand-kit <color>` | Complete brand kit from 1–2 colors |
  208. | `/component-docs` | Storybook-style docs from Figma components |
  209. | `/figma-prototype` | Prototype connections between frames |
  210. | `/site-to-figma <URL>` | Capture website → editable Figma design |
  211. | `/ab-variants` | A/B test design variants |
  212. | `/design-sprint` | Guided 5-phase design sprint |
  213. | `/social-content <task>` | Social media visuals (posts, stories, reels, carousels) |
  214. | `/social-campaign <brief>` | Campaign planning with strategy, calendar, and captions |
  215. | `/social-analytics <type>` | Social analytics dashboards and performance reports |
  216. | `/design-framework <fw> [file]` | Convert HTML designs to React, Vue, Svelte, Next.js, or Astro |
  217. | `/email-template <type> for <brand>` | Production HTML email template (responsive, dark mode, cross-client) |
  218. | `/email-campaign <type> for <product>` | Complete multi-email campaign sequence with copy and HTML templates |
  219. | `/email-audit` | Full-spectrum email audit — technical rendering issues + copy/strategy critique (two-phase) |
  220. | `/design-template <category>` | Production web template from gallery (landing-page, dashboard, pricing, auth, blog, ecommerce, portfolio, docs, saas, onboarding) |
  221. | `/chart-design <description>` | Accessible chart or data visualization — selects chart type, applies colorblind-safe palette, outputs HTML/CSS/JS |
  222. | `/dashboard-layout <description>` | Complete dashboard — KPI cards, chart areas, filter bar, data table, sidebar, responsive |
  223. | `/data-viz-audit` | Audit chart type, palette, annotations, anti-patterns. Conditional Phase 2: dashboard fit |
  224. | `/design-tutorial [track]` | Interactive guided tour — tracks: quick-start, ui, figma, social, email, data-viz, full |
  225. | `/figma-component-library <description>` | Complete Figma component library — atoms, molecules, organisms with variants, auto layout, component properties |
  226. | `/motion-design <component or page>` | Design micro-interactions, transitions, and animation systems — duration/easing scale, reduced motion fallbacks |
  227. | `/presentation-design <deck type>` | Design a complete presentation deck — pitch deck, product demo, or internal — with slide system and visual hierarchy |
  228. | `/brand-strategy <brand name>` | Define or audit a brand — positioning, visual identity, voice and tone, brand architecture |
  229. | `/illustration-system <scope>` | Design an illustration style guide, icon system, or SVG asset set |
  230. | `/video-script <video type>` | Write a video script, storyboard, or content series plan for demos, explainers, social video, or ads |
  231. | `/gen-image <subject> for <brand>` | Generate a brand-aligned AI image — tool selection (MJ/DALL-E/Ideogram/Firefly/SD), full 6-element prompt, 2 variations, seed strategy |
  232. | `/gen-video <scene> for <platform>` | Generate a shot-by-shot AI video prompt pack — tool selection (Runway/Kling/Sora/Pika/Luma), consistency strategy, platform spec |
  233. | `/gen-audio <voice or music> for <platform>` | Generate an AI audio brief — voiceover (ElevenLabs/Murf) or music/jingle (Suno), timing cues, FTC/EU AI Act compliance |
  234. | `/gen-moodboard <concept> for <brand>` | Generate 3 AI moodboard directions — brand personality extraction, visual style, 4–6 prompts per direction |
  235. | `/prompt-refine <existing prompt>` | Diagnose and optimise any AI gen prompt — annotated critique, optimised version, cross-tool variant |
  236. | `/print-layout <brief>` | Print-ready layout — business cards, certificates, brochures, posters with CMYK, bleed, and crop marks |
  237. | `/print-audit <file>` | Pre-flight audit for print: bleed, CMYK, resolution, font embedding, PDF/X compliance |
  238. | `/pdf-report <brief>` | Multi-page PDF report or document — cover, table of contents, body sections, charts, structured for print or digital |
  239. | `/lint-design <figma_url>` | Design linter — orphan colors, non-token spacing, missing auto-layout, contrast violations, scored by severity |
  240. | `/accessibility-audit` | WCAG 2.1 AA audit — contrast, ARIA, keyboard nav, semantic HTML — with specific code fixes |
  241. | `/design-qa <file or URL>` | Visual QA at 3 breakpoints — token compliance, interaction states, responsive behavior |
  242. | `/design-critique <file>` | Heuristic review — Nielsen's 10 heuristics, visual audit, interaction states; add `--screenshot <path>` for vision-mode critique |
  243. **v4.0.0 — Memory, Pipelines, Vision & Frontier Wings**
  244. | `/naksha-init` | Interactive project setup wizard — writes `.naksha/project.json` (brand, framework, tokens) and creates a design decision log |
  245. | `/naksha-status` | Display current project context and recent design decisions from memory |
  246. | `/pipeline run <name>` | Execute a multi-step design pipeline — `launch-prep`, `brand-audit`, `component-build`, `social-launch` |
  247. | `/design-compare <url1> <url2>` | Side-by-side visual analysis of two URLs — layout, typography, color, UX patterns, "Steal This" recommendations |
  248. | `/competitive-audit <url>` | Extract a competitor's color palette, type system, layout grid, and UX patterns with quality ratings |
  249. | `/design-chatbot <type> [platform]` | Complete chatbot/assistant UI spec — persona, dialog flows, message bubbles, quick replies, error states, accessibility |
  250. | `/design-voice-ui <product> [platform] [screen]` | Voice interface spec — wake word flows, confirmation patterns, hybrid screen layout, SSML, earcon design |
  251. | `/design-spatial <type> [platform]` | Spatial computing spec for visionOS/WebXR — depth hierarchy, window types, ornaments, spatial typography |
  252. | `/design-ar-overlay <use-case> [platform]` | AR overlay spec — anchor strategy, world tracking UI, instruction cards, scan states, occlusion handling |
  253. | `/design-gdpr <type> [jurisdiction]` | GDPR/CCPA consent flows — cookie banner variants, privacy control center, data deletion request flow |
  254. | `/design-compliance --regulation <hipaa\|pci\|ada>` | Compliance design audit or generation — HIPAA PHI handling, PCI payment form isolation, ADA/Section 508 |
  255. **v4.6.0 — CI/CD & Health**
  256. | `/naksha-doctor [--fix]` | Plugin health check — validates command count, references, version consistency, allowed-tools; probes Playwright + Figma MCP availability; `--fix` remediates issues automatically |
  257. **v4.7.0 — Design Intelligence**
  258. | `/design-score <file or URL>` | Quantitative 0–100 design score across 4 dimensions: Accessibility (WCAG), Usability (Nielsen), Visual Quality, Token Compliance — ASCII bar chart, A–F grade |
  259. **v5.0.0 — Project Memory & Design Agent**
  260. | `/naksha-browse <url>` | Browser-vision design research — captures a live URL, extracts layout patterns, typography, color, and UX patterns, stores findings in `.naksha/project.json` for automatic context injection into future design commands |
  261. | `/naksha-remember <constraint>` | Persist a design constraint or component pattern to project memory — classified as `constraint` or `component_pattern` and written to `.naksha/project.json`; context flows automatically into `/design`, `/brand-kit`, `/design-system`, and 3 other commands |
  262. **v5.3.0 — Taste Memory**
  263. | `/design-variants <task> [--count 2-5]` | Build 2–5 genuinely different directions for the same brief (each pair differs on at least two of layout, type, color, density, ornament), side by side in `naksha-variants/index.html`. Leans into your taste profile, with one deliberate "Wildcard" |
  264. | `/naksha-taste [approve\|reject <direction> …]` | Record which directions you approved or rejected; with no arguments, show your taste profile. `/design` and `/design-variants` default to approved traits and avoid rejected ones; signals fade after 90 days |
  265. **v6.0.0 — Naksha Live**
  266. | `/design-detect [files]` | Free, no-AI design lint (22 rules: WCAG contrast, spacing grid, type scale, focus-visible, reduced motion, alt text, clickable divs, hardcoded colors, AI-design clichés) with `--json` and CI exit codes; also runs as a hook after UI edits (v6) |
  267. | `/naksha-stats [--since <date>]` | Tokens and estimated cost per naksha command from your local Claude Code usage, compared against optional budgets in `.naksha/project.json` (v6) |
  268. | `/naksha-dashboard [setup\|start\|stop\|status\|disable]` | Naksha Live (optional, recommended): a local dashboard with a live org chart of the 30 roles, activity stream, project memory, findings and cost. Zero dependencies, 127.0.0.1 only, token-protected; off until you run `setup` (v6) |
  269. | `/naksha-vote helpful\|needs-work <subject> [because …]` | Vote on a design, variant, review finding or command run. Votes stay local in `.naksha/votes.jsonl`, consolidate into evidence-backed taste observations, and calibrate eval judges against what you actually thought (v6) |
  270. <details>
  271. <summary><b>📖 Command details & examples</b></summary>
  272. <br>
  273. ### `/design <task>` — Full Design Workflow
  274. Assembles the right specialists and runs the complete workflow:
  275. ```
  276. /design Create a 3-tier pricing page with monthly/annual toggle
  277. /design Redesign the onboarding flow for better conversion
  278. /design Build a real-time analytics dashboard
  279. ```
  280. ### `/design-reel <task>` — Watch the Team _(new in v5.1)_
  281. Runs `/design`, then renders the result as a share-able video of the design team working — vertical (9:16) + landscape (16:9), captioned, with each specialist's contribution narrated over the page they built:
  282. ```
  283. /design-reel Design a pricing page for a SaaS analytics product
  284. /design-reel Redesign the settings page --url http://localhost:3000/settings
  285. ```
  286. Outputs `reel-9x16.mp4` + `reel-16x9.mp4`, ready to post. `--url` captures a live page for a real before/after wipe; without it, the reel shows the freshly built page. Requires a one-time Node render toolchain (`packages/naksha-reel`, installs on first use) — run `/naksha-doctor` to check, or see [docs/reel-setup.md](docs/reel-setup.md). The clip is a produced re-enactment, end-carded as such.
  287. ### `/design-review <file>` — Quality Audit
  288. Runs a structured 5-point audit on existing designs:
  289. ```
  290. /design-review ./src/pages/checkout.html
  291. ```
  292. Checks: Accessibility (WCAG AA) · Usability Heuristics · Visual Consistency · Content Quality · Motion Design
  293. ### `/design-system` — Token Generation
  294. Generate, extract, or audit design tokens:
  295. ```
  296. /design-system Generate tokens from brand color #2563eb
  297. /design-system Extract tokens from this Figma file
  298. /design-system Audit existing code for hardcoded values
  299. ```
  300. ### `/figma <URL>` — Figma to Code
  301. Convert Figma designs to production-ready code:
  302. ```
  303. /figma https://figma.com/design/abc123/MyApp?node-id=1-2
  304. ```
  305. ### `/figma-create <task>` — Create Designs in Figma
  306. Build pages, wireframes, components, and design systems directly inside Figma via the Desktop Bridge:
  307. ```
  308. /figma-create Build a 3-screen wireframe for a saved content feature
  309. /figma-create Set up a design system with color tokens and type scale
  310. /figma-create Create a component set for Button with 4 variants
  311. ```
  312. Requires the [Figma Desktop Bridge](https://www.figma.com/community/plugin/figma-desktop-bridge) plugin running in Figma Desktop.
  313. ### `/ux-audit <brief>` — Audit Against a Design Brief
  314. Audit a Figma file for compliance against a design brief — checks page structure, frame naming, sizes, styles, components, and content:
  315. ```
  316. /ux-audit Check the Miles UX Design Challenge submission against the brief
  317. /ux-audit Verify all required screens are present at 1440×900
  318. ```
  319. ### `/design-handoff` — Developer Handoff Docs
  320. Generate a complete developer handoff document from a Figma file — token maps, spacing specs, component APIs, and production-ready code snippets:
  321. ```
  322. /design-handoff Generate handoff for the current Figma file
  323. /design-handoff Export tokens as CSS variables and Tailwind config
  324. ```
  325. Outputs: Markdown docs, CSS custom properties, Tailwind config, TypeScript types.
  326. ### `/figma-responsive <frame>` — Responsive Variants
  327. Generate mobile (375×812) and tablet (768×1024) variants from a desktop Figma frame:
  328. ```
  329. /figma-responsive S3-A / Saved Redesigned
  330. /figma-responsive Create mobile and tablet versions of the dashboard
  331. ```
  332. Clones the source frame, adapts layout (grid reflow, sidebar collapse, nav simplification), and validates each breakpoint with screenshots.
  333. ### `/figma-sync` — Design-Code Sync
  334. Detect drift between Figma designs and code implementation — compare color tokens, typography, spacing, and components:
  335. ```
  336. /figma-sync Check if Figma tokens match our Tailwind config
  337. /figma-sync Compare design system styles against CSS custom properties
  338. ```
  339. Outputs a sync report with drift score, per-token comparison tables, and optional patches for both Figma and code.
  340. ### `/design-present <type>` — Design Presentation
  341. Generate an interactive HTML presentation from Figma screens:
  342. ```
  343. /design-present Create a walkthrough presentation of the dashboard screens
  344. /design-present Build a pitch deck from the product mockups
  345. /design-present Generate a case study presentation
  346. ```
  347. Features: keyboard navigation, progress bar, annotations, zoom, dark/light mode, fullscreen.
  348. ### `/brand-kit <color> [mood]` — Brand Kit Generation
  349. Generate a complete brand kit from 1-2 colors and a mood:
  350. ```
  351. /brand-kit #6366f1 premium
  352. /brand-kit Generate a warm brand from #f59e0b
  353. ```
  354. Outputs: 10-shade color palettes, secondary/accent colors, type scale, spacing scale, CSS custom properties, Tailwind config, JSON tokens, Figma styles, and a visual HTML reference page.
  355. ### `/component-docs` — Component Documentation
  356. Auto-generate Storybook-style documentation from Figma component sets:
  357. ```
  358. /component-docs Document all components in the current Figma file
  359. /component-docs Generate docs for the Button component set
  360. ```
  361. Outputs: prop tables, variant grids, usage guidelines, code examples (HTML/React), rendered screenshots.
  362. ### `/figma-prototype` — Prototype Connections
  363. Create interactive prototype connections between Figma frames:
  364. ```
  365. /figma-prototype Connect all screens in the onboarding flow
  366. /figma-prototype Auto-detect buttons and link them to target screens
  367. ```
  368. Supports transition presets: slide, dissolve, move-in. Auto-detects interactive elements (buttons, links, nav items, cards).
  369. ### `/site-to-figma <URL>` — Website to Figma
  370. Capture a live website and recreate it as an editable Figma design:
  371. ```
  372. /site-to-figma https://example.com
  373. /site-to-figma Capture the hero section of stripe.com
  374. ```
  375. Extracts color palette, typography, section structure via Playwright, then rebuilds as auto-layout Figma frames with Paint/Text Styles.
  376. ### `/ab-variants <frame> [dimension]` — A/B Test Variants
  377. Generate A/B test design variants from an existing Figma screen:
  378. ```
  379. /ab-variants Hero Section layout
  380. /ab-variants Pricing Page cta
  381. /ab-variants Landing Page all
  382. ```
  383. Creates control + test variants with layout, CTA, copy, or color changes. Includes testing recommendations (sample size, duration, success metrics).
  384. ### `/design-sprint <problem>` — Design Sprint
  385. Guided 5-phase design sprint methodology:
  386. ```
  387. /design-sprint Improve signup conversion for our SaaS product
  388. /design-sprint Redesign the checkout experience to reduce abandonment
  389. ```
  390. Phases: Understand (problem mapping) → Diverge (8 solution ideas) → Decide (weighted matrix) → Prototype (build testable solution) → Validate (test script + success metrics).
  391. ### `/design-framework <framework> [file]` — Framework Conversion
  392. Convert HTML/CSS design output to idiomatic component code:
  393. ```
  394. /design-framework react-tailwind ./output/landing-page.html
  395. /design-framework vue ./output/dashboard.html
  396. /design-framework nextjs ./src/app/page.html
  397. /design-framework svelte ./output/component.html
  398. /design-framework astro ./output/hero.html
  399. ```
  400. Or trigger inline from `/design`:
  401. ```
  402. /design Build a pricing page --framework react-tailwind
  403. /design Create an analytics dashboard --framework nextjs
  404. ```
  405. Outputs: TypeScript components with proper interfaces, framework-specific patterns (Server/Client components for Next.js, islands for Astro, runes for Svelte 5), design token mapping to Tailwind config or CSS variables, setup instructions.
  406. Supported frameworks: `react-tailwind` · `vue` (Vue 3 + UnoCSS) · `svelte` (Svelte 5) · `nextjs` (App Router) · `astro`
  407. ### `/social-content <task>` — Social Media Visuals
  408. Create platform-optimized social media visuals at exact dimensions with safe zones:
  409. ```
  410. /social-content Instagram carousel for a product launch — 5 slides
  411. /social-content TikTok story announcing a new feature
  412. /social-content LinkedIn post about our Series A funding
  413. ```
  414. ### `/social-campaign <brief>` — Campaign Planning
  415. Plan a social media campaign with strategy, content calendar, caption drafts, and KPI targets:
  416. ```
  417. /social-campaign Awareness campaign for fitness app targeting Gen Z on Instagram and TikTok
  418. /social-campaign Product launch for SaaS tool — LinkedIn + Twitter — 2 weeks
  419. /social-campaign Engagement campaign for local restaurant on Instagram
  420. ```
  421. Outputs: campaign strategy, 2-week content calendar, first-week caption drafts with hooks and CTAs, KPI targets. Visual assets created separately via `/social-content`.
  422. ### `/social-analytics <type>` — Social Analytics
  423. Build analytics dashboards, performance reports, or A/B test frameworks:
  424. ```
  425. /social-analytics dashboard for Instagram + TikTok — last 30 days
  426. /social-analytics weekly report for LinkedIn company page
  427. /social-analytics ab-test Compare carousel vs. single-image posts on Instagram
  428. ```
  429. ### `/email-template <type> for <brand>` — HTML Email Template
  430. Generate a production-ready HTML email template with inline styles, table layout, and bulletproof buttons:
  431. ```
  432. /email-template welcome for Acme SaaS — new user signup
  433. /email-template promotional for ShopCo — Black Friday 30% off sale
  434. /email-template transactional for OrderCo — order confirmation with item table
  435. /email-template newsletter for TechBlog — weekly curated articles
  436. ```
  437. Outputs: Full HTML with VML buttons (Outlook), mobile-responsive `@media` rules, dark mode, preheader, ESP template variables reference, and QA checklist.
  438. ### `/design-template <category>` — Template Gallery
  439. Start from a production-ready template for any page type:
  440. ```
  441. /design-template landing-page #6366f1
  442. /design-template dashboard --style dark-tech
  443. /design-template pricing --style bold
  444. /design-template saas #2563eb --dark
  445. /design-template portfolio --style minimal
  446. /design-template ecommerce #f59e0b
  447. ```
  448. 10 categories: `landing-page` · `dashboard` · `pricing` · `auth` · `blog` · `ecommerce` · `portfolio` · `docs` · `saas` · `onboarding`
  449. Outputs: Full responsive HTML/CSS with CSS custom properties for rebrand, semantic markup, vanilla JS interactions, dark mode, and mobile layout.
  450. ### `/email-campaign <type> for <product>` — Email Campaign Sequence
  451. Plan and generate a complete multi-email campaign with copy and HTML templates:
  452. ```
  453. /email-campaign welcome-series for Figma-clone SaaS — new signups
  454. /email-campaign product-launch for Naksha v3 — existing users
  455. /email-campaign re-engagement for fitness app — 60-day inactive users
  456. /email-campaign onboarding for project management tool — trial users
  457. ```
  458. Outputs: Campaign brief, sequence map with timing, copy for all emails (subject lines, preview text, body, CTAs), full HTML for each email, ESP automation setup notes, A/B test plan.
  459. ### `/chart-design <description>` — Chart & Data Visualization
  460. Design any chart with the right chart type, accessible color palette, annotations, and production-ready HTML/CSS/JS:
  461. ```
  462. /chart-design monthly revenue trend for 2025
  463. /chart-design part-to-whole breakdown of user acquisition channels
  464. /chart-design scatter plot: ad spend vs conversion rate
  465. /chart-design --library d3 geographic user distribution by US state
  466. ```
  467. Applies colorblind-safe palettes (sequential/diverging/categorical), adds contextual annotations, includes ARIA accessibility (role="img", title, desc), responsive tick density, and Chart.js data table fallback. Supports `--library` flag for D3, Recharts, Visx, or vanilla SVG.
  468. ### `/dashboard-layout <description>` — Dashboard Layout
  469. Build a complete, production-ready dashboard layout:
  470. ```
  471. /dashboard-layout SaaS analytics dashboard with MRR, churn, active users
  472. /dashboard-layout e-commerce admin: orders, revenue, inventory, customer table
  473. /dashboard-layout monitoring dashboard for API performance metrics --style dark-tech
  474. /dashboard-layout --type executive weekly business review for C-suite
  475. ```
  476. Outputs full HTML/CSS with sidebar navigation, 4-column KPI card row, primary + secondary chart areas (with `/chart-design` integration hooks), filter bar with date range selectors, sortable data table with pagination, responsive breakpoints (desktop/tablet/mobile), dark mode, and vanilla JS interactions.
  477. ### `/design-tutorial [track]` — Interactive Tutorial
  478. New to Naksha? Run a guided tour with real exercises:
  479. ```
  480. /design-tutorial # shows welcome screen + track selection
  481. /design-tutorial quick-start # 5 min: run 3 commands, see what each produces
  482. /design-tutorial ui # 15 min: build component → extract tokens → handoff
  483. /design-tutorial figma # 15 min: create in Figma → responsive → prototype
  484. /design-tutorial social # 15 min: post design → campaign → analytics
  485. /design-tutorial email # 15 min: welcome template → onboarding sequence
  486. /design-tutorial data-viz # 15 min: chart design → full dashboard
  487. /design-tutorial full # 30 min: complete tour of all 9 wings
  488. ```
  489. Each track produces real output — you're not just reading docs, you're running commands. The quick-start track covers the three most common commands (`/design`, `/design-review`, `/design-framework`) in under 5 minutes.
  490. ### `/figma-component-library <description>` — Figma Component Library Generator
  491. Generate a complete component library in Figma — atoms → molecules → organisms — from a brand description or design token config:
  492. ```
  493. /figma-component-library SaaS product with blue primary, minimal style
  494. /figma-component-library e-commerce: product cards, cart, checkout forms
  495. /figma-component-library --scope atoms # generate only atom-level components
  496. /figma-component-library --config design-tokens.json --framework
  497. ```
  498. Generates the full atomic design hierarchy:
  499. - **Atoms** (18 components): Button, Badge, Input, Checkbox, Toggle, Avatar, Spinner, Tooltip, and more — each with all variants and states
  500. - **Molecules** (16 components): Card, Form Field, Alert, Modal, Tabs, Dropdown, Stat Card, Empty State, and more
  501. - **Organisms** (10 components): Nav Bar, Sidebar, Data Table, Hero, Form Section, Pricing Card, and more
  502. All components use auto layout, component properties, and a consistent token foundation. Add `--framework` for companion TypeScript interface specs.
  503. </details>
  504. ---
  505. ## 🔗 Workflows
  506. Commands chain together. Each command suggests relevant next steps:
  507. | Workflow | Pipeline |
  508. |----------|----------|
  509. | Design from scratch | `/design` → `/design-review` → `/design-system` → `/figma-create` |
  510. | Figma-native | `/figma-create` → `/ux-audit` → `/figma-prototype` → `/figma-responsive` |
  511. | Design-to-code | `/figma` → `/design-review` → `/figma-sync` |
  512. | Brand setup | `/brand-kit` → `/figma-create` → `/design-handoff` |
  513. | Stakeholder review | `/figma-create` → `/design-present` → `/ab-variants` |
  514. | Full product sprint | `/design-sprint` → `/figma-create` → `/figma-prototype` → `/design-present` |
  515. | Social media launch | `/social-campaign` → `/social-content` → `/social-analytics` |
  516. | Social content creation | `/brand-kit` → `/social-content` → `/ab-variants` |
  517. | Design-to-React | `/design` → `/design-framework react-tailwind` → `/design-review` |
  518. | Design-to-Next.js | `/design` → `/design-framework nextjs` → `/figma-sync` |
  519. | Email launch sequence | `/brand-kit` → `/email-template` → `/email-campaign` |
  520. | Email + social campaign | `/email-campaign` → `/social-campaign` → `/social-analytics` |
  521. | Template to production | `/design-template` → `/design-framework react-tailwind` → `/design-system` |
  522. | Template to Figma | `/design-template` → `/figma-create` → `/component-docs` |
  523. | Data viz pipeline | `/dashboard-layout` → `/chart-design` → `/design-framework` |
  524. | Full analytics build | `/brand-kit` → `/dashboard-layout` → `/chart-design` → `/design-handoff` |
  525. | First-time user | `/design-tutorial quick-start` → `/design-tutorial <track>` → `/design <task>` |
  526. | Full design system | `/brand-kit` → `/figma-component-library` → `/design-handoff` → `/design-framework` |
  527. | Brand launch | `/brand-strategy` → `/brand-kit` → `/illustration-system` → `/social-content` |
  528. | Pitch deck | `/brand-strategy` → `/presentation-design` → `/design-present` |
  529. | Motion system | `/design-system` → `/motion-design` → `/design-review` |
  530. | Video + social | `/video-script` → `/social-content` → `/social-campaign` |
  531. | Full identity system | `/brand-strategy` → `/brand-kit` → `/illustration-system` → `/figma-component-library` |
  532. | Project setup | `/naksha-init` → `/brand-kit` → `/design-system` → `/design` |
  533. | Pre-launch pipeline | `/pipeline run launch-prep` |
  534. | Competitor research | `/competitive-audit` → `/design-compare` → `/design` |
  535. | Chatbot + voice | `/design-chatbot` → `/design-voice-ui` → `/design-system` |
  536. | Spatial app | `/design-spatial` → `/design-ar-overlay` → `/design-system` |
  537. | GDPR + compliance | `/design-gdpr` → `/design-compliance --regulation ada` |
  538. | Design quality gate | `/design` → `/design-score` → `/design-review` |
  539. | Plugin health check | `/naksha-doctor` → `/naksha-doctor --fix` |
  540. ---
  541. ## 🚦 CI/CD Design Checks
  542. Add automatic design quality checks to every PR. The included GitHub Action runs when HTML/CSS files change, posts a score card as a PR comment, and fails CI if quality drops below the threshold.
  543. **Setup:** Copy the workflow to your repo:
  544. ```bash
  545. cp .github/workflows/design-check.yml /your-repo/.github/workflows/
  546. cp scripts/design-lint.js /your-repo/scripts/
  547. ```
  548. **PR comment example:**
  549. ```
  550. ✅ Design Quality Check — Score: 94/100
  551. | Severity | File | Check | Issue |
  552. |----------|------|-------|-------|
  553. | 🟡 Warning | src/dashboard.html | CSS token compliance | 7 hardcoded hex colors found |
  554. ```
  555. **Local run:**
  556. ```bash
  557. node scripts/design-lint.js src/**/*.html src/**/*.css
  558. ```
  559. **Configure** via `.design-lint.json` in your repo root (copy from `.design-lint.json.example`):
  560. ```json
  561. { "failThreshold": 80, "ignorePatterns": ["dist/**"] }
  562. ```
  563. **Score formula:** `100 − (errors × 10) − (warnings × 3)`
  564. ---
  565. ## 🧠 Project Memory (v5)
  566. Naksha can remember your project's design constraints across sessions. Run `/naksha-init` once to create a `.naksha/project.json` file with your brand colors, font, voice, and framework. Commands like `/design`, `/brand-kit`, `/design-system`, `/design-score`, and `/design-review` read this file automatically — no copy-pasting context every time.
  567. **Four ways to build memory:**
  568. | Command | What It Does |
  569. |---------|-------------|
  570. | `/naksha-init` | Interactive wizard — sets brand color, font, voice, framework, token format |
  571. | `/naksha-browse <url>` | Capture live site patterns (layout, type, color, UX) and store as `browser_findings` |
  572. | `/naksha-remember <constraint>` | Persist constraints (`grid is 8px`, `no dark mode`, `WCAG AA required`) or component patterns |
  573. | `/naksha-taste approve\|reject <direction>` | Teach naksha your taste — the directions you like and the ones you don't (pair it with `/design-variants`) |
  574. | `/naksha-vote helpful\|needs-work <subject>` | Vote on a result, variant or review finding; votes stay local and teach taste and judge calibration |
  575. Memory is stored in `.naksha/project.json`. Commit it to share context with your team, or add `.naksha/` to `.gitignore` to keep it local. The Stop hook automatically applies any memory-write blocks emitted during a session — so constraints written mid-conversation are persisted without manual saves.
  576. Run `/naksha-status` to see the current context, and `/naksha-doctor` to validate the full plugin health.
  577. ---
  578. ## ⚙️ How It Works
  579. When you run a command, the Design Manager reads your request and assembles the right specialist roles from `skills/design/references/`. Each role contributes its knowledge — UI Designer for color and typography, Motion Designer for animation, Design System Lead for tokens, and so on. The assembled team runs the full workflow: research, strategy, creative, build, and delivery.
  580. **Adaptive loading:** A simple button redesign loads 1–2 references. A full product feature loads 4–7 references with the complete workflow.
  581. ---
  582. ## 🤖 Agents
  583. | Agent | What It Does | Runs In |
  584. |-------|-------------|---------|
  585. | **accessibility-auditor** | Comprehensive WCAG AA compliance audit with specific code fixes | Background |
  586. | **design-qa** | Visual QA at 3 breakpoints, token compliance scoring, interaction state check | Background |
  587. | **figma-creator** | Creates pages, frames, components, and styles directly in Figma via Desktop Bridge | Foreground |
  588. | **design-critique** | Automated UX heuristic review — Nielsen's 10 heuristics, visual audit, interaction states + 4-dimension scoring | Foreground |
  589. | **design-lint** | Scans Figma files for orphan colors, non-standard spacing, low contrast, missing auto-layout (haiku model) | Foreground |
  590. | **design-token-extractor** | Extracts design tokens from CSS/Figma files — color, typography, spacing, shadows (haiku model) | Background |
  591. | **design-score** | Quantitative design scorer — derives Accessibility, Usability, Visual Quality, Token Compliance dimensions | Foreground |
  592. Background agents run in parallel with your main work. Foreground agents run interactively.
  593. ---
  594. ## 🔍 Auto-Detection
  595. The plugin automatically detects your project context at session start:
  596. | Detects | How |
  597. |---------|-----|
  598. | CSS Framework | Tailwind, PostCSS, Bootstrap |
  599. | JS Framework | React, Vue, Svelte, Next.js, Nuxt, Angular, Astro, Remix, SolidJS |
  600. | TypeScript | `tsconfig.json` |
  601. | Build Tool | Vite, Webpack, Turborepo |
  602. | CSS-in-JS | styled-components, Emotion, vanilla-extract |
  603. | Component Library | Radix UI, Chakra, MUI, Mantine, shadcn/ui |
  604. | Design Tokens | `.tokens.json`, `tokens.css`, Style Dictionary |
  605. | Figma | `.figmarc`, Code Connect files |
  606. | Deployment | `firebase.json` |
  607. | Documentation | `.storybook/` directory |
  608. Recommendations adapt to match your stack — no manual configuration needed.
  609. ---
  610. ## ⚙️ Configuration
  611. Create `skills/design/settings.local.md` (gitignored) to set defaults:
  612. ```yaml
  613. brand_color: "#6366f1"
  614. accent_color: "#f59e0b"
  615. brand_name: "MyProduct"
  616. brand_mood: "professional"
  617. css_framework: "tailwind"
  618. default_font: "Inter"
  619. icon_library: "lucide"
  620. include_dark_mode: true
  621. min_contrast_ratio: 4.5
  622. spacing_base: 8
  623. deploy_target: "firebase"
  624. ```
  625. Settings marked `"auto"` or left empty defer to auto-detection. The Design Manager reads these at the start of every task.
  626. ---
  627. ## 📁 What's Inside
  628. ```
  629. naksha/
  630. ├── .claude-plugin/plugin.json # Plugin manifest (v5.0.0)
  631. ├── skills/design/
  632. │ ├── SKILL.md # Design Manager orchestration
  633. │ ├── settings.local.md # User-configurable preferences
  634. │ └── references/ # 32 reference files: one knowledge base per specialist, plus 4 tool guides
  635. │ ├── product-designer.md # End-to-end UX, feature scoping
  636. │ ├── ux-designer.md # Flows, wireframes, IA
  637. │ ├── ui-designer.md # Color, typography, layout, components
  638. │ ├── ux-researcher.md # Heuristics, accessibility, edge cases
  639. │ ├── content-designer.md # Microcopy, errors, tone of voice
  640. │ ├── design-system-lead.md # 3-tier tokens, theming, dark mode, Figma styles
  641. │ ├── motion-designer.md # Timing, easing, micro-interactions, FLIP
  642. │ ├── figma-workflow.md # Figma MCP tools, design-to-code + creation
  643. │ ├── figma-creation.md # Figma API patterns via Desktop Bridge
  644. │ ├── deployment.md # Preview server, Firebase Hosting
  645. │ ├── social-media-designer.md # Platform specs, safe zones, visual systems
  646. │ ├── social-media-strategist.md # Campaign planning, content calendar, KPIs
  647. │ ├── social-media-copywriter.md # Captions, hooks, hashtag strategy
  648. │ ├── growth-analytics-specialist.md # Metrics, dashboards, A/B testing
  649. │ ├── email-designer.md # HTML email, responsive, dark mode, ESPs
  650. │ ├── email-copywriter.md # Subject lines, sequences, deliverability
  651. │ ├── data-viz-designer.md # Chart type selection, colorblind-safe palettes
  652. │ ├── dashboard-architect.md # KPI layouts, filter systems, data tables
  653. │ ├── framework-specialist.md # React/Vue/Svelte/Next.js/Astro patterns
  654. │ ├── template-gallery.md # 10 production web templates
  655. │ ├── presentation-designer.md # Slide systems, pitch decks, data storytelling
  656. │ ├── brand-strategist.md # Positioning, visual identity, brand architecture
  657. │ ├── illustration-director.md # Icon systems, SVG standards, style taxonomy
  658. │ ├── video-content-producer.md # Scripts, storyboards, short-form pacing
  659. │ ├── conversational-designer.md # Chatbot UI, VUI, dialog flows, persona systems
  660. │ ├── spatial-designer.md # visionOS HIG, WebXR, depth layers, gaze/gesture
  661. │ └── compliance-designer.md # GDPR/CCPA consent UX, HIPAA, PCI, ADA compliance
  662. ├── commands/ # 70 slash commands
  663. ├── agents/ # 7 specialist agents
  664. ├── hooks/hooks.json # SessionStart, PreCompact, Stop, PostToolUse lint hooks
  665. ├── scripts/
  666. │ ├── detect-design-context.sh # Project stack detection
  667. │ └── run-evals.sh # Eval structure validator
  668. ├── evals/
  669. │ ├── evals.json # 179 eval cases (prompt + assertion specs)
  670. │ └── fixtures/ # 63 output fixtures for behavioral smoke tests
  671. ├── assets/ # Social preview + demo images
  672. ├── CHANGELOG.md # Version history
  673. └── CONTRIBUTING.md # Contributor guide
  674. ```
  675. <details>
  676. <summary><b>Design knowledge breakdown (16,000+ raw lines)</b></summary>
  677. | File | Lines | Covers |
  678. |------|-------|--------|
  679. | **figma-creation.md** | **693** | **Figma Desktop Bridge API, async patterns, auto-layout, component sets, paint/text styles, variables, wireframe patterns, annotations, screenshot validation** |
  680. | design-system-lead.md | 427 | 3-tier tokens, theming, dark mode, Figma paint/text style creation, component sets |
  681. | motion-designer.md | 360 | Timing, easing functions, transitions, micro-interactions, reduced motion |
  682. | **design-lint.md** | **335** | **6 lint rule categories, orphan colors, contrast, non-standard spacing, auto-layout quality, component hygiene, scored reports** |
  683. | **design-sprint.md** | **327** | **5-phase sprint: Understand, Diverge, Decide, Prototype, Validate — problem framing, ideation, decision matrix, test plans** |
  684. | **site-to-figma.md** | **310** | **Website capture via Playwright, style extraction, Figma recreation as auto-layout frames with Paint/Text Styles** |
  685. | **brand-kit.md** | **301** | **HSL shade generation, secondary color derivation, type scale, spacing scale, CSS/Tailwind/JSON/Figma outputs** |
  686. | **figma-responsive.md** | **298** | **Responsive variant generation, layout analysis, breakpoint adaptation, grid reflow, sidebar collapse** |
  687. | **design-handoff.md** | **278** | **Developer handoff docs, token maps, spacing specs, component APIs, CSS/Tailwind/TypeScript exports** |
  688. | SKILL.md | 300 | Design Manager orchestration, team assembly, workflow phases, output formats |
  689. | **design-critique.md** | **263** | **UX heuristic review, Nielsen's 10 heuristics, visual audit, interaction states, critique reporting** |
  690. | **component-docs.md** | **262** | **Auto-generated Storybook-style docs, prop tables, variant grids, usage guidelines, code examples** |
  691. | **figma-prototype.md** | **258** | **Prototype connections, interactive element detection, transition presets, flow specification** |
  692. | **figma-sync.md** | **252** | **Design-code drift detection, token comparison, typography/spacing sync, patch generation** |
  693. | **ab-variants.md** | **248** | **A/B test variant generation, layout/CTA/copy/color changes, testing recommendations** |
  694. | figma-workflow.md | 246 | Figma MCP tools, design-to-code, Figma-native creation workflow |
  695. | ui-designer.md | 243 | Color theory, type scale, grid, components, responsive patterns |
  696. | ux-designer.md | 239 | User flows, IA, wireframing, interaction design, usability |
  697. | **design-present.md** | **233** | **Interactive HTML presentations, keyboard nav, annotations, walkthrough/pitch/case-study types** |
  698. | content-designer.md | 229 | Microcopy, error formulas, empty states, tone, number formatting |
  699. | ux-audit.md | 219 | Figma file compliance auditing, brief parsing, structural/style/component checks |
  700. | ux-researcher.md | 207 | Nielsen's heuristics, WCAG AA checklist, mental models, edge cases |
  701. | deployment.md | 198 | Preview server, Firebase Hosting, image/CSS/font optimization |
  702. | figma-create.md | 150 | Create designs in Figma command — pages, wireframes, components, design systems |
  703. | figma-creator.md | 142 | Figma creation specialist agent — layout building, component creation, validation |
  704. | design.md (command) | 107 | Full design workflow — team assembly, creative direction, implementation, quality review |
  705. | figma.md (command) | 108 | Figma-to-code workflow — analysis, layout mapping, comparison, refinement |
  706. | design-review.md (cmd) | 89 | 5-point quality audit — accessibility, usability, visual, content, motion |
  707. | design-system.md (cmd) | 84 | Token generation, extraction, auditing — CSS variables, Tailwind, JSON |
  708. | product-designer.md | 140 | Feature scoping, user outcomes, business alignment, design patterns |
  709. | design-qa.md | 127 | Visual QA at 3 breakpoints, token compliance, interaction states |
  710. | accessibility-auditor.md | 105 | WCAG AA compliance, color contrast, semantic HTML, keyboard nav |
  711. </details>
  712. ---
  713. ## 🛠 Tech Stack Defaults
  714. | Category | Default | Why |
  715. |----------|---------|-----|
  716. | Styling | Tailwind CSS | Utility-first, rapid iteration |
  717. | Icons | Lucide | Clean, consistent, tree-shakeable |
  718. | Fonts | Inter | Optimized for UI, great readability |
  719. | Charts | Chart.js / SVG | Lightweight, no heavy deps |
  720. | Animations | CSS transitions | No JS libraries for simple motion |
  721. | Preview | Claude Preview MCP | Live results in your editor |
  722. | Deployment | Firebase Hosting | One-command deploy |
  723. All defaults adapt when the plugin detects your project uses a different stack.
  724. ---
  725. ### Quality check
  726. Run all quality gates locally:
  727. ```bash
  728. bash scripts/quality-check.sh
  729. ```
  730. Checks: metadata consistency (`meta/stats.json` vs filesystem vs README badges), behavioral smoke evals (pre-captured command output fixtures), legacy branding guard.
  731. ---
  732. ## 📦 Installation
  733. **Marketplace** (Claude Code 2.1.72+), inside Claude Code:
  734. ```
  735. /plugin marketplace add https://github.com/Adityaraj0421/naksha-studio.git
  736. /plugin install naksha@naksha
  737. ```
  738. To update: `claude plugin update naksha`.
  739. **Local clone**:
  740. ```bash
  741. git clone https://github.com/Adityaraj0421/naksha-studio.git
  742. cd naksha-studio && bash install.sh
  743. ```
  744. Restart Claude Code to load the plugin. To update: `git pull && bash install.sh`, then restart.
  745. ---
  746. ## Requirements
  747. - [Claude Code](https://claude.ai/claude-code) CLI
  748. - **Optional MCP servers** for Figma + Preview capabilities — see [MCP Setup Guide](MCP-SETUP.md)
  749. ---
  750. <div align="center">
  751. **Built with Claude Code**
  752. [Report Issues](https://github.com/Adityaraj0421/naksha-studio/issues) · [Changelog](CHANGELOG.md) · [MIT License](LICENSE)
  753. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.