@12ui/design 0.2.22 → 0.2.24

package/open-design.json

@@ -0,0 +1,198 @@
+{
+  "$schema": "https://open-design.ai/schemas/plugin.v1.json",
+  "specVersion": "1.0.0",
+  "name": "12ui-design",
+  "title": "12UI Design",
+  "version": "0.2.24",
+  "description": "Explore corpus-grounded interface directions, choose one, and convert it into production-ready responsive or native artifacts with 12UI.",
+  "author": {
+    "name": "Just Every",
+    "url": "https://12ui.com"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/just-every/12ui/tree/main/packages/12ui",
+  "publishedAt": "2026-08-13T00:00:00.000Z",
+  "tags": [
+    "12ui",
+    "interface-design",
+    "image-to-code",
+    "responsive-html",
+    "layerdoc"
+  ],
+  "compat": {
+    "agentSkills": [
+      {
+        "path": "./SKILL.md"
+      }
+    ]
+  },
+  "od": {
+    "kind": "bundle",
+    "taskKind": "new-generation",
+    "mode": "prototype",
+    "scenario": "design",
+    "engineRequirements": {
+      "od": ">=0.18.2"
+    },
+    "useCase": {
+      "query": "Design {{brief}} with four distinct, corpus-grounded visual directions. Let me select the real candidate image, then deliver it as {{output}} at {{scope}} scope."
+    },
+    "context": {
+      "skills": [
+        {
+          "path": "./skills/design/SKILL.md"
+        },
+        {
+          "path": "./skills/design-search/SKILL.md"
+        },
+        {
+          "path": "./skills/design-draft/SKILL.md"
+        },
+        {
+          "path": "./skills/design-branch/SKILL.md"
+        },
+        {
+          "path": "./skills/design-convert/SKILL.md"
+        }
+      ],
+      "mcp": [
+        {
+          "name": "12ui",
+          "command": "npx",
+          "args": [
+            "-y",
+            "@12ui/design@0.2.24",
+            "mcp"
+          ]
+        }
+      ]
+    },
+    "pipeline": {
+      "stages": [
+        {
+          "id": "discovery",
+          "atoms": [
+            "discovery-question-form",
+            "todo-write"
+          ]
+        },
+        {
+          "id": "explore",
+          "atoms": [
+            "file-read",
+            "file-write"
+          ]
+        },
+        {
+          "id": "select",
+          "atoms": [
+            "direction-picker"
+          ]
+        },
+        {
+          "id": "produce",
+          "atoms": [
+            "file-read",
+            "file-write",
+            "live-artifact"
+          ]
+        },
+        {
+          "id": "critique",
+          "atoms": [
+            "critique-theater"
+          ]
+        }
+      ]
+    },
+    "genui": {
+      "surfaces": [
+        {
+          "id": "twelve-ui-spend-approval",
+          "kind": "confirmation",
+          "persist": "run",
+          "trigger": {
+            "stageId": "explore"
+          },
+          "prompt": "Approve this run's described 12UI corpus retrieval, candidate generation, and conversion work before any quota-consuming command is dispatched.",
+          "timeout": 300000,
+          "onTimeout": "abort"
+        },
+        {
+          "id": "twelve-ui-direction",
+          "kind": "choice",
+          "persist": "run",
+          "trigger": {
+            "stageId": "select",
+            "atom": "direction-picker"
+          },
+          "prompt": "Choose one of the four generated 12UI candidate images and give the reason for the selection.",
+          "schema": {
+            "type": "object",
+            "required": [
+              "winner",
+              "reason"
+            ],
+            "properties": {
+              "winner": {
+                "type": "string"
+              },
+              "reason": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          },
+          "timeout": 1800000,
+          "onTimeout": "abort"
+        }
+      ]
+    },
+    "inputs": [
+      {
+        "name": "brief",
+        "label": "Interface brief",
+        "type": "text",
+        "required": true,
+        "placeholder": "Product, audience, surface, goal, content, and desired personality"
+      },
+      {
+        "name": "scope",
+        "label": "Scope",
+        "type": "select",
+        "required": true,
+        "options": [
+          "single-view",
+          "full-page",
+          "multi-route"
+        ],
+        "default": "full-page"
+      },
+      {
+        "name": "output",
+        "label": "Primary output",
+        "type": "select",
+        "required": true,
+        "options": [
+          "responsive-html",
+          "web-project",
+          "native-app"
+        ],
+        "default": "responsive-html"
+      },
+      {
+        "name": "redesignSource",
+        "label": "Existing interface (optional)",
+        "type": "file"
+      }
+    ],
+    "capabilities": [
+      "prompt:inject",
+      "fs:read",
+      "fs:write",
+      "mcp",
+      "subprocess",
+      "network"
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12ui/design",
-  "version": "0.2.22",
+  "version": "0.2.24",
   "type": "module",
   "description": "The canonical 12ui CLI, SDK, MCP server, and visual interface design skills",
   "main": "dist/index.js",
@@ -11,6 +11,8 @@
   "files": [
     "dist/**/*",
     "skills/**/*",
+    "SKILL.md",
+    "open-design.json",
     "README.md",
     "package.json"
   ],

package/skills/design/SKILL.md

@@ -9,7 +9,7 @@ description: "Required for non-trivial UI creation and redesign (web, app,
 
 ## Setup
 
-For a public-directory install, run `npx -y @12ui/design skill install --skill design` once. It pins the CLI and verifies this skill's account scopes.
+If the `12ui` CLI is not present, run `npx -y @12ui/design skill install --skill design` once. This installs the CLI and verifies this skill's account scopes.
 
 Code-generating models converge on a narrow band of visual defaults — the
 same fonts, palettes, and layouts across unrelated products — and a model

package/skills/design-branch/SKILL.md

@@ -10,7 +10,7 @@ description: "Required whenever the deliverable is more than one viewport — a
 
 ## Setup
 
-For a public-directory install, run `npx -y @12ui/design skill install --skill design-branch` once. It pins the CLI and verifies this skill's account scopes.
+If the `12ui` CLI is not present, run `npx -y @12ui/design skill install --skill design-branch` once. This installs the CLI and verifies this skill's account scopes.
 
 One approved screen fixes the visual system; branching extends it across the
 rest of the surface with consistent, professional quality instead of

package/skills/design-convert/SKILL.md

@@ -10,7 +10,7 @@ description: "Required to turn a finished PNG, JPEG, or WebP design into
 
 ## Setup
 
-For a public-directory install, run `npx -y @12ui/design skill install --skill design-convert` once. It pins the CLI and verifies this skill's account scopes.
+If the `12ui` CLI is not present, run `npx -y @12ui/design skill install --skill design-convert` once. This installs the CLI and verifies this skill's account scopes.
 
 Convert one finished image once, keep its base LayerDoc conversion, and
 derive every required format from that structured source — near-pixel

package/skills/design-draft/SKILL.md

@@ -10,7 +10,7 @@ description: "Required to draft candidate interface designs through the
 
 ## Setup
 
-For a public-directory install, run `npx -y @12ui/design skill install --skill design-draft` once. It pins the CLI and verifies this skill's account scopes.
+If the `12ui` CLI is not present, run `npx -y @12ui/design skill install --skill design-draft` once. This installs the CLI and verifies this skill's account scopes.
 
 Buy one small set of candidate designs and keep every one addressable. Use
 this when the run needs more than the four candidates `12ui draft` produces

package/skills/design-search/SKILL.md

@@ -10,7 +10,7 @@ description: "Required when reference imagery is the deliverable: searches
 
 ## Setup
 
-For a public-directory install, run `npx -y @12ui/design skill install --skill design-search` once. It pins the CLI and verifies this skill's account scopes.
+If the `12ui` CLI is not present, run `npx -y @12ui/design skill install --skill design-search` once. This installs the CLI and verifies this skill's account scopes.
 
 The corpus has already explored, ranked, and diversified the design space,
 so retrieval returns real reference images in a considered order rather than