ui-ux-master 1.1.0 → 1.2.1

package/README.md

@@ -1,6 +1,15 @@
-# UI/UX Master
+# UI/UX Master 🎨✨
 
-The one-stop UI/UX skill for AI coding agents.
+[![npm version](https://img.shields.io/npm/v/ui-ux-master?logo=npm&label=npm)](https://www.npmjs.com/package/ui-ux-master)
+[![npm downloads](https://img.shields.io/npm/dm/ui-ux-master?logo=npm&label=downloads)](https://www.npmjs.com/package/ui-ux-master)
+[![License: MIT](https://img.shields.io/npm/l/ui-ux-master)](https://github.com/Seance1723/UI-UX-Skills/blob/main/LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/Seance1723/UI-UX-Skills?style=flat&logo=github)](https://github.com/Seance1723/UI-UX-Skills/stargazers)
+[![Last commit](https://img.shields.io/github/last-commit/Seance1723/UI-UX-Skills?logo=github)](https://github.com/Seance1723/UI-UX-Skills/commits/main)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)
+
+**The ultimate UI/UX skill for AI coding agents.** Turn your AI into a Senior Product Designer, UX Researcher, and Frontend Lead in seconds.
+
+Author: Rupak Biswas.
 
 Use it with a normal prompt plus one trigger:
 
@@ -16,6 +25,15 @@ Most AI UI prompts produce pretty screens but miss the hard parts: research assu
 
 UI/UX Master is built to make agents behave like a senior product designer, UX researcher, accessibility reviewer, design-system lead, and frontend handoff partner in one workflow.
 
+## 🚀 Supercharge Your AI Workflow
+
+AI agents are great at writing code, but they often struggle with **Information Architecture**, **Accessibility (WCAG)**, and **Design Systems**. `ui-ux-master` bridges this gap. 
+
+By installing this tool, you instantly give **Claude**, **Cursor**, **Windsurf**, **Codex**, **Gemini**, **Antigravity**, and universal/custom-instruction agents the ability to:
+- 🧠 **Think like a designer:** Understand user flows and journey maps before coding.
+- ♿ **Audit for accessibility:** Automatically check for WCAG 2.2 AA compliance and ARIA patterns.
+- 🧩 **Enforce design systems:** Keep your brand colors, typography, and spacing consistent.
+
 ## What Makes It Different
 
 | Common open-source prompt/skill | UI/UX Master |
@@ -28,6 +46,17 @@ UI/UX Master is built to make agents behave like a senior product designer, UX r
 | Weak accessibility coverage | WCAG 2.2 AA plus advanced ARIA/widget patterns and test matrix |
 | No deployment validation | Release validator, npm package metadata, tests, and deployment zip builder |
 | No product-risk coverage | Ethics, privacy, dark-pattern, high-risk domain, AI-interface, and inclusive-design checks |
+| Hidden from AI tooling | Ships `llms.txt`, machine-readable manifest, system prompt add-ons, and a local MCP server for automatic discovery |
+
+## AI Discoverability
+
+UI/UX Master is now designed for both humans and AI systems to discover:
+
+- `llms.txt` gives agents a concise map of the package.
+- `ai-discovery/ui-ux-master.manifest.json` provides a machine-readable manifest.
+- `system-prompts/` contains full, compact, and MCP-focused system prompt add-ons.
+- `ui-ux-master-mcp` exposes the package through a local MCP server with tools, resources, and prompts.
+- Project installs copy these discovery assets into `.ui-ux-master/` so no-save `npx` installs remain usable after the npm cache disappears.
 
 ## Capabilities
 
@@ -81,6 +110,25 @@ Dry run:
 npx ui-ux-master install --project --dry-run
 ```
 
+## Package
+
+| Channel | Package | Purpose |
+|---|---|---|
+| npmjs | [`ui-ux-master`](https://www.npmjs.com/package/ui-ux-master) | Primary public package for normal installs and `npx` usage |
+| GitHub | [`Seance1723/UI-UX-Skills`](https://github.com/Seance1723/UI-UX-Skills) | Source, issues, releases, workflows, and open-source collaboration |
+| GitHub Packages | Optional scoped mirror | Use only if you want the repository Packages section to show a package |
+
+The canonical npm package is intentionally unscoped as `ui-ux-master`. GitHub Packages requires npm packages to be scoped, so a GitHub Packages mirror should use `@seance1723/ui-ux-master` while the public npmjs package remains `ui-ux-master`.
+
+Package entrypoints:
+
+- `ui-ux-master` - CLI installer and project integration tool.
+- `ui-ux-master-mcp` - local MCP server for tools, resources, and prompts.
+- `import { assets, bins, trigger } from "ui-ux-master"` - lightweight ESM metadata API.
+- `require("ui-ux-master")` - CommonJS metadata API.
+
+Package metadata is connected to GitHub through `repository`, `homepage`, `bugs`, license, funding, exports, engines, and npm provenance-ready publish settings in `package.json`.
+
 ## Supported Agents
 
 | Agent | Install target | Trigger |
@@ -92,9 +140,43 @@ npx ui-ux-master install --project --dry-run
 | Gemini CLI | `GEMINI.md` marked section | type `/ui-ux-master` |
 | Cursor | `.cursor/rules/ui-ux-master.mdc` | type `/ui-ux-master` |
 | Other agents | `agent-templates/universal/ui-ux-master-trigger.md` | copy trigger into instruction file |
+| MCP clients | `ui-ux-master-mcp` | discover tools/resources/prompts automatically |
 
 See `docs/slash-command-compatibility.md` for details.
 
+## System Prompt Add-ons
+
+Copy one of these into any AI custom-instructions field when the agent does not support project rules:
+
+- `system-prompts/ui-ux-master-system-add-on.md` — full add-on.
+- `system-prompts/ui-ux-master-compact.md` — compact add-on.
+- `system-prompts/ui-ux-master-mcp-add-on.md` — MCP-focused add-on.
+
+## MCP Server
+
+Run the local MCP server:
+
+```bash
+ui-ux-master-mcp
+# or without global install
+npx -y --package ui-ux-master ui-ux-master-mcp
+```
+
+MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "ui-ux-master": {
+      "command": "npx",
+      "args": ["-y", "--package", "ui-ux-master", "ui-ux-master-mcp"]
+    }
+  }
+}
+```
+
+See `docs/mcp-server.md` for tools, resources, prompts, and Hermes config.
+
 ## Usage Examples
 
 ```text
@@ -126,21 +208,42 @@ ui-ux-master install --project --agents claude,codex,windsurf,antigravity,gemini
 ui-ux-master install --project --dry-run
 ui-ux-master doctor
 ui-ux-master where
+ui-ux-master mcp
+ui-ux-master-mcp
 ui-ux-master uninstall --project
 ```
 
 ## Package Structure
 
 - `SKILL.md` — main orchestration skill.
+- `index.mjs`, `index.cjs`, `index.d.ts` — ESM, CommonJS, and TypeScript metadata entrypoints.
 - `references/` — advanced playbooks and standards-aligned checklists.
 - `templates/` — briefs, audits, component specs, design-system specs, and project UI/UX memory template.
 - `agent-templates/` — Claude, Codex, Windsurf, Antigravity, Gemini, Cursor, and universal `/ui-ux-master` activation rules.
-- `docs/` — cross-agent slash-command compatibility docs.
+- `docs/` — cross-agent slash-command compatibility docs and MCP server docs.
+- `system-prompts/` — full, compact, and MCP-focused system prompt add-ons.
+- `ai-discovery/` — machine-readable discovery manifest.
+- `llms.txt` — AI-readable package map.
 - `bin/ui-ux-master.mjs` — npm CLI installer.
+- `bin/ui-ux-master-mcp.mjs` — local MCP server.
 - `scripts/validate_skill.py` — dependency-free release validator.
 - `scripts/build_deployment_zip.py` — clean deployment zip builder.
 - `tests/` — npm installer and package smoke tests.
 
+## GitHub Repository Setup
+
+Recommended About section:
+
+- Description: `Opt-in UI/UX master skill, CLI, and MCP server for AI coding agents. Accessibility, design systems, UX research, and frontend handoff in one workflow.`
+- Website: `https://www.npmjs.com/package/ui-ux-master`
+- Enable releases and issues. Enable discussions when you are ready to support community questions.
+
+Recommended GitHub topics:
+
+`ai-agent`, `ai-coding`, `ui-ux`, `ux-research`, `product-design`, `design-system`, `accessibility`, `wcag`, `mcp`, `model-context-protocol`, `claude-code`, `codex`, `windsurf`, `cursor`, `gemini-cli`, `npm-package`, `cli`, `prompt-engineering`, `frontend`, `llms-txt`
+
+For publishing and registry details, see `docs/package-publishing.md`.
+
 ## Validation and Testing
 
 Run from this folder:
@@ -175,6 +278,7 @@ UI/UX Master is designed to outperform narrow UI prompt packs and simple design
 5. Project memory: durable brand/design consistency via `.ui-ux-memory.md`.
 6. Release engineering: npm packaging, CLI installer, validation, tests, and deployment zip.
 7. Advanced risk coverage: ethics, privacy, dark patterns, localization, platform conventions, high-risk domains, and AI UX transparency.
+8. AI discoverability: `llms.txt`, manifest, system prompt add-ons, and local MCP server.
 
 ## Deployment Readiness Checklist
 
@@ -183,6 +287,8 @@ UI/UX Master is designed to outperform narrow UI prompt packs and simple design
 - [ ] `npm pack --dry-run` contains only intended files.
 - [ ] `ui-ux-master install --project --dry-run` works.
 - [ ] Agent templates contain `/ui-ux-master` and do not include local absolute paths.
+- [ ] System prompt add-ons and MCP docs are included and mention `/ui-ux-master`.
+- [ ] MCP smoke test returns `tools/list` and `resources/list` successfully.
 - [ ] No `node_modules`, `__pycache__`, `.pyc`, graphify cache, coverage, logs, secrets, or local credentials are included.
 
 ## Known Limitations

package/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: ui-ux-master
 description: "Use when an agent must design, audit, improve, prototype, specify, or hand off any UI/UX work end-to-end. Provides one-stop UX strategy, research, IA, flows, wireframes, visual design, design systems, accessibility, usability testing, conversion, and engineering handoff workflows."
-version: 1.1.0
-author: Hermes Agent
+version: 1.2.1
+author: Rupak Biswas
 license: MIT
 platforms: [linux, macos, windows]
 metadata:
@@ -19,15 +19,26 @@ This is a one-stop UI/UX skill for agents. Use it whenever the user asks for any
 
 The job is not only to make screens look good. The job is to solve the user's goal with a usable, accessible, coherent, implementable interface. Always connect design choices to user needs, product goals, content, system constraints, and measurable outcomes.
 
-## Cross-Agent Activation
+## Cross-Agent Activation
+
+This skill is opt-in. In Codex, Claude, Windsurf, Antigravity, Gemini, Cursor, and other agents, activate it only when the user includes `/ui-ux-master` in the prompt or invokes the installed native slash command. If the user does not mention `/ui-ux-master`, do not apply this skill automatically.
+
+When activated, the user can write naturally, for example: `/ui-ux-master audit this checkout flow` or `/ui-ux-master design a premium SaaS landing page`. Treat the rest of the prompt as the task and follow this SKILL.md plus the referenced files.
 
-This skill is opt-in. In Codex, Claude, Windsurf, Antigravity, Gemini, Cursor, and other agents, activate it only when the user includes `/ui-ux-master` in the prompt or invokes the installed native slash command. If the user does not mention `/ui-ux-master`, do not apply this skill automatically.
+## AI Discovery and MCP
 
-When activated, the user can write naturally, for example: `/ui-ux-master audit this checkout flow` or `/ui-ux-master design a premium SaaS landing page`. Treat the rest of the prompt as the task and follow this SKILL.md plus the referenced files.
+This package exposes the workflow through human-readable instructions and machine-readable discovery assets:
 
-## Core Operating Rule
+- `llms.txt` gives AI agents a short map of the package.
+- `ai-discovery/ui-ux-master.manifest.json` describes activation, entrypoints, tools, resources, prompts, and supported agents.
+- `system-prompts/` contains full, compact, and MCP-focused system prompt add-ons.
+- `bin/ui-ux-master-mcp.mjs` runs a local read-only MCP server that exposes UI/UX Master tools, resources, and prompts.
 
-Do not jump directly to visuals. Work in this order unless the user explicitly asks for a narrow task:
+Use MCP and system prompt add-ons only as discovery/activation layers. The workflow remains opt-in and should still require `/ui-ux-master` unless the user explicitly asks to use UI/UX Master.
+
+## Core Operating Rule
+
+Do not jump directly to visuals. Work in this order unless the user explicitly asks for a narrow task:
 
 1. Check for existing UI/UX memory and branding first: `.ui-ux-memory.md`, design tokens, CSS variables, theme files, existing components, fonts, color scheme, and representative screens.
 2. If memory exists, follow it as the design baseline. If no memory exists, create one for the application using `templates/ui-ux-memory.md` after inspecting existing branding or asking minimum high-value questions for a fresh project.
@@ -693,22 +704,29 @@ Use the supporting files in this skill folder when useful:
 - `references/ui-ux-frontend-implementation-rules.md` — mandatory frontend implementation rules so agents do not miss stack inspection, states, accessibility, responsiveness, tokens, QA, or handoff.
 - `references/wcag-aa-quick-reference.md` — practical WCAG 2.2 AA reference for agents.
 - `references/design-system-playbook.md` — how to create or extend a design system.
-- `references/top-100-brand-website-analysis.md` — top global brand website patterns and reusable frontend methods.
-- `references/ux-research-methods.md` — research planning, method selection, evidence confidence, and ethical research rules.
-- `references/usability-heuristics.md` — heuristic review, cognitive rules, and severity scoring.
-- `references/platform-guidelines.md` — web, iOS, Android/Material, Windows, desktop, kiosk, email, TV, and cross-platform rules.
-- `references/content-design-and-i18n.md` — UX writing, microcopy, localization, RTL, and content handoff.
-- `references/ux-measurement-quality-gates.md` — task success metrics, UX measurement, accessibility gates, and definition of done.
-- `references/ethical-inclusive-design.md` — dark-pattern avoidance, privacy UX, inclusive design, high-risk and AI interface rules.
-- `references/service-design-journey-mapping.md` — journey maps, service blueprints, support handoff, and omnichannel checks.
-- `references/data-visualization-dashboard-ux.md` — dashboard, table, chart, data-grid, and alerting UX rules.
-- `references/accessibility-advanced-patterns.md` — complex widget accessibility and screen-reader test matrix.
-- `references/ui-ux-curriculum-and-standards.md` — basic-to-advanced UI/UX curriculum and standards map.
-- `references/competitive-landscape.md` — competitor gaps and strategy for staying ahead.
+- `references/top-100-brand-website-analysis.md` — top global brand website patterns and reusable frontend methods.
+- `references/ux-research-methods.md` — research planning, method selection, evidence confidence, and ethical research rules.
+- `references/usability-heuristics.md` — heuristic review, cognitive rules, and severity scoring.
+- `references/platform-guidelines.md` — web, iOS, Android/Material, Windows, desktop, kiosk, email, TV, and cross-platform rules.
+- `references/content-design-and-i18n.md` — UX writing, microcopy, localization, RTL, and content handoff.
+- `references/ux-measurement-quality-gates.md` — task success metrics, UX measurement, accessibility gates, and definition of done.
+- `references/ethical-inclusive-design.md` — dark-pattern avoidance, privacy UX, inclusive design, high-risk and AI interface rules.
+- `references/service-design-journey-mapping.md` — journey maps, service blueprints, support handoff, and omnichannel checks.
+- `references/data-visualization-dashboard-ux.md` — dashboard, table, chart, data-grid, and alerting UX rules.
+- `references/accessibility-advanced-patterns.md` — complex widget accessibility and screen-reader test matrix.
+- `references/ui-ux-curriculum-and-standards.md` — basic-to-advanced UI/UX curriculum and standards map.
+- `references/competitive-landscape.md` — competitor gaps and strategy for staying ahead.
 - `docs/slash-command-compatibility.md` — cross-agent `/ui-ux-master` trigger compatibility.
+- `docs/mcp-server.md` — MCP tools, resources, prompts, client configs, and smoke testing.
+- `llms.txt` — AI-readable package map for discovery by agents and indexing tools.
+- `ai-discovery/ui-ux-master.manifest.json` — machine-readable manifest for activation, entrypoints, MCP, and capabilities.
+- `system-prompts/ui-ux-master-system-add-on.md` — full system prompt add-on.
+- `system-prompts/ui-ux-master-compact.md` — compact system prompt add-on.
+- `system-prompts/ui-ux-master-mcp-add-on.md` — MCP-focused system prompt add-on.
 - `agent-templates/` — Claude, Codex, Windsurf, Antigravity, Gemini, Cursor, and universal installer templates.
 - `bin/ui-ux-master.mjs` — npm CLI installer.
-- `templates/ui-ux-brief.md` — intake and requirements template.
+- `bin/ui-ux-master-mcp.mjs` — local read-only MCP server.
+- `templates/ui-ux-brief.md` — intake and requirements template.
 - `templates/ui-ux-memory.md` — project UI/UX memory file template to copy into an application root as `.ui-ux-memory.md`.
 - `templates/ui-ux-audit-report.md` — audit output template.
 - `templates/component-spec.md` — component handoff template.

package/ai-discovery/ui-ux-master.manifest.json

@@ -0,0 +1,84 @@
+{
+  "schema_version": "1.0",
+  "name": "ui-ux-master",
+  "title": "UI/UX Master",
+  "version": "1.2.0",
+  "author": "Rupak Biswas",
+  "description": "One-stop UI/UX master skill for AI agents with opt-in /ui-ux-master activation, system prompt add-ons, project-local skill assets, and local MCP discovery.",
+  "activation": {
+    "trigger": "/ui-ux-master",
+    "mode": "opt-in-only",
+    "do_not_auto_apply_without_trigger": true
+  },
+  "entrypoints": {
+    "skill": "SKILL.md",
+    "readme": "README.md",
+    "llms": "llms.txt",
+    "mcp_server_bin": "ui-ux-master-mcp",
+    "cli_bin": "ui-ux-master"
+  },
+  "system_prompt_addons": [
+    "system-prompts/ui-ux-master-system-add-on.md",
+    "system-prompts/ui-ux-master-compact.md",
+    "system-prompts/ui-ux-master-mcp-add-on.md"
+  ],
+  "mcp": {
+    "server_name": "ui-ux-master",
+    "transport": "stdio",
+    "command": "npx",
+    "args": ["-y", "--package", "ui-ux-master", "ui-ux-master-mcp"],
+    "tools": [
+      "get_skill",
+      "list_assets",
+      "get_asset",
+      "generate_system_prompt",
+      "create_memory_template",
+      "install_instructions"
+    ],
+    "resources": [
+      "ui-ux-master://skill",
+      "ui-ux-master://readme",
+      "ui-ux-master://llms",
+      "ui-ux-master://manifest",
+      "ui-ux-master://system-prompt",
+      "ui-ux-master://compact-prompt",
+      "ui-ux-master://mcp-prompt",
+      "ui-ux-master://mcp-docs",
+      "ui-ux-master://checklist",
+      "ui-ux-master://memory-template"
+    ],
+    "prompts": [
+      "ui-ux-master",
+      "ui-ux-audit",
+      "ui-ux-redesign",
+      "ui-ux-design-system",
+      "ui-ux-accessibility-review"
+    ]
+  },
+  "supported_agents": [
+    "Claude Code",
+    "Codex",
+    "Windsurf",
+    "Antigravity",
+    "Gemini CLI",
+    "Cursor",
+    "MCP clients",
+    "Universal agents"
+  ],
+  "capabilities": [
+    "UX strategy",
+    "UX research planning",
+    "information architecture",
+    "user flows",
+    "wireframes",
+    "visual design direction",
+    "design systems",
+    "accessibility",
+    "responsive design",
+    "content design",
+    "localization",
+    "ethical UX",
+    "frontend implementation handoff",
+    "QA and acceptance criteria"
+  ]
+}

package/bin/ui-ux-master-mcp.mjs

@@ -0,0 +1,243 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import readline from 'node:readline';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const packageRoot = path.resolve(path.dirname(__filename), '..');
+const protocolVersion = '2024-11-05';
+
+const assetMap = {
+  skill: 'SKILL.md',
+  readme: 'README.md',
+  llms: 'llms.txt',
+  manifest: 'ai-discovery/ui-ux-master.manifest.json',
+  system_prompt: 'system-prompts/ui-ux-master-system-add-on.md',
+  compact_prompt: 'system-prompts/ui-ux-master-compact.md',
+  mcp_prompt: 'system-prompts/ui-ux-master-mcp-add-on.md',
+  mcp_docs: 'docs/mcp-server.md',
+  slash_docs: 'docs/slash-command-compatibility.md',
+  memory_workflow: 'references/ui-ux-memory-workflow.md',
+  frontend_rules: 'references/ui-ux-frontend-implementation-rules.md',
+  complete_checklist: 'references/ui-ux-complete-checklist.md',
+  wcag: 'references/wcag-aa-quick-reference.md',
+  accessibility_patterns: 'references/accessibility-advanced-patterns.md',
+  design_system_playbook: 'references/design-system-playbook.md',
+  memory_template: 'templates/ui-ux-memory.md',
+};
+
+const resourceMap = {
+  'ui-ux-master://skill': 'SKILL.md',
+  'ui-ux-master://readme': 'README.md',
+  'ui-ux-master://llms': 'llms.txt',
+  'ui-ux-master://manifest': 'ai-discovery/ui-ux-master.manifest.json',
+  'ui-ux-master://system-prompt': 'system-prompts/ui-ux-master-system-add-on.md',
+  'ui-ux-master://compact-prompt': 'system-prompts/ui-ux-master-compact.md',
+  'ui-ux-master://mcp-prompt': 'system-prompts/ui-ux-master-mcp-add-on.md',
+  'ui-ux-master://mcp-docs': 'docs/mcp-server.md',
+  'ui-ux-master://checklist': 'references/ui-ux-complete-checklist.md',
+  'ui-ux-master://memory-template': 'templates/ui-ux-memory.md',
+};
+
+function readRel(rel) {
+  const full = path.resolve(packageRoot, rel);
+  if (!full.startsWith(packageRoot)) throw new Error('Path escapes package root');
+  return fs.readFileSync(full, 'utf8');
+}
+
+function textContent(text) {
+  return [{ type: 'text', text }];
+}
+
+function jsonText(obj) {
+  return textContent(JSON.stringify(obj, null, 2));
+}
+
+function tool(name, description, properties = {}, required = []) {
+  return {
+    name,
+    description,
+    inputSchema: {
+      type: 'object',
+      properties,
+      required,
+      additionalProperties: false,
+    },
+  };
+}
+
+function listTools() {
+  return [
+    tool('get_skill', 'Return the main UI/UX Master SKILL.md content.', {}, []),
+    tool('list_assets', 'List discoverable UI/UX Master assets, references, prompts, and resources.', {}, []),
+    tool('get_asset', 'Return a named package asset such as skill, readme, system_prompt, complete_checklist, or memory_template.', {
+      name: { type: 'string', description: `Asset name. Allowed: ${Object.keys(assetMap).join(', ')}` },
+    }, ['name']),
+    tool('generate_system_prompt', 'Generate a system prompt add-on for an AI agent.', {
+      mode: { type: 'string', enum: ['full', 'compact', 'mcp'], default: 'full' },
+      agent: { type: 'string', description: 'Optional target agent name such as Claude, Codex, Windsurf, Cursor, Gemini, Antigravity, or universal.' },
+    }, []),
+    tool('create_memory_template', 'Return a project .ui-ux-memory.md template with optional project name inserted.', {
+      projectName: { type: 'string', description: 'Optional project/product name.' },
+    }, []),
+    tool('install_instructions', 'Return install instructions for npm, project agent rules, or MCP clients.', {
+      target: { type: 'string', enum: ['npm', 'project', 'global', 'mcp', 'claude-desktop', 'hermes', 'cursor', 'codex', 'windsurf', 'gemini', 'antigravity', 'universal'], default: 'project' },
+    }, []),
+  ];
+}
+
+function callTool(name, args = {}) {
+  switch (name) {
+    case 'get_skill':
+      return { content: textContent(readRel('SKILL.md')) };
+    case 'list_assets':
+      return { content: jsonText({ assets: assetMap, resources: Object.keys(resourceMap), prompts: listPrompts().map(p => p.name), tools: listTools().map(t => t.name) }) };
+    case 'get_asset': {
+      const rel = assetMap[args.name];
+      if (!rel) throw new Error(`Unknown asset '${args.name}'. Use list_assets first.`);
+      return { content: textContent(readRel(rel)) };
+    }
+    case 'generate_system_prompt': {
+      const mode = args.mode || 'full';
+      const rel = mode === 'compact' ? assetMap.compact_prompt : mode === 'mcp' ? assetMap.mcp_prompt : assetMap.system_prompt;
+      const agentLine = args.agent ? `\n\nTarget agent: ${args.agent}. Keep the /ui-ux-master opt-in rule and use that agent's instruction format when applying this add-on.\n` : '';
+      return { content: textContent(readRel(rel) + agentLine) };
+    }
+    case 'create_memory_template': {
+      let text = readRel('templates/ui-ux-memory.md');
+      if (args.projectName) text = text.replace('# UI/UX Memory', `# UI/UX Memory — ${args.projectName}`);
+      return { content: textContent(text) };
+    }
+    case 'install_instructions':
+      return { content: textContent(installInstructions(args.target || 'project')) };
+    default:
+      throw new Error(`Unknown tool '${name}'`);
+  }
+}
+
+function installInstructions(target) {
+  const common = 'After install, activate with: /ui-ux-master <your normal UI/UX request>';
+  const map = {
+    npm: 'npm install -g ui-ux-master\nui-ux-master install --global',
+    project: 'npm install --save-dev ui-ux-master\nnpx ui-ux-master install --project',
+    global: 'npm install -g ui-ux-master\nui-ux-master install --global',
+    mcp: 'npx -y --package ui-ux-master ui-ux-master-mcp\n# or after install: ui-ux-master-mcp',
+    hermes: 'mcp_servers:\n  ui_ux_master:\n    command: "npx"\n    args: ["-y", "--package", "ui-ux-master", "ui-ux-master-mcp"]',
+    'claude-desktop': '{\n  "mcpServers": {\n    "ui-ux-master": {\n      "command": "npx",\n      "args": ["-y", "--package", "ui-ux-master", "ui-ux-master-mcp"]\n    }\n  }\n}',
+    cursor: 'npx ui-ux-master install --project --agents cursor',
+    codex: 'npx ui-ux-master install --project --agents codex',
+    windsurf: 'npx ui-ux-master install --project --agents windsurf',
+    gemini: 'npx ui-ux-master install --project --agents gemini',
+    antigravity: 'npx ui-ux-master install --project --agents antigravity',
+    universal: 'Copy system-prompts/ui-ux-master-system-add-on.md into the agent custom instructions, or run npx ui-ux-master install --project --agents universal',
+  };
+  return `${map[target] || map.project}\n\n${common}`;
+}
+
+function listResources() {
+  return Object.entries(resourceMap).map(([uri, rel]) => ({
+    uri,
+    name: path.basename(rel),
+    description: `UI/UX Master asset: ${rel}`,
+    mimeType: rel.endsWith('.json') ? 'application/json' : 'text/markdown',
+  }));
+}
+
+function readResource(uri) {
+  const rel = resourceMap[uri];
+  if (!rel) throw new Error(`Unknown resource '${uri}'`);
+  return { contents: [{ uri, mimeType: rel.endsWith('.json') ? 'application/json' : 'text/markdown', text: readRel(rel) }] };
+}
+
+function listPrompts() {
+  return [
+    { name: 'ui-ux-master', description: 'Activate the full UI/UX Master workflow for a normal user task.', arguments: [{ name: 'task', description: 'The user UI/UX request.', required: true }] },
+    { name: 'ui-ux-audit', description: 'Audit a screen, flow, app, or URL for UX, UI, accessibility, and handoff issues.', arguments: [{ name: 'target', description: 'What to audit.', required: true }] },
+    { name: 'ui-ux-redesign', description: 'Redesign a product area while preserving or intentionally evolving brand conventions.', arguments: [{ name: 'target', description: 'What to redesign.', required: true }] },
+    { name: 'ui-ux-design-system', description: 'Create or extend a design system with tokens, components, governance, and QA.', arguments: [{ name: 'scope', description: 'Product/component scope.', required: true }] },
+    { name: 'ui-ux-accessibility-review', description: 'Run a WCAG-focused accessibility and interaction review.', arguments: [{ name: 'target', description: 'Screen, component, or flow.', required: true }] },
+  ];
+}
+
+function getPrompt(name, args = {}) {
+  const task = args.task || args.target || args.scope || 'the requested UI/UX work';
+  const map = {
+    'ui-ux-master': `/ui-ux-master ${task}\n\nUse the full UI/UX Master workflow. Check UI/UX memory first. Produce implementation-ready output.`,
+    'ui-ux-audit': `/ui-ux-master audit ${task} for UX clarity, accessibility, responsive behavior, content, trust, conversion, states, and implementation quality. Return prioritized findings and fixes.`,
+    'ui-ux-redesign': `/ui-ux-master redesign ${task}. Preserve existing brand/tokens/components unless a redesign is requested. Include IA, flow, layout, states, accessibility, responsive rules, copy, and developer handoff.`,
+    'ui-ux-design-system': `/ui-ux-master create or extend a design system for ${task}. Include tokens, components, variants, states, accessibility, governance, examples, QA, and acceptance criteria.`,
+    'ui-ux-accessibility-review': `/ui-ux-master review ${task} for WCAG 2.2 AA, keyboard, focus, semantics, screen reader behavior, contrast, motion, forms, error recovery, and test coverage.`,
+  };
+  if (!map[name]) throw new Error(`Unknown prompt '${name}'`);
+  return { messages: [{ role: 'user', content: { type: 'text', text: map[name] } }] };
+}
+
+function ok(id, result) {
+  process.stdout.write(JSON.stringify({ jsonrpc: '2.0', id, result }) + '\n');
+}
+
+function err(id, error, code = -32603) {
+  process.stdout.write(JSON.stringify({ jsonrpc: '2.0', id, error: { code, message: error?.message || String(error) } }) + '\n');
+}
+
+function handle(message) {
+  const { id, method, params = {} } = message;
+  try {
+    if (method === 'initialize') {
+      ok(id, {
+        protocolVersion,
+        capabilities: { tools: {}, resources: {}, prompts: {} },
+        serverInfo: { name: 'ui-ux-master', version: readPackageVersion() },
+      });
+    } else if (method === 'notifications/initialized') {
+      // no response for notifications
+    } else if (method === 'ping') {
+      ok(id, {});
+    } else if (method === 'tools/list') {
+      ok(id, { tools: listTools() });
+    } else if (method === 'tools/call') {
+      ok(id, callTool(params.name, params.arguments || {}));
+    } else if (method === 'resources/list') {
+      ok(id, { resources: listResources() });
+    } else if (method === 'resources/read') {
+      ok(id, readResource(params.uri));
+    } else if (method === 'prompts/list') {
+      ok(id, { prompts: listPrompts() });
+    } else if (method === 'prompts/get') {
+      ok(id, getPrompt(params.name, params.arguments || {}));
+    } else {
+      err(id, new Error(`Method not found: ${method}`), -32601);
+    }
+  } catch (e) {
+    err(id, e);
+  }
+}
+
+function readPackageVersion() {
+  try {
+    return JSON.parse(readRel('package.json')).version || '0.0.0';
+  } catch {
+    return '0.0.0';
+  }
+}
+
+function printHelp() {
+  console.log(`UI/UX Master MCP Server\n\nRun over stdio for MCP clients:\n  ui-ux-master-mcp\n\nExample client config:\n{\n  "mcpServers": {\n    "ui-ux-master": {\n      "command": "npx",\n      "args": ["-y", "--package", "ui-ux-master", "ui-ux-master-mcp"]\n    }\n  }\n}`);
+}
+
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  printHelp();
+  process.exit(0);
+}
+
+const rl = readline.createInterface({ input: process.stdin, crlfDelay: Infinity });
+rl.on('line', (line) => {
+  const trimmed = line.trim();
+  if (!trimmed) return;
+  try {
+    handle(JSON.parse(trimmed));
+  } catch (e) {
+    err(null, e);
+  }
+});

package/bin/ui-ux-master.mjs

@@ -81,8 +81,8 @@ function wanted(opts, name) {
 
 function copyProjectSkillAssets(root, dryRun) {
   const dest = path.join(root, '.ui-ux-master');
-  const files = ['SKILL.md', 'README.md', 'LICENSE', 'package.json'];
-  const dirs = ['references', 'templates', 'docs'];
+  const files = ['SKILL.md', 'README.md', 'LICENSE', 'package.json', 'llms.txt'];
+  const dirs = ['references', 'templates', 'docs', 'system-prompts', 'ai-discovery'];
   for (const file of files) {
     writeFile(path.join(dest, file), read(file), dryRun);
   }
@@ -161,7 +161,7 @@ function doctor(opts) {
   console.log(`target root: ${root}`);
   console.log(`node: ${process.version}`);
   console.log(`trigger: /ui-ux-master`);
-  const required = ['SKILL.md', 'README.md', 'references/ui-ux-complete-checklist.md', 'agent-templates/universal/ui-ux-master-trigger.md'];
+  const required = ['SKILL.md', 'README.md', 'llms.txt', 'references/ui-ux-complete-checklist.md', 'agent-templates/universal/ui-ux-master-trigger.md', 'system-prompts/ui-ux-master-system-add-on.md', 'docs/mcp-server.md', 'bin/ui-ux-master-mcp.mjs'];
   let ok = true;
   for (const rel of required) {
     const exists = fs.existsSync(path.join(packageRoot, rel));
@@ -172,7 +172,7 @@ function doctor(opts) {
 }
 
 function help() {
-  console.log(`UI/UX Master\n\nUsage:\n  ui-ux-master install [--project|--global] [--agents claude,codex,windsurf,antigravity,gemini,cursor,universal] [--dir path] [--dry-run]\n  ui-ux-master uninstall [--project] [--dir path] [--dry-run]\n  ui-ux-master doctor [--dir path]\n  ui-ux-master where\n\nAfter install, use: /ui-ux-master <your normal UI/UX prompt>`);
+  console.log(`UI/UX Master\n\nUsage:\n  ui-ux-master install [--project|--global] [--agents claude,codex,windsurf,antigravity,gemini,cursor,universal] [--dir path] [--dry-run]\n  ui-ux-master uninstall [--project] [--dir path] [--dry-run]\n  ui-ux-master doctor [--dir path]\n  ui-ux-master where\n  ui-ux-master mcp\n  ui-ux-master-mcp\n\nAfter install, use: /ui-ux-master <your normal UI/UX prompt>\nMCP: npx -y --package ui-ux-master ui-ux-master-mcp`);
 }
 
 const opts = parseArgs(process.argv.slice(2));
@@ -185,6 +185,8 @@ if (opts.postinstall) {
   uninstallProject(findProjectRoot(opts.dir || process.cwd()), opts);
 } else if (opts.command === 'doctor') {
   doctor(opts);
+} else if (opts.command === 'mcp' || opts.command === 'ui-ux-master-mcp') {
+  await import('./ui-ux-master-mcp.mjs');
 } else if (opts.command === 'where') {
   console.log(packageRoot);
 } else {