@xgent-ai/skills 0.1.0 → 0.3.0

package/skills/xgent-init/scripts/check-docs.mjs

@@ -0,0 +1,304 @@
+#!/usr/bin/env node
+/**
+ * xgent-init · 生成文档结构检查
+ *
+ *   node check-docs.mjs [目标仓根，默认 .]
+ *
+ * 挡的是模型输出的三类漂移：残留占位（用户还得手工编辑）、结构走样（impeccable
+ * 按标题逐字解析，多一段少一段就读不出来）、过度替换（把 `Page<T>` 这种类型名
+ * 当槽位换掉了）。内容质量不归它管。
+ *
+ * 零依赖，纯 Node ≥18。退出码：有 ✗ → 1，否则 0（! 只是提醒，不拦）。
+ */
+import { readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+
+const KEY_RE = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/; // 与门户逐字一致
+const CJK_RE = /[\u3000-\u303F\u4E00-\u9FFF\uFF00-\uFFEF]/; // 中日韩标点与汉字
+
+const errs = [];
+const warns = [];
+const oks = [];
+const err = (m) => errs.push(m);
+const warn = (m) => warns.push(m);
+const ok = (m) => oks.push(m);
+
+const root = process.argv[2] ?? ".";
+if (["-h", "--help"].includes(root)) {
+  console.log("用法: node check-docs.mjs [目标仓根，默认 .]");
+  process.exit(0);
+}
+
+const read = (p) => {
+  try {
+    const full = join(root, p);
+    return statSync(full).isFile() ? readFileSync(full, "utf8") : null;
+  } catch {
+    return null;
+  }
+};
+
+/** 去掉围栏代码块，避免把代码里的 `##`、`[…]` 当正文。 */
+const stripFences = (src) => src.replace(/^```[\s\S]*?^```/gm, "");
+const h2 = (src) =>
+  stripFences(src)
+    .split("\n")
+    .filter((l) => l.startsWith("## "))
+    .map((l) => l.slice(3).trim());
+
+/* ── 0. 三份文件（AGENTS.md 是 CLAUDE.md 的镜像，见 §5） ──────────── */
+
+const claude = read("CLAUDE.md");
+const product = read("PRODUCT.md");
+const design = read("DESIGN.md");
+const agents = read("AGENTS.md");
+
+if (!claude) err("CLAUDE.md 不存在");
+if (!product) err("PRODUCT.md 不存在");
+
+let manifest = null;
+const MANIFEST_GUESSES = [
+  "app.manifest.json",
+  "deploy/portal/app.manifest.json",
+  "portal-app/app.manifest.json",
+  "deploy/app.manifest.json",
+];
+for (const p of MANIFEST_GUESSES) {
+  const raw = read(p);
+  if (raw == null) continue;
+  try {
+    manifest = JSON.parse(raw);
+    ok(`读到 ${p}`);
+  } catch (e) {
+    warn(`${p} 不是合法 JSON（${e?.message ?? e}），本次不拿它交叉核对`);
+  }
+  break;
+}
+if (!manifest) warn(`没找到 app.manifest.json（试过 ${MANIFEST_GUESSES.join(" ")}）—— key / type / 身份色无法交叉核对`);
+
+/* ── 1. 残留占位（三份文件通查） ─────────────────────────────────
+   R-5：生成完就能直接用，不留任何「还要手工编辑」的痕迹。 */
+
+const RESIDUE = [
+  ["<APP_KEY>", "令牌没替换"],
+  ["<APP_NAME>", "令牌没替换"],
+  ["<PREFIX>", "令牌没替换"],
+  ["填写指引", "模板的填写指引注释没删"],
+  ["✂️", "模板说明块没删干净"],
+  ["[Signature Component]", "Signature Component 小节既没填也没删"],
+  ["是占位值", "讲占位身份色的那句模板说明没删"],
+  ["型删掉本节", "小节标题里的模板条件没去掉"],
+  ["本 App 有租户级可维护的枚举/分类表时", "小节标题里的模板条件没去掉"],
+];
+
+/** CLAUDE.md 正文本来就有的两个方括号（Goal-Driven Execution 的示例）。 */
+const BRACKET_OK = new Set(["步骤", "检查点"]);
+
+for (const [name, src] of [["CLAUDE.md", claude], ["PRODUCT.md", product], ["DESIGN.md", design]]) {
+  if (!src) continue;
+  for (const [token, why] of RESIDUE) {
+    if (src.includes(token)) err(`${name} 残留 ${JSON.stringify(token)}：${why}`);
+  }
+  // 带中文的 [方括号] 都是模板槽位；markdown 链接 [文字](url) 与引用 [文字][id] 除外。
+  for (const m of src.matchAll(/\[([^\][\n]*)\]/g)) {
+    const next = src[m.index + m[0].length];
+    if (next === "(" || next === "[") continue;
+    const inner = m[1].trim();
+    if (!CJK_RE.test(inner)) continue;
+    if (name === "CLAUDE.md" && BRACKET_OK.has(inner)) continue;
+    err(`${name} 残留占位 ${JSON.stringify(m[0].slice(0, 40))}：方括号槽位没填`);
+  }
+  // C-6：门户仓的文档目标仓访问不到，别在生成的文件里引它的路径。
+  for (const m of src.matchAll(/`(apps|packages|docs)\/[^`\s]+`/g)) {
+    warn(`${name} 出现仓路径样式 ${m[0]} —— 若指的是门户仓，目标仓访问不到，请改成 skill 名`);
+  }
+}
+
+/* ── 2. PRODUCT.md：七段结构 + Register 裸词 ────────────────────── */
+
+const PRODUCT_H2 = [
+  "Register",
+  "Users",
+  "Product Purpose",
+  "Brand Personality",
+  "Anti-references",
+  "Design Principles",
+  "Accessibility & Inclusion",
+];
+
+if (product) {
+  const got = h2(product);
+  if (got.join(" | ") !== PRODUCT_H2.join(" | ")) {
+    err(
+      `PRODUCT.md 的二级标题必须是这七个、按这个顺序（impeccable 逐字解析）：\n` +
+        `      期望  ${PRODUCT_H2.join(" / ")}\n` +
+        `      实际  ${got.length ? got.join(" / ") : "（一个都没有）"}`
+    );
+  } else {
+    ok("PRODUCT.md 七段结构正确");
+  }
+
+  const body = product.split(/^## /m)[1]; // "Register\n\nproduct\n\n"
+  const lines = (body ?? "")
+    .split("\n")
+    .slice(1)
+    .map((l) => l.trim())
+    .filter((l) => l && !l.startsWith("<!--"));
+  if (lines.length !== 1 || !["product", "brand"].includes(lines[0])) {
+    err(`PRODUCT.md 的 ## Register 正文只能是裸词 product 或 brand（不加句号、不加解释），实际：${JSON.stringify(lines.join(" ").slice(0, 60))}`);
+  } else {
+    ok(`PRODUCT.md Register = ${lines[0]}`);
+  }
+}
+
+/* ── 3. CLAUDE.md：key / type / PREFIX / 按形态裁剪 ─────────────── */
+
+const MICRO_SECTIONS = ["### 前端 UI 开发：", "### 前端：版头归门户", "### 下拉框：", "### App 图标："];
+const UI_WORKFLOW_MARKERS = [
+  "npx impeccable install",
+  "mcp__claude-in-chrome__*",
+  "kimi-webbridge",
+  "playwright",
+  "未在浏览器中验证",
+];
+const DICT_SECTION = "### 字典表统一带"; // micro 型也可按需删，只在 service 型断言不存在
+
+let type = null;
+let key = null;
+
+if (claude) {
+  const t = claude.match(/type:\s*(micro|service)\b/);
+  if (!t) err("CLAUDE.md 找不到 `type: micro` 或 `type: service`（Project Conventions 首句里的形态声明）");
+  else {
+    type = t[1];
+    ok(`CLAUDE.md type = ${type}`);
+  }
+
+  const line = claude.split("\n").find((l) => l.includes("本仓交付的是"));
+  const k = line?.match(/`([^`]+)`/);
+  if (!k) err("CLAUDE.md 找不到 Project Conventions 首句（`本仓交付的是 … App：\\`<key>\\`…`），无法核对 key");
+  else if (!KEY_RE.test(k[1])) err(`CLAUDE.md 里的 key \`${k[1]}\` 不合法，必须匹配 ${KEY_RE}`);
+  else {
+    key = k[1];
+    ok(`CLAUDE.md key = ${key}`);
+  }
+
+  if (key) {
+    const expect = key.toUpperCase().replace(/-/g, "_");
+    const sa = claude.match(/([A-Z0-9_]+)_SA_CLIENT_SECRET/);
+    if (!sa) err("CLAUDE.md 找不到 `<PREFIX>_SA_CLIENT_SECRET`（服务账号密钥那条）");
+    else if (sa[1] !== expect) err(`CLAUDE.md 的 ${sa[1]}_SA_CLIENT_SECRET 与 key \`${key}\` 不一致，应为 ${expect}_SA_CLIENT_SECRET（key 大写、连字符换下划线）`);
+    else ok(`CLAUDE.md PREFIX = ${expect}`);
+  }
+
+  if (type === "service") {
+    for (const s of [...MICRO_SECTIONS, DICT_SECTION]) {
+      if (claude.includes(s)) err(`CLAUDE.md 是 service 型（无前端），应删掉 \`${s}…\` 这一节`);
+    }
+    for (const s of ["DESIGN.md", "impeccable"]) {
+      if (claude.includes(s)) err(`CLAUDE.md 是 service 型，## Design Context 里不该再提 ${s}`);
+    }
+  } else if (type === "micro") {
+    for (const s of MICRO_SECTIONS) {
+      if (!claude.includes(s)) err(`CLAUDE.md 是 micro 型，缺 \`${s}…\` 这一节`);
+    }
+    for (const marker of UI_WORKFLOW_MARKERS) {
+      if (!claude.includes(marker)) err(`CLAUDE.md 是 micro 型，前端 UI 两步法缺少 \`${marker}\``);
+    }
+  }
+
+  if (key && manifest?.listingKey && manifest.listingKey !== key) {
+    err(`CLAUDE.md 的 key \`${key}\` 与 manifest.listingKey \`${manifest.listingKey}\` 不一致`);
+  }
+  if (type && manifest?.type && manifest.type !== type) {
+    err(`CLAUDE.md 的 type \`${type}\` 与 manifest.type \`${manifest.type}\` 不一致`);
+  }
+}
+
+/* ── 4. DESIGN.md：存在性随形态；frontmatter + 六段 ─────────────── */
+
+if (type === "service" && design) err("service 型（无前端）不需要 DESIGN.md，请删掉");
+if (type === "micro" && !design) err("micro 型缺 DESIGN.md");
+
+const DESIGN_H2 = ["1. Overview", "2. Colors", "3. Typography", "4. Elevation", "5. Components", "6. Do's and Don'ts"];
+
+if (design) {
+  const lines = design.split("\n");
+  if (lines[0] !== "---") {
+    err(`DESIGN.md 第 1 行必须是 \`---\`（YAML frontmatter 不在开头就整块解析不出来），实际：${JSON.stringify(lines[0].slice(0, 40))}`);
+  } else {
+    ok("DESIGN.md frontmatter 从第 1 行开始");
+  }
+
+  const end = lines.indexOf("---", 1);
+  const fm = end > 0 ? lines.slice(1, end).join("\n") : "";
+  if (!fm) err("DESIGN.md 的 frontmatter 没有闭合的 `---`");
+
+  for (const field of ["name", "description"]) {
+    const m = fm.match(new RegExp(`^${field}:\\s*(.+)$`, "m"));
+    if (!m) {
+      err(`DESIGN.md frontmatter 缺 ${field}`);
+      continue;
+    }
+    try {
+      const v = JSON.parse(m[1].trim());
+      if (typeof v !== "string" || !v) throw new Error("不是非空字符串");
+      ok(`DESIGN.md ${field} = ${JSON.stringify(v.slice(0, 30))}`);
+    } catch {
+      err(`DESIGN.md frontmatter 的 ${field} 必须是带双引号的合法字符串（值里的 " 与 \\ 要转义），实际：${m[1].trim().slice(0, 40)}`);
+    }
+  }
+
+  const id = fm.match(/^\s*app-identity:\s*(.+)$/m);
+  if (!id) err("DESIGN.md frontmatter 缺 colors.app-identity");
+  else {
+    const v = id[1].trim().replace(/^"|"$/g, "");
+    if (!/^#[0-9A-Fa-f]{6}$/.test(v)) err(`DESIGN.md 的 app-identity 必须是 "#RRGGBB"，实际：${JSON.stringify(v)}`);
+    else if (manifest?.color && manifest.color.toUpperCase() !== v.toUpperCase()) {
+      err(`DESIGN.md 的 app-identity ${v} 与 manifest.color ${manifest.color} 不同 —— 一个在壳里一个在房里，色不一样就是同一个 App 说两种话`);
+    } else ok(`DESIGN.md app-identity = ${v}${manifest?.color ? "（与 manifest.color 一致）" : ""}`);
+  }
+
+  const got = h2(design);
+  if (got.join(" | ") !== DESIGN_H2.join(" | ")) {
+    err(
+      `DESIGN.md 正文必须恰好六段、名字与顺序照抄（Google Stitch 格式，impeccable 逐字解析）：\n` +
+        `      期望  ${DESIGN_H2.join(" / ")}\n` +
+        `      实际  ${got.length ? got.join(" / ") : "（一个都没有）"}`
+    );
+  } else {
+    ok("DESIGN.md 六段结构正确");
+  }
+
+  // 防过度替换：这两个不是槽位。
+  for (const [token, why] of [
+    ["Page<T>", "平台分页契约的类型名"],
+    ["{colors.app-identity}", "frontmatter 的 token 引用语法"],
+  ]) {
+    if (!design.includes(token)) err(`DESIGN.md 里 \`${token}\`（${why}）被改掉了 —— 它不是槽位，请改回来`);
+  }
+}
+
+/* ── 5. AGENTS.md：CLAUDE.md 的镜像 ───────────────────────────────
+   读 AGENTS.md 的工具（Codex / Cursor / pi）也要看到同一套约定；两份不同步
+   就是同一个仓里摆着两处互相矛盾的规范。 */
+
+if (!agents) {
+  err("AGENTS.md 不存在 —— 它必须是 CLAUDE.md 的镜像（除第 1 行标题外逐字相同）");
+} else if (claude) {
+  const head = agents.split("\n")[0];
+  if (head !== "# AGENTS.md") {
+    err(`AGENTS.md 第 1 行应是 \`# AGENTS.md\`，实际：${JSON.stringify(head.slice(0, 40))}`);
+  }
+  const body = (src) => src.split("\n").slice(1).join("\n");
+  if (body(agents) === body(claude)) ok("AGENTS.md 与 CLAUDE.md 除首行外逐字一致");
+  else err("AGENTS.md 与 CLAUDE.md 正文不一致 —— 两份是同一套约定的镜像，只有第 1 行标题该不同；改一份就同步另一份");
+}
+
+/* ── 输出 ───────────────────────────────────────────────────────── */
+
+for (const m of oks) console.log(`  ✓ ${m}`);
+for (const m of warns) console.log(`  ! ${m}`);
+for (const m of errs) console.log(`  ✗ ${m}`);
+console.log(`\n${errs.length ? "✗" : "✓"} ${root}：${errs.length} 个错误，${warns.length} 个提醒`);
+process.exit(errs.length ? 1 : 0);

package/vendor/impeccable/LICENSE

@@ -0,0 +1,191 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright
+      owner or by an individual or Legal Entity authorized to submit on
+      behalf of the copyright owner. For the purposes of this definition,
+      "submitted" means any form of electronic, verbal, or written
+      communication sent to the Licensor or its representatives, including
+      but not limited to communication on electronic mailing lists, source
+      code control systems, and issue tracking systems that are managed by,
+      or on behalf of, the Licensor for the purpose of discussing and
+      improving the Work, but excluding communication that is conspicuously
+      marked or otherwise designated in writing by the copyright owner as
+      "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2025 Paul Bakaus
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/vendor/impeccable/NOTICE.md

@@ -0,0 +1,11 @@
+# Third-Party Notices
+
+This project includes content derived from third-party work, used under the terms of its original license.
+
+## Platform Design Skills
+
+The `skill/reference/ios.md` and `skill/reference/android.md` platform reference files are distilled from ehmo's `platform-design-skills` (Apple Human Interface Guidelines and Material Design 3 rules), rewritten in Impeccable's voice.
+
+**Original work:** https://github.com/ehmo/platform-design-skills
+**Original license:** MIT
+**Author:** ehmo

package/vendor/impeccable/VERSION.json

@@ -0,0 +1,28 @@
+{
+  "source": "https://github.com/pbakaus/impeccable",
+  "license": "Apache-2.0",
+  "skillVersion": "4.3.1",
+  "engineVersion": "0.1.5",
+  "bundle": {
+    "url": "https://github.com/pbakaus/impeccable/releases/download/skill-v4.3.1/universal.zip",
+    "keyId": "release-2026-09",
+    "sha256": "1deea4cdfb1608df6d9e08ef359629e7cc866a22ab7c2195a835627b887f190b",
+    "size": 15625571
+  },
+  "engines": {
+    "darwin-arm64": {
+      "asset": "impeccable-darwin-arm64",
+      "sha256": "0d48b6e16aa97664fdbe607d5da9ae320e389a1843e0ff1328f8c2530530320d",
+      "size": 12762240,
+      "url": "https://download.xgent.ai/vendor/impeccable/engine/v0.1.5/darwin-arm64/impeccable"
+    },
+    "darwin-x64": {
+      "asset": "impeccable-darwin-x64",
+      "sha256": "153971b0c00719dff9ebac13370cb7dbbbe12838b696fbaf3f7ab0b1b3726b52",
+      "size": 14400568,
+      "url": "https://download.xgent.ai/vendor/impeccable/engine/v0.1.5/darwin-x64/impeccable"
+    }
+  },
+  "fetchedAt": "2026-09-22T15:38:00.906Z",
+  "publishedAt": "2026-09-22T15:40:54.468Z"
+}

package/vendor/impeccable/bundle/blobs/00023f9e7f2e27604fde978b56510a8f837b76eeadd93221d11adcf4c98f1a10

@@ -0,0 +1,88 @@
+---
+name: impeccable
+description: Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.
+version: 4.3.1
+user-invocable: true
+license: Apache 2.0
+allowed-tools:
+  - Bash(npx impeccable *)
+  - Bash(.vibe/skills/impeccable/scripts/impeccable *)
+---
+
+This skill gives you the tools and permission to create design that earns to be called out-of-distribution craft: Whereas before, your design work would have been safe, timid and measured, you now approach every design task as an award-winning design director with impeccable understanding for what makes exceptional design work: production-grade code, peak creativity, a clear POV, deep understanding of the needs of the client and users, and exceptional craft.
+
+Core principles:
+- Go all out. No hedging, no shortcuts. The deliverable must be complete (except assets the user must provide).
+- Dream big and bold. Distinct, beautiful, outstanding and highly inspiring work.
+- Verify in bounded passes, not a loop, and the ceiling covers the whole cycle: screenshots, defect scans, micro-edits, and rebuilds alike. Build fully, inspect once with a batched round (desktop and mobile together on the web; the shipped device classes on a native platform), fix everything it shows in one batch, confirm with at most one more round, and stop polishing. Open-ended self-QA burns the user's money doing worse what the finish handoffs do better.
+
+## Setup
+
+1. Run `<skill-base-dir>/scripts/impeccable context` once per session, where `<skill-base-dir>` is the directory that contains this SKILL.md (the skill folder, not a plugin root two levels above it); keep cwd at the user's project. That base directory resolves every `.vibe/skills/impeccable/scripts/impeccable <verb>` command in this skill and its references, and `.vibe/skills/impeccable/scripts` is the fallback only when the runtime reports no base directory. On a Windows shell without `sh`, call `.vibe/skills/impeccable/scripts/impeccable.cmd` instead. The launcher runs a self-contained binary that ships next to it or is downloaded once on first run; no Node or other runtime is required. Pass a named source file or route as `--target <path>`. It loads PRODUCT.md, DESIGN.md, the matching surface brief, and native-platform guidance when applicable; follow its directives and do not rerun it.
+2. Load the request's playbook: its Commands-table reference for an explicit/implied sub-command, or [reference/new-work.md](reference/new-work.md) for a new surface or replacement visual world. Inspect target and incumbent visual truth before editing. When the app cannot run, start with committed visual-regression goldens or screenshot fixtures; verify target and freshness against current tokens, CSS, components, or assets, resolve conflicts, and compare theme/variant captures.
+3. After resolving analysis and direction, read [reference/craft-floor.md](reference/craft-floor.md) immediately before any UI edit, including small refinements. It carries the quality floor, the absolute bans, and the reflexes no detector catches. Do not load it for planning-only work.
+
+**Launcher unavailable:** On refusal or failure, send a separate message **before the next tool call**: “Context loading did not run; I’ll read the existing project context directly.” Then read existing PRODUCT.md and DESIGN.md without inventing missing context, follow applicable steps 2–3, and continue through permitted tools. This applies to planning and editing; launcher failure alone does not block either.
+
+## How to design
+
+- **The brief wins.** Honor pinned aesthetics, eras, materials, fonts, and palettes even when they conflict with a saturated-pattern warning. Redirecting a clear brief toward your taste is failure.
+- **Refinement preserves; redesign replaces.** Refinement keeps the incumbent identity, behavior, copy, and everything outside scope. Ask before replacing factual copy or adding claims. Redesign keeps product truth, content, function, native affordances, and constraints, but treats the old look as evidence and anti-reference; choose a replacement world in new-work and replace DESIGN.md. Never split the difference into polish on the discarded look.
+- **Visual authority is evidence, not a filename.** Missing DESIGN.md alone does not make a project greenfield; new-work decides whether to preserve, expand, or replace the incumbent world.
+
+## Modes
+
+The mode names what the visitor's success looks like on this surface.
+
+- **Persuade:** the visitor decides and acts; design is the product. Landing pages, marketing, campaigns, pricing. Earn attention and action. Ship real imagery when the brief needs it; follow the committed world, not category habit.
+- **Operate:** the visitor completes a task. App UI, dashboards, editors, admin, settings, tools. Scanability, consistency, native expectations, and the real usage scene outrank expression. Brand lives in precise details.
+- **Read:** the visitor understands something. Docs, articles, guides, help, changelogs. Structure for comprehension, then make the reading experience worth staying in.
+- **Experience:** the visitor is inside the work itself. Portfolios, galleries, showcases. Let the artifact lead from the first viewport; the interface recedes.
+
+Choose the mode from the requested surface, not the product, and persist it only in that surface brief. A tool's landing page is still Persuade; a fashion house's documentation is still Read; a docs index is Read, not Persuade. See [new-work.md](reference/new-work.md) for new surfaces and [operate.md](reference/operate.md) for deeper Operate/Read guidance.
+
+## Commands
+
+| Command | Category | Description | Reference |
+|---|---|---|---|
+| `craft [feature]` | Build | Deprecated alias for an ordinary new-work request | [reference/craft.md](reference/craft.md) |
+| `shape [feature]` | Build | Plan UX/UI before writing code | [reference/shape.md](reference/shape.md) |
+| `init` | Build | Capture durable product context in PRODUCT.md | [reference/init.md](reference/init.md) |
+| `document` | Build | Generate DESIGN.md from existing project code | [reference/document.md](reference/document.md) |
+| `extract [target]` | Build | Pull reusable tokens and components into design system | [reference/extract.md](reference/extract.md) |
+| `critique [target]` | Evaluate | UX design review with heuristic scoring | [reference/critique.md](reference/critique.md) |
+| `audit [target]` | Evaluate | Technical quality checks (a11y, perf, responsive) | [reference/audit.md](reference/audit.md) · native: [reference/audit.native.md](reference/audit.native.md) |
+| `polish [target]` | Refine | Final quality pass before shipping | [reference/polish.md](reference/polish.md) |
+| `bolder [target]` | Refine | Amplify safe or bland designs | [reference/bolder.md](reference/bolder.md) |
+| `quieter [target]` | Refine | Tone down aggressive or overstimulating designs | [reference/quieter.md](reference/quieter.md) |
+| `distill [target]` | Refine | Strip to essence, remove complexity | [reference/distill.md](reference/distill.md) |
+| `harden [target]` | Refine | Production-ready: errors, i18n, edge cases | [reference/harden.md](reference/harden.md) |
+| `onboard [target]` | Refine | Design first-run flows, empty states, activation | [reference/onboard.md](reference/onboard.md) |
+| `animate [target]` | Enhance | Add purposeful animations and motion | [reference/animate.md](reference/animate.md) |
+| `colorize [target]` | Enhance | Add strategic color to monochromatic UIs | [reference/colorize.md](reference/colorize.md) |
+| `typeset [target]` | Enhance | Improve typography hierarchy and fonts | [reference/typeset.md](reference/typeset.md) |
+| `layout [target]` | Enhance | Fix spacing, rhythm, and visual hierarchy | [reference/layout.md](reference/layout.md) |
+| `delight [target]` | Enhance | Add personality and memorable touches | [reference/delight.md](reference/delight.md) |
+| `overdrive [target]` | Enhance | Push past conventional limits | [reference/overdrive.md](reference/overdrive.md) |
+| `clarify [target]` | Fix | Improve UX copy, labels, and error messages | [reference/clarify.md](reference/clarify.md) |
+| `adapt [target]` | Fix | Adapt for different devices and screen sizes | [reference/adapt.md](reference/adapt.md) · native: [reference/adapt.native.md](reference/adapt.native.md) |
+| `optimize [target]` | Fix | Diagnose and fix UI performance | [reference/optimize.md](reference/optimize.md) |
+| `live` | Iterate | Visual variant mode: pick elements in the browser, generate alternatives | [reference/live.md](reference/live.md) |
+
+Routing:
+
+- **No argument:** read [routing.md](reference/routing.md) and present its context-aware menu; never auto-run a command.
+- **Explicit or clearly implied request to run a command:** load its reference (native variant on native platforms) and follow it. Ask once if two commands fit.
+- **Workflow or command-selection question:** read [Workflow questions](reference/routing.md#workflow-questions).
+- **Otherwise:** treat the request as general design work. Missing PRODUCT.md routes a new surface or replacement world through init, then new-work; a narrow refinement of existing code proceeds on the incumbent implementation as `impeccable context` directs, offering init afterward rather than blocking on it.
+- `teach` aliases `init`. `craft` is a deprecated alias for ordinary new-work and adds nothing. `shape` owns task discovery, then enters new-work only for visual-world and surface-concept decisions.
+
+After init writes PRODUCT.md, resume without rerunning `impeccable context`; init loads the native platform reference itself when the platform it recorded is `ios`, `android`, or `adaptive`.
+
+**Pin / Unpin:** `.vibe/skills/impeccable/scripts/impeccable pin <pin|unpin> <command>` creates or removes a standalone `/<command>` shortcut. Report the script's result concisely; relay stderr verbatim on error.
+
+**Hooks:** `/impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset>` manages the design detector hook for this project (auto-runs the detector after UI file edits and surfaces findings). Load [reference/hooks.md](reference/hooks.md) when the user invokes it with any argument.
+
+**Doctor:** `/impeccable doctor` reports and repairs drift between this project's Impeccable artifacts (PRODUCT.md, DESIGN.md and its sidecar, config, surface briefs, the hook) and what this version reads. Load [reference/doctor.md](reference/doctor.md) when the user invokes it, or when they ask what is out of date, stale, or needs refreshing. A `CONTEXT_STALE` directive in Setup's output is the cheap subset of the same report; act on it there per its own instructions rather than running doctor unasked.
+
+**Never repair drift as a side effect of a design task.** A `CONTEXT_STALE` finding is reported, not acted on, unless the user asks. The one exception is a finding marked `auto`, which the next write to that file performs anyway.