ui-ux-master 1.1.0 → 1.2.0

package/README.md

@@ -1,6 +1,12 @@
-# UI/UX Master
+# UI/UX Master 🎨✨
 
-The one-stop UI/UX skill for AI coding agents.
+[![npm version](https://badge.fury.io/js/ui-ux-master.svg)](https://badge.fury.io/js/ui-ux-master)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![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 +22,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 +43,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
 
@@ -92,9 +118,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,6 +186,8 @@ 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
 ```
 
@@ -135,8 +197,12 @@ ui-ux-master uninstall --project
 - `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.
@@ -175,6 +241,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 +250,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.0
+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 {

package/docs/mcp-server.md

@@ -0,0 +1,106 @@
+# UI/UX Master MCP Server
+
+UI/UX Master includes a local MCP server so AI clients can discover the skill automatically as tools, resources, and reusable prompts.
+
+## Why MCP Matters
+
+MCP lets compatible AI clients discover local capabilities without relying only on human-readable README files. Project installs also copy the same assets into `.ui-ux-master/`, so MCP clients and text-trigger agents can both find the same source of truth. With this package, agents can:
+
+- list UI/UX Master tools;
+- read the main skill and references as MCP resources;
+- retrieve system prompt add-ons;
+- generate project memory templates;
+- get install instructions for supported agents;
+- start common UI/UX workflows through MCP prompts.
+
+## Run the Server
+
+After global install:
+
+```bash
+ui-ux-master-mcp
+```
+
+Without global install:
+
+```bash
+npx -y --package ui-ux-master ui-ux-master-mcp
+```
+
+The server communicates over stdio using JSON-RPC/MCP-compatible methods.
+
+## Claude Desktop / MCP Client Config
+
+```json
+{
+  "mcpServers": {
+    "ui-ux-master": {
+      "command": "npx",
+      "args": ["-y", "--package", "ui-ux-master", "ui-ux-master-mcp"]
+    }
+  }
+}
+```
+
+## Hermes Native MCP Config
+
+```yaml
+mcp_servers:
+  ui_ux_master:
+    command: "npx"
+    args: ["-y", "--package", "ui-ux-master", "ui-ux-master-mcp"]
+```
+
+Restart the agent after adding the config so it can discover the tools.
+
+## Tools
+
+| Tool | Purpose |
+|---|---|
+| `get_skill` | Return the main `SKILL.md` content. |
+| `list_assets` | List discoverable assets, resources, prompts, and tools. |
+| `get_asset` | Return a named asset such as `system_prompt`, `complete_checklist`, `memory_template`, or `frontend_rules`. |
+| `generate_system_prompt` | Generate full, compact, or MCP-focused system prompt add-ons. |
+| `create_memory_template` | Return a `.ui-ux-memory.md` template, optionally with a project name. |
+| `install_instructions` | Return install instructions for npm, project, global, MCP, Hermes, Claude Desktop, Cursor, Codex, Windsurf, Gemini, Antigravity, or universal agents. |
+
+## Resources
+
+| URI | Content |
+|---|---|
+| `ui-ux-master://skill` | Main skill. |
+| `ui-ux-master://readme` | README. |
+| `ui-ux-master://llms` | AI discovery text. |
+| `ui-ux-master://manifest` | Machine-readable AI manifest. |
+| `ui-ux-master://system-prompt` | Full system prompt add-on. |
+| `ui-ux-master://compact-prompt` | Compact system prompt add-on. |
+| `ui-ux-master://mcp-prompt` | MCP-focused prompt add-on. |
+| `ui-ux-master://mcp-docs` | This document. |
+| `ui-ux-master://checklist` | Complete UI/UX checklist. |
+| `ui-ux-master://memory-template` | UI/UX memory template. |
+
+## Prompts
+
+| Prompt | Purpose |
+|---|---|
+| `ui-ux-master` | Activate the full workflow for a normal UI/UX task. |
+| `ui-ux-audit` | Audit a screen, product, flow, URL, or component. |
+| `ui-ux-redesign` | Redesign a product area with handoff-ready output. |
+| `ui-ux-design-system` | Create or extend tokens, components, governance, and QA. |
+| `ui-ux-accessibility-review` | Perform a WCAG-focused accessibility review. |
+
+## Manual Smoke Test
+
+```bash
+printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}\n{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}\n' | node bin/ui-ux-master-mcp.mjs
+```
+
+Expected output: JSON-RPC responses containing server info and a tools array.
+
+## Security
+
+The MCP server is read-only. It exposes package content and generated prompt text. It does not write files, execute shell commands, read arbitrary paths, or access credentials.
+
+## Activation Reminder
+
+Even through MCP, UI/UX Master remains opt-in. Use the workflow only when the user includes `/ui-ux-master` or explicitly asks to use UI/UX Master.

package/llms.txt

@@ -0,0 +1,24 @@
+# llms.txt
+
+# UI/UX Master
+
+> One-stop UI/UX master skill for AI coding agents. Activate with `/ui-ux-master` only.
+
+Important files for AI discovery:
+
+- `SKILL.md`: primary orchestration skill.
+- `README.md`: installation, usage, positioning, validation, and package details.
+- `system-prompts/ui-ux-master-system-add-on.md`: full system prompt add-on.
+- `system-prompts/ui-ux-master-compact.md`: compact add-on for short custom-instruction fields.
+- `system-prompts/ui-ux-master-mcp-add-on.md`: MCP usage instructions.
+- `docs/mcp-server.md`: MCP server tools, resources, prompts, and client config.
+- `docs/slash-command-compatibility.md`: cross-agent `/ui-ux-master` behavior.
+- `ai-discovery/ui-ux-master.manifest.json`: machine-readable package manifest.
+
+Activation rule:
+
+Use UI/UX Master only when the user includes `/ui-ux-master`. If the user does not include `/ui-ux-master`, do not apply this workflow automatically.
+
+MCP:
+
+Run `ui-ux-master-mcp` or `npx -y --package ui-ux-master ui-ux-master-mcp` to expose the package as local MCP tools/resources/prompts.

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "ui-ux-master",
-  "version": "1.1.0",
-  "description": "One-stop UI/UX master skill for AI agents with opt-in /ui-ux-master activation across Claude, Codex, Windsurf, Antigravity, Gemini, Cursor, and universal agents.",
+  "version": "1.2.0",
+  "description": "One-stop UI/UX master skill for AI agents with opt-in /ui-ux-master activation, system prompt add-ons, AI discovery assets, and local MCP server support.",
   "type": "module",
   "bin": {
-    "ui-ux-master": "./bin/ui-ux-master.mjs"
+    "ui-ux-master": "./bin/ui-ux-master.mjs",
+    "ui-ux-master-mcp": "./bin/ui-ux-master-mcp.mjs"
   },
   "files": [
     "SKILL.md",
@@ -15,6 +16,9 @@
     "templates/",
     "agent-templates/",
     "docs/",
+    "system-prompts/",
+    "ai-discovery/",
+    "llms.txt",
     "bin/",
     "scripts/",
     "tests/"
@@ -41,10 +45,15 @@
     "cursor",
     "slash-command",
     "agent-skill",
-    "frontend"
+    "frontend",
+    "mcp",
+    "model-context-protocol",
+    "system-prompt",
+    "ai-discovery",
+    "llms-txt"
   ],
   "license": "MIT",
-  "author": "UI/UX Master contributors",
+  "author": "Rupak Biswas",
   "engines": {
     "node": ">=18"
   },

package/scripts/validate_skill.py

@@ -21,7 +21,14 @@ REQUIRED = [
     "LICENSE",
     "package.json",
     "bin/ui-ux-master.mjs",
+    "bin/ui-ux-master-mcp.mjs",
     "docs/slash-command-compatibility.md",
+    "docs/mcp-server.md",
+    "llms.txt",
+    "ai-discovery/ui-ux-master.manifest.json",
+    "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",
     "agent-templates/claude/commands/ui-ux-master.md",
     "agent-templates/universal/ui-ux-master-trigger.md",
     "agent-templates/codex/AGENTS.append.md",
@@ -77,11 +84,17 @@ REQUIRED_PHRASES = [
     "privacy",
     "/ui-ux-master",
     "Cross-Agent Activation",
+    "AI Discovery and MCP",
+    "system prompt",
+    "MCP",
 ]
 
 REQUIRED_HEADINGS = {
     "README.md": ["## Install with npm", "## Supported Agents", "## Competitive Positioning", "## Validation and Testing", "## Deployment Readiness Checklist"],
     "docs/slash-command-compatibility.md": ["## What `/ui-ux-master` Does", "## Native Slash Commands vs Text Triggers", "## Supported Agents"],
+    "docs/mcp-server.md": ["## Why MCP Matters", "## Tools", "## Resources", "## Prompts", "## Security"],
+    "system-prompts/ui-ux-master-system-add-on.md": ["## Activation Rule", "## Source of Truth", "## Required Behavior"],
+    "system-prompts/ui-ux-master-mcp-add-on.md": ["## MCP Discovery", "## Behavior", "## Hermes Example"],
     "references/ux-research-methods.md": ["## Research Decision Tree", "## Research Plan Template", "## Evidence Confidence Levels"],
     "references/usability-heuristics.md": ["## Nielsen's 10 Usability Heuristics", "## Severity Rating"],
     "references/platform-guidelines.md": ["## Web App", "## iOS / Apple Platforms", "## Android / Material", "## Cross-Platform Rule"],
@@ -170,6 +183,8 @@ def check_skill_frontmatter_and_body() -> None:
         fail("description must be <=1024 chars")
     if not description.startswith("Use when"):
         fail('description should start with "Use when"')
+    if fm.get("author") != "Rupak Biswas":
+        fail("SKILL.md author must be Rupak Biswas")
     if len(content) > 100_000:
         fail("SKILL.md exceeds 100,000 characters")
     if len(content) > 45_000:
@@ -185,7 +200,7 @@ def check_package_json() -> None:
         data = json.loads(PACKAGE.read_text(encoding="utf-8"))
     except Exception as exc:
         fail(f"package.json is invalid JSON: {exc}")
-    for key in ["name", "version", "description", "type", "bin", "files", "scripts", "license", "engines"]:
+    for key in ["name", "version", "description", "type", "bin", "files", "scripts", "license", "author", "engines"]:
         if key not in data:
             fail(f"package.json missing {key}")
     if data["name"] != "ui-ux-master":
@@ -196,10 +211,14 @@ def check_package_json() -> None:
         fail("package.json license must be MIT")
     if data.get("bin", {}).get("ui-ux-master") != "./bin/ui-ux-master.mjs":
         fail("package.json bin.ui-ux-master must point to ./bin/ui-ux-master.mjs")
+    if data.get("bin", {}).get("ui-ux-master-mcp") != "./bin/ui-ux-master-mcp.mjs":
+        fail("package.json bin.ui-ux-master-mcp must point to ./bin/ui-ux-master-mcp.mjs")
+    if data.get("author") != "Rupak Biswas":
+        fail("package.json author must be Rupak Biswas")
     for script in ["validate", "test", "prepack"]:
         if script not in data.get("scripts", {}):
             fail(f"package.json scripts missing {script}")
-    required_files = ["SKILL.md", "references/", "templates/", "agent-templates/", "docs/", "bin/", "scripts/", "tests/"]
+    required_files = ["SKILL.md", "references/", "templates/", "agent-templates/", "docs/", "system-prompts/", "ai-discovery/", "llms.txt", "bin/", "scripts/", "tests/"]
     for item in required_files:
         if item not in data.get("files", []):
             fail(f"package.json files missing {item}")
@@ -209,7 +228,7 @@ def check_bin_installer() -> None:
     text = (ROOT / "bin/ui-ux-master.mjs").read_text(encoding="utf-8")
     if not text.startswith("#!/usr/bin/env node"):
         fail("bin/ui-ux-master.mjs must have node shebang")
-    for phrase in ["install", "doctor", "uninstall", "--dry-run", "fileURLToPath", "/ui-ux-master", "copyProjectSkillAssets", ".ui-ux-master"]:
+    for phrase in ["install", "doctor", "uninstall", "--dry-run", "fileURLToPath", "/ui-ux-master", "copyProjectSkillAssets", ".ui-ux-master", "system-prompts", "ai-discovery", "ui-ux-master-mcp"]:
         if phrase not in text:
             fail(f"bin installer missing {phrase}")
     forbidden = ["C:\\", "C:/xampp", "C:/Users", "/home/"]
@@ -234,9 +253,53 @@ def check_agent_templates() -> None:
             fail(f"slash compatibility docs missing {agent}")
 
 
+def check_mcp_server() -> None:
+    text = (ROOT / "bin/ui-ux-master-mcp.mjs").read_text(encoding="utf-8")
+    if not text.startswith("#!/usr/bin/env node"):
+        fail("bin/ui-ux-master-mcp.mjs must have node shebang")
+    for phrase in ["tools/list", "tools/call", "resources/list", "resources/read", "prompts/list", "prompts/get", "ui-ux-master://skill", "generate_system_prompt"]:
+        if phrase not in text:
+            fail(f"MCP server missing {phrase}")
+    for bad in ["C:\\", "C:/xampp", "C:/Users", "/workspace"]:
+        if bad in text:
+            fail(f"MCP server contains local absolute path: {bad}")
+
+
+def check_discovery_assets() -> None:
+    manifest = json.loads((ROOT / "ai-discovery/ui-ux-master.manifest.json").read_text(encoding="utf-8"))
+    if manifest.get("author") != "Rupak Biswas":
+        fail("AI manifest author must be Rupak Biswas")
+    if manifest.get("activation", {}).get("trigger") != "/ui-ux-master":
+        fail("AI manifest trigger must be /ui-ux-master")
+    if "ui-ux-master-mcp" not in manifest.get("entrypoints", {}).get("mcp_server_bin", ""):
+        fail("AI manifest missing mcp_server_bin entrypoint")
+    expected_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",
+    }
+    actual_resources = set(manifest.get("mcp", {}).get("resources", []))
+    missing_resources = sorted(expected_resources - actual_resources)
+    if missing_resources:
+        fail("AI manifest missing MCP resources: " + ", ".join(missing_resources))
+    for rel in ["README.md", "LICENSE", "llms.txt", "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", "docs/mcp-server.md"]:
+        text = (ROOT / rel).read_text(encoding="utf-8")
+        if rel in {"README.md", "LICENSE"} and "Rupak Biswas" not in text:
+            fail(f"{rel} must identify Rupak Biswas")
+        if rel not in {"LICENSE"} and "/ui-ux-master" not in text:
+            fail(f"{rel} must mention /ui-ux-master")
+
+
 def check_referenced_files_exist() -> None:
     content = SKILL.read_text(encoding="utf-8")
-    refs = sorted(set(re.findall(r"`((?:references|templates|agent-templates|docs|bin|scripts)/[^`]+?\.(?:md|mjs|py)|README\.md)`", content)))
+    refs = sorted(set(re.findall(r"`((?:references|templates|agent-templates|docs|bin|scripts|system-prompts|ai-discovery)/[^`]+?\.(?:md|mdc|mjs|py|json)|README\.md|llms\.txt)`", content)))
     for rel in refs:
         if rel in {"docs/ui-ux-memory.md", "docs/design/ui-ux-memory.md", "design/ui-ux-memory.md"}:
             continue
@@ -289,6 +352,8 @@ def main() -> None:
     check_package_json()
     check_bin_installer()
     check_agent_templates()
+    check_mcp_server()
+    check_discovery_assets()
     check_referenced_files_exist()
     check_markdown_links()
     check_release_artifacts(strict=args.release)

package/system-prompts/ui-ux-master-compact.md

@@ -0,0 +1,5 @@
+# UI/UX Master Compact System Prompt
+
+Use UI/UX Master only when the user includes `/ui-ux-master`. Otherwise ignore this add-on.
+
+When active, read `.ui-ux-master/SKILL.md` first, then relevant `.ui-ux-master/references/*` and `.ui-ux-master/templates/*`. Check `.ui-ux-memory.md` or equivalent before designing. Preserve existing brand, tokens, components, and platform conventions unless the user asks for redesign. Cover UX strategy, IA, flows, layout, states, accessibility, responsive behavior, content, localization risks, ethics/privacy, QA, metrics, and developer handoff. State whether UI/UX memory was read, created, updated, or unavailable.

package/system-prompts/ui-ux-master-mcp-add-on.md

@@ -0,0 +1,49 @@
+# UI/UX Master MCP System Prompt Add-on
+
+Use this add-on when an agent can connect to local MCP servers.
+
+## MCP Discovery
+
+If an MCP server named `ui-ux-master` is available, discover and use its tools/resources/prompts when the user includes `/ui-ux-master`.
+
+Expected local stdio command:
+
+```bash
+npx ui-ux-master-mcp
+```
+
+or, after package install:
+
+```bash
+ui-ux-master-mcp
+```
+
+## Behavior
+
+- Use MCP resources to read the latest skill, references, templates, and system prompt add-ons.
+- Use MCP prompts to start common workflows such as audit, redesign, design-system creation, frontend handoff, or accessibility review.
+- Use MCP tools for structured outputs such as install instructions, project memory templates, checklist retrieval, and prompt generation.
+- Still activate only when `/ui-ux-master` is present.
+- Prefer `.ui-ux-master/` project-local files when they exist; use MCP as the discovery and retrieval layer.
+
+## Hermes Example
+
+```yaml
+mcp_servers:
+  ui_ux_master:
+    command: "npx"
+    args: ["-y", "--package", "ui-ux-master", "ui-ux-master-mcp"]
+```
+
+## Claude Desktop / Other MCP Clients Example
+
+```json
+{
+  "mcpServers": {
+    "ui-ux-master": {
+      "command": "npx",
+      "args": ["-y", "--package", "ui-ux-master", "ui-ux-master-mcp"]
+    }
+  }
+}
+```

package/system-prompts/ui-ux-master-system-add-on.md

@@ -0,0 +1,47 @@
+# UI/UX Master System Prompt Add-on
+
+Use this add-on in any AI coding agent that supports custom instructions, system prompts, project rules, or model context.
+
+## Activation Rule
+
+Activate UI/UX Master only when the user includes `/ui-ux-master` in the request. If the user does not include `/ui-ux-master`, do not apply this workflow automatically.
+
+## Source of Truth
+
+When active, read `.ui-ux-master/SKILL.md` first. If `.ui-ux-master/` is not available, read the installed `ui-ux-master` package files. Use these references when relevant:
+
+- `.ui-ux-master/references/ui-ux-memory-workflow.md`
+- `.ui-ux-master/references/ui-ux-frontend-implementation-rules.md`
+- `.ui-ux-master/references/ui-ux-complete-checklist.md`
+- `.ui-ux-master/references/wcag-aa-quick-reference.md`
+- `.ui-ux-master/references/accessibility-advanced-patterns.md`
+- `.ui-ux-master/references/design-system-playbook.md`
+- `.ui-ux-master/templates/ui-ux-memory.md`
+
+## Required Behavior
+
+1. Treat the rest of the prompt after `/ui-ux-master` as the user task.
+2. Check for existing UI/UX memory before designing: `.ui-ux-memory.md`, `docs/ui-ux-memory.md`, `docs/design/ui-ux-memory.md`, or `design/ui-ux-memory.md`.
+3. Inspect existing brand, tokens, components, CSS, routes, screenshots, dependencies, and similar screens before proposing UI changes.
+4. Preserve existing design conventions unless the user asks for redesign or rebrand.
+5. Include accessibility, responsive behavior, screen states, error/empty/loading/success states, content design, localization risks, platform conventions, analytics, QA, and developer handoff.
+6. If implementing frontend code, follow existing stack conventions and avoid arbitrary new dependencies.
+7. State whether UI/UX memory was read, created, updated, or unavailable.
+
+## Default Output Shape
+
+When the user does not request a specific format, return:
+
+- Product/user goal
+- Assumptions and evidence confidence
+- UX/IA/flow recommendations
+- Visual and interaction direction
+- Component/state specifications
+- Accessibility and responsive requirements
+- Content/copy recommendations
+- Implementation handoff and acceptance criteria
+- QA checklist and next steps
+
+## Quality Bar
+
+Do not stop at pretty screens. Produce senior-level UI/UX work that is usable, accessible, coherent, implementable, brand-consistent, and measurable.

package/tests/install-smoke.test.mjs

@@ -2,11 +2,12 @@ import assert from 'node:assert/strict';
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
-import { execFileSync } from 'node:child_process';
+import { execFileSync, spawnSync } from 'node:child_process';
 import test from 'node:test';
 
 const root = path.resolve(import.meta.dirname, '..');
 const bin = path.join(root, 'bin', 'ui-ux-master.mjs');
+const mcpBin = path.join(root, 'bin', 'ui-ux-master-mcp.mjs');
 const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));
 const templates = [
   'agent-templates/claude/commands/ui-ux-master.md',
@@ -22,10 +23,21 @@ function run(args, cwd = root) {
   return execFileSync(process.execPath, [bin, ...args], { cwd, encoding: 'utf8' });
 }
 
-test('package exposes ui-ux-master bin', () => {
+function runMcp(messages) {
+  const input = messages.map(m => JSON.stringify(m)).join('\n') + '\n';
+  const res = spawnSync(process.execPath, [mcpBin], { input, encoding: 'utf8', cwd: root, timeout: 5000 });
+  assert.equal(res.status, 0, res.stderr);
+  return res.stdout.trim().split(/\n+/).map(line => JSON.parse(line));
+}
+
+test('package exposes cli and mcp bins with Rupak Biswas author', () => {
+  assert.equal(pkg.author, 'Rupak Biswas');
   assert.equal(pkg.bin['ui-ux-master'], './bin/ui-ux-master.mjs');
+  assert.equal(pkg.bin['ui-ux-master-mcp'], './bin/ui-ux-master-mcp.mjs');
   assert.ok(fs.existsSync(bin));
+  assert.ok(fs.existsSync(mcpBin));
   assert.ok(fs.readFileSync(bin, 'utf8').startsWith('#!/usr/bin/env node'));
+  assert.ok(fs.readFileSync(mcpBin, 'utf8').startsWith('#!/usr/bin/env node'));
 });
 
 test('agent templates include trigger and avoid local absolute paths', () => {
@@ -38,10 +50,29 @@ test('agent templates include trigger and avoid local absolute paths', () => {
   }
 });
 
+test('discovery assets and system prompts exist', () => {
+  const required = [
+    'llms.txt',
+    'ai-discovery/ui-ux-master.manifest.json',
+    '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',
+    'docs/mcp-server.md',
+  ];
+  for (const rel of required) {
+    const text = fs.readFileSync(path.join(root, rel), 'utf8');
+    assert.match(text, /\/ui-ux-master/);
+  }
+  const manifest = JSON.parse(fs.readFileSync(path.join(root, 'ai-discovery/ui-ux-master.manifest.json'), 'utf8'));
+  assert.equal(manifest.author, 'Rupak Biswas');
+  assert.equal(manifest.activation.trigger, '/ui-ux-master');
+  assert.equal(manifest.entrypoints.mcp_server_bin, 'ui-ux-master-mcp');
+});
+
 test('cli help doctor and where work', () => {
-  assert.match(run(['--help']), /ui-ux-master install/);
+  assert.match(run(['--help']), /ui-ux-master-mcp/);
   assert.match(run(['where']).trim(), /UI-UX Skills|ui-ux-master/i);
-  assert.match(run(['doctor', '--dry-run']), /trigger: \/ui-ux-master/);
+  assert.match(run(['doctor', '--dry-run']), /bin\/ui-ux-master-mcp\.mjs|bin\\ui-ux-master-mcp\.mjs/);
 });
 
 test('project install dry-run does not write', () => {
@@ -58,6 +89,9 @@ test('project install writes expected files and is idempotent', () => {
   run(['install', '--project', '--dir', dir]);
   run(['install', '--project', '--dir', dir]);
   assert.ok(fs.existsSync(path.join(dir, '.ui-ux-master', 'SKILL.md')));
+  assert.ok(fs.existsSync(path.join(dir, '.ui-ux-master', 'llms.txt')));
+  assert.ok(fs.existsSync(path.join(dir, '.ui-ux-master', 'ai-discovery', 'ui-ux-master.manifest.json')));
+  assert.ok(fs.existsSync(path.join(dir, '.ui-ux-master', 'system-prompts', 'ui-ux-master-system-add-on.md')));
   assert.ok(fs.existsSync(path.join(dir, '.ui-ux-master', 'references', 'ui-ux-memory-workflow.md')));
   assert.ok(fs.existsSync(path.join(dir, '.ui-ux-master', 'templates', 'ui-ux-memory.md')));
   assert.ok(fs.existsSync(path.join(dir, '.claude', 'commands', 'ui-ux-master.md')));
@@ -69,3 +103,29 @@ test('project install writes expected files and is idempotent', () => {
   assert.match(agents, /\.ui-ux-master\/SKILL\.md/);
   assert.match(agents, /\/ui-ux-master/);
 });
+
+test('mcp server lists tools resources prompts and can return the skill', () => {
+  const responses = runMcp([
+    { jsonrpc: '2.0', id: 1, method: 'initialize', params: {} },
+    { jsonrpc: '2.0', id: 2, method: 'tools/list', params: {} },
+    { jsonrpc: '2.0', id: 3, method: 'resources/list', params: {} },
+    { jsonrpc: '2.0', id: 4, method: 'prompts/list', params: {} },
+    { jsonrpc: '2.0', id: 5, method: 'tools/call', params: { name: 'get_asset', arguments: { name: 'system_prompt' } } },
+  ]);
+  assert.equal(responses[0].result.serverInfo.name, 'ui-ux-master');
+  assert.ok(responses[1].result.tools.some(t => t.name === 'generate_system_prompt'));
+  assert.ok(responses[2].result.resources.some(r => r.uri === 'ui-ux-master://skill'));
+  assert.ok(responses[2].result.resources.some(r => r.uri === 'ui-ux-master://memory-template'));
+  assert.ok(responses[3].result.prompts.some(p => p.name === 'ui-ux-audit'));
+  assert.match(responses[4].result.content[0].text, /Activation Rule/);
+});
+
+test('mcp server handles prompt retrieval and unknown methods correctly', () => {
+  const responses = runMcp([
+    { jsonrpc: '2.0', id: 1, method: 'prompts/get', params: { name: 'ui-ux-design-system', arguments: { scope: 'admin dashboard' } } },
+    { jsonrpc: '2.0', id: 2, method: 'not/a-method', params: {} },
+  ]);
+  assert.match(responses[0].result.messages[0].content.text, /\/ui-ux-master/);
+  assert.match(responses[0].result.messages[0].content.text, /admin dashboard/);
+  assert.equal(responses[1].error.code, -32601);
+});