uiux-storybook-architect 2.0.0 → 2.0.2

package/README.md

@@ -255,14 +255,16 @@ The skill inventories existing sections, specifies motion before implementation,
 
 ## Supported tools and install locations
 
-| `--ide` value | Tool | Skill location in a project | Command/workflow location |
+| `--ide` value | Tool | Project skill | Global skill |
 |---|---|---|---|
-| `claude` | Claude Code | `.claude/skills/uiux-storybook-architect/` | `.claude/commands/` |
-| `codex` | OpenAI Codex | `.agents/skills/uiux-storybook-architect/` | `~/.codex/prompts/` |
-| `antigravity` | Google Antigravity | `.agents/skills/uiux-storybook-architect/` | `.agents/workflows/` |
-| `cursor` | Cursor | `.agents/skills/uiux-storybook-architect/` | `.cursor/commands/` |
-| `windsurf` | Windsurf | `.agents/skills/uiux-storybook-architect/` | `.windsurf/workflows/` |
-| `copilot` | VS Code / GitHub Copilot | `.agents/skills/uiux-storybook-architect/` | `.github/prompts/` |
+| `claude` | Claude Code | `.claude/skills/uiux-storybook-architect/` | `~/.claude/skills/uiux-storybook-architect/` |
+| `codex` | OpenAI Codex | `.agents/skills/uiux-storybook-architect/` | `~/.codex/skills/uiux-storybook-architect/` |
+| `antigravity` | Google Antigravity IDE | `.agents/skills/uiux-storybook-architect/` | `~/.gemini/config/skills/uiux-storybook-architect/` |
+| `cursor` | Cursor | `.agents/skills/uiux-storybook-architect/` | `~/.cursor/skills/uiux-storybook-architect/` |
+| `windsurf` | Windsurf | `.agents/skills/uiux-storybook-architect/` | `~/.codeium/windsurf/skills/uiux-storybook-architect/` |
+| `copilot` | VS Code / GitHub Copilot | `.agents/skills/uiux-storybook-architect/` | `~/.copilot/skills/uiux-storybook-architect/` |
+
+Project commands/workflows are installed into each tool's native command directory. Global command files are installed where the tool supports them: `~/.claude/commands/`, `~/.codex/prompts/`, and `~/.gemini/config/global_workflows/`. In Cursor, Windsurf, and Copilot, invoke the globally installed skill itself from the skill picker or let the agent select it automatically.
 
 Project instruction files are updated additively. Existing `AGENTS.md`, `CLAUDE.md`, Cursor rules, Windsurf rules, and Copilot instructions are not replaced.
 
@@ -287,7 +289,7 @@ npx uiux-storybook-architect init \
 npx uiux-storybook-architect init --all --global --yes
 ```
 
-Claude Code, Codex, and Antigravity support global skill locations. Tools without a global target fall back to project scope and report that choice.
+All six supported tools receive the skill in their native global location. No project files are written by a global install.
 
 ### Other package runners
 
@@ -427,6 +429,12 @@ npm run check
 
 `npm run check` runs the CLI test suite and an npm package dry run. CI runs on pushes and pull requests to `main`.
 
+## Automatic npm releases
+
+Every direct commit to `main` is published automatically after the complete CI workflow passes. The release workflow reruns the primary tests, inspects the npm tarball, increments the patch version from npm's current `latest`, publishes with provenance, and creates the synchronized version commit, Git tag, and GitHub release.
+
+To intentionally release a new minor or major version, update the package version in the feature commit with `npm version minor --no-git-tag-version` or `npm version major --no-git-tag-version`. See the [publishing guide](PUBLISHING.md) for authentication, versioning, race protection, and recovery details.
+
 ## Update
 
 Re-run the installer from the latest package:
@@ -485,9 +493,9 @@ Ask for it directly or use a focused `/ux-spec` scope. Single decisions, small e
 </details>
 
 <details>
-<summary><strong>A global installation wrote project files</strong></summary>
+<summary><strong>Antigravity does not show the skill</strong></summary>
 
-Cursor, Windsurf, and GitHub Copilot do not have a supported global target in this CLI. They fall back to project scope and print a warning.
+Current Antigravity IDE releases discover global skills from `~/.gemini/config/skills/` and global workflows from `~/.gemini/config/global_workflows/`. Versions of this package before this fix used the internal `~/.gemini/antigravity/` data directory, which Antigravity does not index for custom skills. Reinstall globally, then fully restart Antigravity or start a new agent session.
 
 </details>
 

package/bin/cli.js

@@ -33,7 +33,7 @@ const ok = (s) => log(`  ${c.g("✓")} ${s}`);
 const warn = (s) => log(`  ${c.y("!")} ${s}`);
 
 /* ------------------------------------------------------------ targets ---- */
-const HOME = os.homedir();
+const HOME = process.env.UIUX_TEST_HOME || os.homedir();
 
 /**
  * Each target describes where the skill and the commands go, for both scopes.
@@ -74,7 +74,7 @@ const TARGETS = {
     verify: "/skills  → uiux-storybook-architect should be listed",
   },
   antigravity: {
-    label: "Google Antigravity",
+    label: "Google Antigravity IDE",
     detect: (d) =>
       exists(path.join(HOME, ".gemini/antigravity")) ||
       exists(path.join(d, ".agents/workflows")) ||
@@ -86,9 +86,9 @@ const TARGETS = {
       memory: path.join(d, "AGENTS.md"),
     }),
     global: () => ({
-      skill: path.join(HOME, ".gemini/antigravity/skills"),
-      cmds: path.join(HOME, ".gemini/antigravity/global_workflows"),
-      ref: path.join(HOME, ".gemini/antigravity/skills", NAME),
+      skill: path.join(HOME, ".gemini/config/skills"),
+      cmds: path.join(HOME, ".gemini/config/global_workflows"),
+      ref: path.join(HOME, ".gemini/config/skills", NAME),
     }),
     verify: "type / in the agent panel → ux-* workflows appear",
   },
@@ -103,8 +103,11 @@ const TARGETS = {
       ruleFrontmatter:
         "---\ndescription: UI/UX design workflow — interview first, storybook before code\nglobs: [\"**/*.tsx\",\"**/*.jsx\",\"**/*.vue\",\"**/*.css\",\"design/**\"]\nalwaysApply: false\n---\n",
     }),
-    global: null,
-    verify: "type / in chat → ux-* commands appear",
+    global: () => ({
+      skill: path.join(HOME, ".cursor/skills"),
+      ref: path.join(HOME, ".cursor/skills", NAME),
+    }),
+    verify: "type /uiux-storybook-architect or check Customize → Skills",
   },
   windsurf: {
     label: "Windsurf",
@@ -115,8 +118,11 @@ const TARGETS = {
       ref: `.agents/skills/${NAME}`,
       rule: path.join(d, ".windsurf/rules/uiux.md"),
     }),
-    global: null,
-    verify: "type / in Cascade → ux-* workflows appear",
+    global: () => ({
+      skill: path.join(HOME, ".codeium/windsurf/skills"),
+      ref: path.join(HOME, ".codeium/windsurf/skills", NAME),
+    }),
+    verify: "type @uiux-storybook-architect in Cascade",
   },
   copilot: {
     label: "VS Code / GitHub Copilot",
@@ -128,8 +134,11 @@ const TARGETS = {
       ref: `.agents/skills/${NAME}`,
       rule: path.join(d, ".github/copilot-instructions.md"),
     }),
-    global: null,
-    verify: "Agent mode → type / → ux-* prompts appear",
+    global: () => ({
+      skill: path.join(HOME, ".copilot/skills"),
+      ref: path.join(HOME, ".copilot/skills", NAME),
+    }),
+    verify: "Agent mode → invoke /uiux-storybook-architect or ask a UI/UX task",
   },
 };
 
@@ -156,6 +165,18 @@ function installSkill(parent) {
   copyDir(path.join(SRC, "docs"), path.join(dest, "docs"));
   return dest;
 }
+function inspectSkill(file) {
+  const body = fs.readFileSync(file, "utf8");
+  const frontmatter = body.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/);
+  const name = frontmatter?.[1].match(/^name:\s*(.+)$/m)?.[1].trim() || "";
+  const description = frontmatter?.[1].match(/^description:\s*(.+)$/m)?.[1].trim() || "";
+  const errors = [];
+  if (!frontmatter) errors.push("missing YAML frontmatter");
+  if (!/^[a-z0-9-]{1,64}$/.test(name)) errors.push("name must be 1-64 lowercase letters, digits, or hyphens");
+  if (!description) errors.push("description is required");
+  if (description.length > 1024) errors.push(`description is ${description.length} characters (maximum 1024)`);
+  return { body, errors };
+}
 function installCommands(dir, skillRef, suffix = ".md") {
   fs.mkdirSync(dir, { recursive: true });
   const files = fs.readdirSync(path.join(SRC, "commands")).filter((f) => f.endsWith(".md"));
@@ -222,6 +243,13 @@ async function cmdInit(args) {
 
   banner();
 
+  const sourceCheck = inspectSkill(path.join(SRC, "SKILL.md"));
+  if (sourceCheck.errors.length) {
+    sourceCheck.errors.forEach((error) => warn(`invalid SKILL.md — ${error}`));
+    process.exitCode = 1;
+    return;
+  }
+
   let chosen;
   if (args.flags.ide) {
     chosen = String(args.flags.ide).split(",").map((s) => s.trim()).filter(Boolean);
@@ -276,8 +304,12 @@ async function cmdInit(args) {
     log(`  ${c.cy(t.label)}`);
     const skillDir = installSkill(plan.skill);
     ok(`skill    ${c.dim(path.relative(dest, skillDir) || skillDir)}`);
-    const n = installCommands(plan.cmds, plan.ref, plan.suffix || ".md");
-    ok(`commands ${c.dim(path.relative(dest, plan.cmds) || plan.cmds)} ${c.dim(`(${n})`)}`);
+    if (plan.cmds) {
+      const n = installCommands(plan.cmds, plan.ref, plan.suffix || ".md");
+      ok(`commands ${c.dim(path.relative(dest, plan.cmds) || plan.cmds)} ${c.dim(`(${n})`)}`);
+    } else {
+      log(`    ${c.dim("The skill itself is available for automatic or manual invocation.")}`);
+    }
     if (plan.note) log(`    ${c.dim(plan.note)}`);
     const rulesFile = plan.rule || plan.memory;
     if (rulesFile && scope === "project") {
@@ -340,18 +372,24 @@ function cmdDoctor(args) {
       if (!plan) continue;
       const skillPath = path.join(plan.skill, NAME, "SKILL.md");
       if (!exists(skillPath)) continue;
-      const cmdCount = exists(plan.cmds)
+      const cmdCount = plan.cmds && exists(plan.cmds)
         ? fs.readdirSync(plan.cmds).filter((f) => f.startsWith("ux-")).length
         : 0;
       // several IDEs share .agents/skills — without commands this target isn't really installed
-      if (cmdCount === 0 && plan.skill.includes(path.join(".agents", "skills"))) continue;
+      if (plan.cmds && cmdCount === 0 && plan.skill.includes(path.join(".agents", "skills"))) continue;
       found++;
-      const gated = fs.readFileSync(skillPath, "utf8").includes("When to interview");
+      const skillCheck = inspectSkill(skillPath);
+      const gated = skillCheck.body.includes("When to interview");
       log(`  ${c.cy(t.label)} ${c.dim("(" + scope + ")")}`);
       ok(`skill    ${c.dim(path.join(plan.skill, NAME))}`);
-      cmdCount
+      plan.cmds && cmdCount
         ? ok(`commands ${cmdCount} installed ${c.dim(plan.cmds)}`)
-        : warn(`no commands found in ${plan.cmds}`);
+        : plan.cmds
+          ? warn(`no commands found in ${plan.cmds}`)
+          : ok("skill invocation available (no separate global command directory)");
+      skillCheck.errors.length
+        ? skillCheck.errors.forEach((error) => warn(`invalid SKILL.md — ${error}`))
+        : ok("skill metadata valid");
       gated ? ok("interview logic present (new projects only)") : warn("interview logic MISSING — reinstall");
       log();
     }
@@ -377,7 +415,7 @@ function cmdUninstall(args) {
       const plan = scope === "global" ? t.global?.() : t.project(dest);
       if (!plan) continue;
       if (removeIfOurs(path.join(plan.skill, NAME))) { ok(`removed skill ${c.dim(path.join(plan.skill, NAME))}`); n++; }
-      if (exists(plan.cmds)) {
+      if (plan.cmds && exists(plan.cmds)) {
         for (const f of fs.readdirSync(plan.cmds)) {
           if (/^ux-.*\.md$/.test(f)) { fs.rmSync(path.join(plan.cmds, f)); n++; }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uiux-storybook-architect",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Interview-driven UI/UX design skill with 8 workflow commands for Claude Code, Codex, Antigravity, Cursor, Windsurf and VS Code Copilot. Turns vague briefs into distinctive, buildable Design Storybooks with art direction, tokens, copy, motion and accessibility.",
   "type": "module",
   "bin": {

package/src/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: uiux-storybook-architect
-description: Interview-driven UI/UX design director that turns vague website or app ideas into a distinctive, buildable Design Storybook — covering audience research, IA, art direction, tokens, typography, color, light/dark themes, composition, components, page blueprints, copy, motion with GSAP/Motion/Three.js, accessibility, and implementation. ALWAYS use this skill when the user asks to design, redesign, plan, critique, or build a website, landing page, web app, dashboard, portfolio, e-commerce store, or any UI — including requests phrased as "make it look premium/modern/award-winning", "give me a color palette", "pick fonts", "add animations", "add scroll effects", "add a 3D hero", "set up dark mode", "build me a landing page for X", or "how should this look". Trigger it even when the user only names a stack ("build a Next.js site for my client") or an audience ("a site for kids / for seniors / for a fintech"), because the interview, divergence, and storybook phases are what prevent generic template-looking output.
+description: Interview-driven UI/UX design director for websites and apps. Use for any request to design, redesign, plan, critique, or build a UI—including landing pages, dashboards, portfolios, e-commerce, color and type systems, themes, animation, scroll effects, or 3D heroes—even when the user provides only a stack or audience. Produces a distinctive, buildable Design Storybook covering discovery, information architecture, art direction, tokens, typography, color, composition, components, page blueprints, copy, motion, accessibility, and implementation. For new products and full redesigns, it interviews first and presents divergent directions before specification or code; for focused changes, it audits and acts directly.
 license: For personal and commercial project use.
 ---