lism-cli 0.0.1

package/README.md

@@ -0,0 +1,124 @@
+# @lism-css/cli
+
+[Lism CSS](https://lism-css.com) / [Lism UI](https://lism-css.com) のための CLI ツール。`lism` コマンドで新規プロジェクト生成・UI コンポーネント追加・AI スキル配置を行います。
+
+## 前提条件
+
+- Node.js 18 以上
+
+## コマンド体系
+
+```
+lism create [targetDir] [--template <name>]   # examples から新規プロジェクト
+lism ui    { init | add <names...> | list }   # Lism UI コンポーネントの追加
+lism skill { add | check | update }           # AI エージェント向け SKILL.md 配置
+```
+
+## 使い方
+
+### プロジェクトを新規作成
+
+```bash
+# 対話モード
+pnpm dlx @lism-css/cli create
+
+# テンプレート名・出力先を指定
+pnpm dlx @lism-css/cli create --template astro-minimal ./my-app
+```
+
+同じ動作は `pnpm create lism` / `npm create lism@latest` でも呼び出せます（`create-lism` パッケージ経由）。
+
+### UI コンポーネントの追加
+
+```bash
+# 単一 / 複数
+pnpm dlx @lism-css/cli ui add accordion
+pnpm dlx @lism-css/cli ui add accordion modal tabs
+
+# 全コンポーネント
+pnpm dlx @lism-css/cli ui add --all
+
+# 一覧
+pnpm dlx @lism-css/cli ui list
+
+# 特定の ref（ブランチ / タグ / コミット）から取得
+pnpm dlx @lism-css/cli ui add accordion --ref dev
+```
+
+コンポーネントは [`packages/lism-ui/src/components`](https://github.com/lism-css/lism-css/tree/main/packages/lism-ui/src/components) から [giget](https://github.com/unjs/giget) 経由で直接取得されます。`lism-ui` を更新するだけで CLI 側も自動で追従します。
+
+初回実行時に `lism.config.js` が無い場合は対話式セットアップが走り、`cli` セクションを書き込みます。
+
+```
+? フレームワークを選択してください: React
+? コンポーネントの出力先ディレクトリ: src/components/ui
+? helper の出力先ディレクトリ: src/components/ui/_helper
+✔ lism.config.js を作成しました。
+```
+
+`ui init` で設定の生成のみ行うこともできます。既存の `lism.config.js` には `cli` セクションのみ追記されます。
+
+### AI エージェント向けスキルの配置
+
+`SKILL.md` を各種 AI ツールの所定ディレクトリへ展開します。
+
+```bash
+# 対話モード（使用中のツールを自動検出）
+pnpm dlx @lism-css/cli skill add
+
+# ツールを明示指定
+pnpm dlx @lism-css/cli skill add --claude --cursor
+
+# 全ツール
+pnpm dlx @lism-css/cli skill add --all
+
+# 同梱スキルとローカルのファイル差分をチェック（変更 / 追加 / 削除のサマリ表示）
+pnpm dlx @lism-css/cli skill check
+
+# 上書き更新
+pnpm dlx @lism-css/cli skill update --claude
+```
+
+配置先の対応表：
+
+| ツール | 配置先 |
+|--------|--------|
+| `--claude` | `.claude/skills/lism-css-guide` |
+| `--codex` | `.agents/skills/lism-css-guide` |
+| `--cursor` | `.cursor/skills/lism-css-guide` |
+| `--windsurf` | `.windsurf/skills/lism-css-guide` |
+| `--cline` | `.cline/skills/lism-css-guide` |
+| `--copilot` | `.github/skills/lism-css-guide` |
+| `--gemini` | `.gemini/skills/lism-css-guide` |
+| `--junie` | `.junie/skills/lism-css-guide` |
+
+## lism.config.js
+
+`ui init` / `ui add` が生成・読み込む設定ファイル。CSS の設定（`tokens` 等）と CLI 設定を同居できます。
+
+```js
+export default {
+  cli: {
+    framework: 'react', // 'react' | 'astro'
+    componentsDir: 'src/components/ui',
+    helperDir: 'src/components/ui/_helper',
+  },
+};
+```
+
+`lism.config.mjs` も同様に読み込まれます。旧 `lism-ui.json` は廃止予定（互換ロードのみ。起動時に deprecation 警告）。
+
+> **Note:** TypeScript の `lism.config.ts` は現在未対応です。`lism-css` 本体の SCSS ビルド（`vite-plugin-lism-css` / `lism-css build`）も `.ts` を読み込まない設計のため、設定ファイルは `.js` / `.mjs` で記述してください。
+
+## パッケージが見つからないエラーが出る場合
+
+npm / pnpm の Safe Supply Chain 機能により、公開から間もないパッケージがブロックされる場合があります。
+
+```bash
+npm exec --safe-chain-skip-minimum-package-age @lism-css/cli create
+pnpm --safe-chain-skip-minimum-package-age dlx @lism-css/cli create
+```
+
+## License
+
+MIT

package/bin/lism.mjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/chunk-4TQG5MGT.js

@@ -0,0 +1,137 @@
+// src/commands/create.ts
+import fs from "fs";
+import path from "path";
+import { downloadTemplate } from "giget";
+import { select, input, confirm } from "@inquirer/prompts";
+
+// src/logger.ts
+import pc from "picocolors";
+var logger = {
+  info(msg) {
+    console.log(pc.cyan(msg));
+  },
+  success(msg) {
+    console.log(pc.green(msg));
+  },
+  warn(msg) {
+    console.log(pc.yellow(`WARN: ${msg}`));
+  },
+  error(msg) {
+    console.error(pc.red(`ERROR: ${msg}`));
+  },
+  log(msg) {
+    console.log(msg);
+  }
+};
+
+// src/version.ts
+var LISM_CSS_VERSION = "0.14.0" ? "0.14.0" : "unknown";
+var CLI_VERSION = "0.0.1" ? "0.0.1" : "unknown";
+
+// src/constants.ts
+var SOURCE_REPO = "lism-css/lism-css";
+var RAW_GITHUB_BASE = "https://raw.githubusercontent.com";
+var DEFAULT_UI_REF = "main";
+var DEFAULT_SKILL_REF = "main";
+var DEFAULT_TEMPLATES_REF = "main";
+var UI_COMPONENTS_PATH = "packages/lism-ui/src/components";
+var UI_HELPER_PATH = "packages/lism-ui/src/helper";
+var UI_REGISTRY_INDEX_PATH = "packages/lism-ui/registry-index.json";
+var SKILL_SOURCE_PATH = "skills/lism-css-guide";
+var EXAMPLES_PATH = "examples";
+
+// src/commands/create.ts
+var TEMPLATES = [{ name: "astro-minimal", label: "Astro (minimal)", description: "Astro \u30D9\u30FC\u30B9\u306E\u6700\u5C0F\u69CB\u6210" }];
+async function runCreate({ template, targetDir, force = false }) {
+  const tpl = await resolveTemplate(template);
+  const outDir = path.resolve(process.cwd(), await resolveTargetDir(targetDir, tpl.name));
+  if (fs.existsSync(outDir) && fs.readdirSync(outDir).length > 0 && !force) {
+    const ok = await confirm({
+      message: `${outDir} \u306F\u65E2\u306B\u5B58\u5728\u3057\u3001\u7A7A\u3067\u306F\u3042\u308A\u307E\u305B\u3093\u3002\u4E0A\u66F8\u304D\u3057\u307E\u3059\u304B\uFF1F`,
+      default: false
+    });
+    if (!ok) {
+      logger.warn("\u4E2D\u65AD\u3057\u307E\u3057\u305F\u3002");
+      return;
+    }
+  }
+  const ref = DEFAULT_TEMPLATES_REF;
+  logger.info(`\u30C6\u30F3\u30D7\u30EC\u30FC\u30C8 "${tpl.name}" \u3092\u53D6\u5F97\u4E2D\uFF08ref: ${ref}\uFF09...`);
+  await downloadTemplate(`github:${SOURCE_REPO}/${EXAMPLES_PATH}/${tpl.name}#${ref}`, {
+    dir: outDir,
+    force: true,
+    forceClean: force
+  });
+  rewriteWorkspaceDeps(outDir);
+  logger.success(`${outDir} \u306B\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3092\u751F\u6210\u3057\u307E\u3057\u305F\u3002`);
+  logger.log("");
+  logger.log("\u6B21\u306E\u30B3\u30DE\u30F3\u30C9\u3067\u958B\u767A\u3092\u958B\u59CB\u3067\u304D\u307E\u3059:");
+  const rel = path.relative(process.cwd(), outDir) || ".";
+  logger.log(`  cd ${rel}`);
+  logger.log("  npm install   # or pnpm install / yarn");
+  logger.log("  npm run dev");
+}
+async function createCommand(targetDir, options) {
+  await runCreate({ template: options.template, targetDir, force: options.force });
+}
+async function resolveTemplate(requested) {
+  if (requested) {
+    const found = TEMPLATES.find((t) => t.name === requested);
+    if (!found) {
+      throw new Error(`\u30C6\u30F3\u30D7\u30EC\u30FC\u30C8 "${requested}" \u306F\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002\u5229\u7528\u53EF\u80FD: ${TEMPLATES.map((t) => t.name).join(", ")}`);
+    }
+    return found;
+  }
+  const picked = await select({
+    message: "\u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u3092\u9078\u629E\u3057\u3066\u304F\u3060\u3055\u3044:",
+    choices: TEMPLATES.map((t) => ({ name: `${t.label} \u2014 ${t.description}`, value: t.name }))
+  });
+  return TEMPLATES.find((t) => t.name === picked);
+}
+async function resolveTargetDir(provided, templateName) {
+  if (provided) return provided;
+  return input({
+    message: "\u51FA\u529B\u5148\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA:",
+    default: `./${templateName}`
+  });
+}
+function rewriteWorkspaceDeps(projectDir) {
+  const pkgPath = path.join(projectDir, "package.json");
+  if (!fs.existsSync(pkgPath)) return;
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    let touched = false;
+    for (const key of ["dependencies", "devDependencies", "peerDependencies"]) {
+      const deps = pkg[key];
+      if (!deps) continue;
+      for (const [name, value] of Object.entries(deps)) {
+        if (typeof value !== "string") continue;
+        if (value.startsWith("workspace:")) {
+          deps[name] = `^${LISM_CSS_VERSION}`;
+          touched = true;
+        }
+      }
+    }
+    if (touched) {
+      fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+      logger.log(`  package.json \u306E workspace:* \u3092 ^${LISM_CSS_VERSION} \u306B\u7F6E\u63DB\u3057\u307E\u3057\u305F\u3002`);
+    }
+  } catch (err) {
+    logger.warn(`package.json \u306E\u66F8\u304D\u63DB\u3048\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${String(err)}`);
+  }
+}
+
+export {
+  logger,
+  SOURCE_REPO,
+  RAW_GITHUB_BASE,
+  DEFAULT_UI_REF,
+  DEFAULT_SKILL_REF,
+  UI_COMPONENTS_PATH,
+  UI_HELPER_PATH,
+  UI_REGISTRY_INDEX_PATH,
+  SKILL_SOURCE_PATH,
+  CLI_VERSION,
+  runCreate,
+  createCommand
+};

package/dist/index.js

@@ -0,0 +1,875 @@
+import {
+  CLI_VERSION,
+  DEFAULT_SKILL_REF,
+  DEFAULT_UI_REF,
+  RAW_GITHUB_BASE,
+  SKILL_SOURCE_PATH,
+  SOURCE_REPO,
+  UI_COMPONENTS_PATH,
+  UI_HELPER_PATH,
+  UI_REGISTRY_INDEX_PATH,
+  createCommand,
+  logger
+} from "./chunk-4TQG5MGT.js";
+
+// src/createProgram.ts
+import { Command as Command3 } from "commander";
+
+// src/commands/ui/index.ts
+import { Command, Option } from "commander";
+
+// src/commands/ui/add.ts
+import fs3 from "fs";
+import path4 from "path";
+import { confirm, select as select2 } from "@inquirer/prompts";
+
+// src/config.ts
+import fs from "fs";
+import path from "path";
+import { createJiti } from "jiti";
+var LEGACY_CONFIG_FILE = "lism-ui.json";
+var CONFIG_SEARCH = ["lism.config.js", "lism.config.mjs"];
+function resolvePath(filename) {
+  return path.resolve(process.cwd(), filename);
+}
+function findConfigFile() {
+  for (const name of CONFIG_SEARCH) {
+    const abs = resolvePath(name);
+    if (fs.existsSync(abs)) return { path: abs, filename: name, kind: "module" };
+  }
+  const legacy = resolvePath(LEGACY_CONFIG_FILE);
+  if (fs.existsSync(legacy)) return { path: legacy, filename: LEGACY_CONFIG_FILE, kind: "legacy-json" };
+  return null;
+}
+function configExists() {
+  return findConfigFile() !== null;
+}
+var DEFAULT_CONFIG_FILENAME = "lism.config.js";
+function getDefaultConfigPath() {
+  return resolvePath(DEFAULT_CONFIG_FILENAME);
+}
+async function readConfig() {
+  const found = findConfigFile();
+  if (!found) {
+    throw new Error("lism.config.js / lism.config.mjs / lism-ui.json \u306E\u3044\u305A\u308C\u3082\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002");
+  }
+  if (found.kind === "legacy-json") {
+    logger.warn(`[deprecated] ${LEGACY_CONFIG_FILE} \u306F\u5EC3\u6B62\u4E88\u5B9A\u3067\u3059\u3002"lism ui init" \u3067 lism.config.js \u3078\u79FB\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);
+    const raw = fs.readFileSync(found.path, "utf-8");
+    const parsed = JSON.parse(raw);
+    return parsed;
+  }
+  const jiti = createJiti(import.meta.url, { interopDefault: true });
+  const mod = await jiti.import(found.path);
+  const cli = mod?.cli ?? mod;
+  if (!cli || typeof cli !== "object") {
+    throw new Error(`${found.filename} \u304B\u3089 CLI \u8A2D\u5B9A\uFF08cli \u30AD\u30FC\uFF09\u3092\u8AAD\u307F\u8FBC\u3081\u307E\u305B\u3093\u3067\u3057\u305F\u3002`);
+  }
+  validateCliConfig(cli);
+  return cli;
+}
+function validateCliConfig(cli) {
+  const c = cli;
+  if (c.framework !== "react" && c.framework !== "astro") {
+    throw new Error(`cli.framework \u306F "react" \u307E\u305F\u306F "astro" \u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);
+  }
+  if (typeof c.componentsDir !== "string" || !c.componentsDir) {
+    throw new Error("cli.componentsDir \u306F\u6587\u5B57\u5217\u3067\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\u3002");
+  }
+  if (typeof c.helperDir !== "string" || !c.helperDir) {
+    throw new Error("cli.helperDir \u306F\u6587\u5B57\u5217\u3067\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\u3002");
+  }
+}
+function writeFreshConfig(cli) {
+  const filePath = getDefaultConfigPath();
+  const body = renderConfigTemplate(cli);
+  fs.writeFileSync(filePath, body);
+  return filePath;
+}
+async function hasCliSection(filePath) {
+  try {
+    const jiti = createJiti(import.meta.url, { interopDefault: true });
+    const mod = await jiti.import(filePath);
+    return !!mod?.cli;
+  } catch (err) {
+    throw new Error(`${filePath} \u3092\u8AAD\u307F\u8FBC\u3081\u307E\u305B\u3093\u3067\u3057\u305F\uFF08\u69CB\u6587\u30A8\u30E9\u30FC\u7B49\uFF09\u3002\u4FEE\u6B63\u3057\u3066\u304B\u3089\u518D\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044: ${String(err)}`);
+  }
+}
+async function patchConfigWithCli(cli, targetPath, options = {}) {
+  const filePath = targetPath ?? getDefaultConfigPath();
+  let source = fs.readFileSync(filePath, "utf-8");
+  const hasExisting = options.existingCli ?? await hasCliSection(filePath);
+  if (hasExisting) {
+    if (!options.force) {
+      return { path: filePath, patched: false };
+    }
+    const removed = removeCliSection(source);
+    if (removed === null) {
+      return { path: filePath, patched: false };
+    }
+    source = removed;
+  }
+  const insertAt = findInsertPosition(source);
+  if (insertAt === -1) {
+    return { path: filePath, patched: false };
+  }
+  const insertion = `
+  cli: ${renderCliObject(cli, "  ")},`;
+  const updated = source.slice(0, insertAt) + insertion + source.slice(insertAt);
+  fs.writeFileSync(filePath, updated);
+  return { path: filePath, patched: true };
+}
+function removeCliSection(source) {
+  const match = source.match(/(^|[\n,{])(\s*)cli\s*:\s*\{/);
+  if (!match) return null;
+  const sectionStart = match.index + match[1].length + match[2].length;
+  const openBrace = match.index + match[0].length - 1;
+  let i = openBrace + 1;
+  let depth = 1;
+  while (i < source.length && depth > 0) {
+    const c = source[i];
+    if (c === '"' || c === "'" || c === "`") {
+      const quote = c;
+      i++;
+      while (i < source.length && source[i] !== quote) {
+        if (source[i] === "\\") i++;
+        i++;
+      }
+      i++;
+      continue;
+    }
+    if (c === "/" && source[i + 1] === "/") {
+      while (i < source.length && source[i] !== "\n") i++;
+      continue;
+    }
+    if (c === "/" && source[i + 1] === "*") {
+      i += 2;
+      while (i < source.length - 1 && !(source[i] === "*" && source[i + 1] === "/")) i++;
+      i += 2;
+      continue;
+    }
+    if (c === "{") depth++;
+    else if (c === "}") depth--;
+    i++;
+  }
+  if (depth !== 0) return null;
+  let end = i;
+  if (source[end] === ",") end++;
+  const trailing = source.slice(end).match(/^[ \t]*\n/);
+  if (trailing) end += trailing[0].length;
+  return source.slice(0, sectionStart) + source.slice(end);
+}
+function findInsertPosition(source) {
+  const inline = source.match(/export default\s*(?:[A-Za-z_$][A-Za-z0-9_$]*\s*)?\(?\s*\{/);
+  if (inline) {
+    return inline.index + inline[0].length;
+  }
+  const varExport = source.match(/export default\s+([A-Za-z_$][A-Za-z0-9_$]*)\s*;?/);
+  if (varExport) {
+    const varName = varExport[1];
+    const escaped = varName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const decl = source.match(new RegExp(`(?:const|let|var)\\s+${escaped}\\s*=\\s*(?:[A-Za-z_$][A-Za-z0-9_$]*\\s*)?\\(?\\s*\\{`));
+    if (decl) {
+      return decl.index + decl[0].length;
+    }
+  }
+  return -1;
+}
+function renderConfigTemplate(cli) {
+  return [
+    "export default {",
+    //
+    `  cli: ${renderCliObject(cli, "  ")},`,
+    "};",
+    ""
+  ].join("\n");
+}
+function renderCliObject(cli, indent) {
+  return [
+    "{",
+    //
+    `${indent}  framework: ${JSON.stringify(cli.framework)},`,
+    `${indent}  componentsDir: ${JSON.stringify(cli.componentsDir)},`,
+    `${indent}  helperDir: ${JSON.stringify(cli.helperDir)},`,
+    `${indent}}`
+  ].join("\n");
+}
+
+// src/commands/ui/fetcher.ts
+import fs2 from "fs";
+import os from "os";
+import path3 from "path";
+import { downloadTemplate } from "giget";
+
+// src/transform.ts
+import path2 from "path";
+function resolveHelperPlaceholder(content, fileRelPath, componentDir, helperDir) {
+  if (!content.includes("{{HELPER}}")) return content;
+  const fileDir = path2.join(componentDir, path2.dirname(fileRelPath));
+  const relativePath = path2.relative(fileDir, helperDir);
+  const posixPath = relativePath.split(path2.sep).join("/");
+  return content.replace(/\{\{HELPER\}\}/g, posixPath);
+}
+function classifyFile(relativePath) {
+  if (relativePath.startsWith("react/")) return "react";
+  if (relativePath.startsWith("astro/")) return "astro";
+  return "shared";
+}
+function stripFrameworkPrefix(relativePath) {
+  if (relativePath.startsWith("react/")) return relativePath.slice("react/".length);
+  if (relativePath.startsWith("astro/")) return relativePath.slice("astro/".length);
+  return relativePath;
+}
+function replaceHelperImports(content) {
+  const helpers = /* @__PURE__ */ new Set();
+  const replaced = content.replace(
+    /(from\s+['"])(\.\.\/)+helper\/([^'"]+)(['"])/g,
+    (_m, prefix, _dots, helperPath, suffix) => {
+      const helperName = helperPath.replace(/\.[^.]+$/, "");
+      helpers.add(helperName);
+      return `${prefix}{{HELPER}}/${helperPath}${suffix}`;
+    }
+  );
+  return { content: replaced, helpers: [...helpers] };
+}
+function flattenSiblingImports(content) {
+  let replaced = content.replace(/(from\s+['"])\.\.\/([^'"]+)(['"])/g, "$1./$2$3");
+  replaced = replaced.replace(/(import\s+['"])\.\.\/([^'"]+)(['"])/g, "$1./$2$3");
+  return replaced;
+}
+function transformComponentFile(relativePath, rawContent) {
+  const { content: helperResolved, helpers } = replaceHelperImports(rawContent);
+  const category = classifyFile(relativePath);
+  const needsFlatten = category !== "shared";
+  const outPath = needsFlatten ? stripFrameworkPrefix(relativePath) : relativePath;
+  const outContent = needsFlatten ? flattenSiblingImports(helperResolved) : helperResolved;
+  return {
+    file: { path: outPath, content: outContent, category },
+    helpers
+  };
+}
+
+// src/commands/ui/fetcher.ts
+function walkFiles(root) {
+  const results = [];
+  const stack = [""];
+  while (stack.length > 0) {
+    const rel = stack.pop();
+    const abs = path3.join(root, rel);
+    if (!fs2.existsSync(abs)) continue;
+    for (const entry of fs2.readdirSync(abs, { withFileTypes: true })) {
+      const childRel = rel ? path3.join(rel, entry.name) : entry.name;
+      if (entry.isDirectory()) stack.push(childRel);
+      else if (entry.isFile()) results.push(childRel.split(path3.sep).join("/"));
+    }
+  }
+  return results;
+}
+function makeTmpDir(prefix) {
+  return fs2.mkdtempSync(path3.join(os.tmpdir(), prefix));
+}
+function cleanupTmpDir(dir) {
+  try {
+    fs2.rmSync(dir, { recursive: true, force: true });
+  } catch {
+  }
+}
+function isExcludedComponentFile(rel, excludeRootFiles) {
+  if (!rel.includes("/") && excludeRootFiles.has(rel)) return true;
+  if (/(^|\/)[^/]+\.stories\.[a-z]+$/.test(rel)) return true;
+  if (/(^|\/)[^/]+\.test\.[a-z]+$/.test(rel)) return true;
+  return false;
+}
+async function fetchCatalog(options = {}) {
+  const ref = options.ref ?? DEFAULT_UI_REF;
+  const url = `${RAW_GITHUB_BASE}/${SOURCE_REPO}/${ref}/${UI_REGISTRY_INDEX_PATH}`;
+  const res = await fetch(url);
+  if (!res.ok) {
+    throw new Error(`Failed to fetch registry-index.json (${res.status} ${res.statusText}): ${url}`);
+  }
+  return await res.json();
+}
+async function fetchComponent(name, excludeRootFiles, options = {}) {
+  const ref = options.ref ?? DEFAULT_UI_REF;
+  const tmp = makeTmpDir("lism-ui-component-");
+  try {
+    await downloadTemplate(`github:${SOURCE_REPO}/${UI_COMPONENTS_PATH}/${name}#${ref}`, {
+      dir: tmp,
+      force: true,
+      forceClean: true
+    });
+    const files = walkFiles(tmp);
+    const helperSet = /* @__PURE__ */ new Set();
+    const classified = { shared: [], react: [], astro: [] };
+    for (const rel of files) {
+      if (isExcludedComponentFile(rel, excludeRootFiles)) continue;
+      const raw = fs2.readFileSync(path3.join(tmp, rel), "utf-8");
+      const { file, helpers } = transformComponentFile(rel, raw);
+      for (const h of helpers) helperSet.add(h);
+      classified[file.category].push({ path: file.path, content: file.content });
+    }
+    return {
+      name,
+      helpers: [...helperSet].sort(),
+      files: classified
+    };
+  } finally {
+    cleanupTmpDir(tmp);
+  }
+}
+var helperTreeCache = /* @__PURE__ */ new Map();
+async function loadHelperTree(ref) {
+  const cached = helperTreeCache.get(ref);
+  if (cached) return cached;
+  const promise = (async () => {
+    const tmp = makeTmpDir("lism-ui-helper-");
+    try {
+      await downloadTemplate(`github:${SOURCE_REPO}/${UI_HELPER_PATH}#${ref}`, {
+        dir: tmp,
+        force: true,
+        forceClean: true
+      });
+      const byName = /* @__PURE__ */ new Map();
+      for (const rel of walkFiles(tmp)) {
+        if (/(^|\/)[^/]+\.test\.[a-z]+$/.test(rel)) continue;
+        const base = path3.basename(rel).replace(/\.[^.]+$/, "");
+        const entry = { path: rel, content: fs2.readFileSync(path3.join(tmp, rel), "utf-8") };
+        const list = byName.get(base);
+        if (list) list.push(entry);
+        else byName.set(base, [entry]);
+      }
+      return { byName };
+    } finally {
+      cleanupTmpDir(tmp);
+    }
+  })();
+  helperTreeCache.set(ref, promise);
+  promise.catch(() => helperTreeCache.delete(ref));
+  return promise;
+}
+async function fetchHelper(name, options = {}) {
+  const ref = options.ref ?? DEFAULT_UI_REF;
+  const tree = await loadHelperTree(ref);
+  const files = tree.byName.get(name);
+  if (!files || files.length === 0) {
+    throw new Error(`helper "${name}" \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\uFF08${UI_HELPER_PATH}\uFF09`);
+  }
+  return { name, files };
+}
+
+// src/commands/ui/init.ts
+import { select, input } from "@inquirer/prompts";
+async function runInit(options = {}) {
+  const framework = options.framework ?? await select({
+    message: "\u30D5\u30EC\u30FC\u30E0\u30EF\u30FC\u30AF\u3092\u9078\u629E\u3057\u3066\u304F\u3060\u3055\u3044:",
+    choices: [
+      { name: "React", value: "react" },
+      { name: "Astro", value: "astro" }
+    ]
+  });
+  const componentsDir = options.componentsDir ?? await input({
+    message: "\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u306E\u51FA\u529B\u5148\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA:",
+    default: "src/components/ui"
+  });
+  const helperDir = options.helperDir ?? await input({
+    message: "helper \u306E\u51FA\u529B\u5148\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA:",
+    default: `${componentsDir}/_helper`
+  });
+  const config = { framework, componentsDir, helperDir };
+  const found = findConfigFile();
+  if (found?.kind === "module") {
+    const { patched, path: outPath } = await patchConfigWithCli(config, found.path, {
+      force: options.force,
+      existingCli: options.existingCli
+    });
+    if (patched) {
+      logger.success(`${outPath} \u306B cli \u30BB\u30AF\u30B7\u30E7\u30F3\u3092${options.force ? "\u66F4\u65B0" : "\u8FFD\u8A18"}\u3057\u307E\u3057\u305F\u3002`);
+    } else {
+      logger.warn(`${outPath} \u306B\u65E2\u306B cli \u30BB\u30AF\u30B7\u30E7\u30F3\u304C\u542B\u307E\u308C\u3066\u3044\u308B\u304B\u3001export default \u304C\u691C\u51FA\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F\u3002\u624B\u52D5\u3067\u8FFD\u8A18\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);
+    }
+  } else {
+    const outPath = writeFreshConfig(config);
+    logger.success(`${outPath} \u3092\u4F5C\u6210\u3057\u307E\u3057\u305F\u3002`);
+  }
+  return config;
+}
+async function initCommand(options) {
+  const found = findConfigFile();
+  let existingCli = false;
+  if (found?.kind === "legacy-json") {
+    logger.warn(`${found.filename} \u3092\u691C\u51FA\u3057\u307E\u3057\u305F\u3002lism.config.js \u3078\u79FB\u884C\u3057\u307E\u3059\u3002\u53E4\u3044\u30D5\u30A1\u30A4\u30EB\u306F\u5F8C\u3067\u524A\u9664\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);
+  } else if (found?.kind === "module") {
+    try {
+      existingCli = await hasCliSection(found.path);
+    } catch (err) {
+      logger.error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+    if (existingCli) {
+      if (!options.force) {
+        logger.warn(`${found.filename} \u306B\u306F\u65E2\u306B cli \u30BB\u30AF\u30B7\u30E7\u30F3\u304C\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u307E\u3059\u3002\u4E0A\u66F8\u304D\u3059\u308B\u306B\u306F --force \u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);
+        return;
+      }
+      logger.warn(`${found.filename} \u306E\u65E2\u5B58\u306E cli \u30BB\u30AF\u30B7\u30E7\u30F3\u3092\u4E0A\u66F8\u304D\u3057\u307E\u3059\u3002`);
+    }
+  }
+  await runInit({ ...options, existingCli });
+}
+
+// src/commands/ui/normalize.ts
+var normalizeComponentName = (s) => s.replace(/[-_]/g, "").toLowerCase();
+
+// src/commands/ui/add.ts
+async function addCommand(names, options) {
+  let config;
+  if (configExists()) {
+    config = await readConfig();
+  } else {
+    logger.info("lism.config.js \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3092\u958B\u59CB\u3057\u307E\u3059...\n");
+    config = await runInit();
+    console.log();
+  }
+  const fetchOpts = { ref: options.ref };
+  let catalog;
+  try {
+    catalog = await fetchCatalog(fetchOpts);
+  } catch (err) {
+    const refInfo = options.ref ? ` (ref: ${options.ref})` : "";
+    const reason = err instanceof Error ? err.message : String(err);
+    logger.error(`\u30AB\u30BF\u30ED\u30B0\u306E\u53D6\u5F97\u306B\u5931\u6557\u3057\u307E\u3057\u305F${refInfo}: ${reason}`);
+    process.exit(1);
+  }
+  if (options.all) {
+    names = catalog.components.map((c) => c.name);
+    logger.info(`\u5168 ${names.length} \u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u3092\u8FFD\u52A0\u3057\u307E\u3059...`);
+  }
+  if (names.length === 0) {
+    logger.error("\u8FFD\u52A0\u3059\u308B\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u540D\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\u3002");
+    process.exit(1);
+  }
+  const resolvedNames = [];
+  const notFound = [];
+  for (const input2 of names) {
+    const normalized = normalizeComponentName(input2);
+    const match = catalog.components.find((c) => normalizeComponentName(c.name) === normalized);
+    if (match) resolvedNames.push(match.name);
+    else notFound.push(input2);
+  }
+  if (notFound.length > 0) {
+    logger.error(`\u898B\u3064\u304B\u3089\u306A\u3044\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8: ${notFound.join(", ")}`);
+    process.exit(1);
+  }
+  const excludeRootFiles = new Set(catalog.excludeComponentFiles);
+  const results = await Promise.allSettled(resolvedNames.map((n) => fetchComponent(n, excludeRootFiles, fetchOpts)));
+  const installedHelpers = /* @__PURE__ */ new Set();
+  let overwritePolicy = "per-component";
+  if (!options.overwrite && resolvedNames.length > 1) {
+    overwritePolicy = await askOverwritePolicy();
+  }
+  const overwriteAll = options.overwrite || overwritePolicy === "all";
+  let hasFailure = false;
+  for (let i = 0; i < resolvedNames.length; i++) {
+    const result = results[i];
+    if (result.status === "rejected") {
+      logger.error(`"${resolvedNames[i]}" \u306E\u53D6\u5F97\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${String(result.reason)}`);
+      hasFailure = true;
+      continue;
+    }
+    const helperFailed = await writeComponent(result.value, config, overwriteAll, overwritePolicy, installedHelpers, fetchOpts);
+    if (helperFailed) hasFailure = true;
+  }
+  if (hasFailure) {
+    logger.error("\u4E00\u90E8\u306E\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8 / helper \u306E\u8FFD\u52A0\u306B\u5931\u6557\u3057\u307E\u3057\u305F\u3002");
+    process.exit(1);
+  }
+  logger.success("\u5B8C\u4E86\u3057\u307E\u3057\u305F\u3002");
+}
+async function askOverwritePolicy() {
+  return select2({
+    message: "\u65E2\u5B58\u30D5\u30A1\u30A4\u30EB\u306E\u4E0A\u66F8\u304D\u65B9\u91DD\u3092\u9078\u629E\u3057\u3066\u304F\u3060\u3055\u3044:",
+    choices: [
+      { name: "\u5168\u3066\u4E0A\u66F8\u304D", value: "all" },
+      { name: "\u5168\u3066\u30B9\u30AD\u30C3\u30D7", value: "none" },
+      { name: "\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u3054\u3068\u306B\u78BA\u8A8D", value: "per-component" }
+    ]
+  });
+}
+function writeFile(filePath, content) {
+  fs3.mkdirSync(path4.dirname(filePath), { recursive: true });
+  fs3.writeFileSync(filePath, content);
+  logger.log(`  \u4F5C\u6210: ${path4.relative(process.cwd(), filePath)}`);
+}
+function hasExistingFiles(files, baseDir) {
+  return files.some((f) => fs3.existsSync(path4.join(baseDir, f.path)));
+}
+async function writeComponent(component, config, overwriteAll, policy, installedHelpers, fetchOpts) {
+  logger.info(`${component.name} \u3092\u5C55\u958B\u4E2D...`);
+  const filesToWrite = [...component.files.shared, ...component.files[config.framework]];
+  const componentDirName = component.name;
+  const componentDir = path4.resolve(process.cwd(), config.componentsDir, componentDirName);
+  const helperDir = path4.resolve(process.cwd(), config.helperDir);
+  let shouldWrite;
+  const hasExisting = hasExistingFiles(filesToWrite, componentDir);
+  if (overwriteAll) {
+    shouldWrite = true;
+  } else if (!hasExisting) {
+    shouldWrite = true;
+  } else if (policy === "none") {
+    shouldWrite = false;
+  } else if (policy === "per-component") {
+    shouldWrite = await confirm({
+      message: `${componentDirName} \u306F\u65E2\u306B\u5B58\u5728\u3057\u307E\u3059\u3002\u4E0A\u66F8\u304D\u3057\u307E\u3059\u304B\uFF1F`,
+      default: false
+    });
+  } else {
+    shouldWrite = true;
+  }
+  if (!shouldWrite) {
+    logger.log(`  \u30B9\u30AD\u30C3\u30D7: ${componentDirName}`);
+  } else {
+    for (const file of filesToWrite) {
+      const filePath = path4.join(componentDir, file.path);
+      const content = resolveHelperPlaceholder(file.content, file.path, componentDir, helperDir);
+      writeFile(filePath, content);
+    }
+  }
+  const helpersToInstall = component.helpers.filter((h) => !installedHelpers.has(h));
+  for (const h of helpersToInstall) installedHelpers.add(h);
+  let helperFailed = false;
+  if (helpersToInstall.length > 0) {
+    const helperResults = await Promise.allSettled(helpersToInstall.map((h) => fetchHelper(h, fetchOpts)));
+    for (let i = 0; i < helpersToInstall.length; i++) {
+      const result = helperResults[i];
+      if (result.status === "rejected") {
+        logger.error(`  helper "${helpersToInstall[i]}" \u306E\u53D6\u5F97\u306B\u5931\u6557\u3057\u307E\u3057\u305F: ${String(result.reason)}`);
+        helperFailed = true;
+        continue;
+      }
+      for (const file of result.value.files) {
+        const filePath = path4.join(helperDir, file.path);
+        if (fs3.existsSync(filePath) && !overwriteAll) {
+          if (policy === "none") {
+            logger.log(`  \u30B9\u30AD\u30C3\u30D7: ${file.path}`);
+            continue;
+          }
+          if (policy === "per-component") {
+            const shouldOverwrite = await confirm({
+              message: `${path4.relative(process.cwd(), filePath)} \u306F\u65E2\u306B\u5B58\u5728\u3057\u307E\u3059\u3002\u4E0A\u66F8\u304D\u3057\u307E\u3059\u304B\uFF1F`,
+              default: false
+            });
+            if (!shouldOverwrite) {
+              logger.log(`  \u30B9\u30AD\u30C3\u30D7: ${file.path}`);
+              continue;
+            }
+          }
+        }
+        writeFile(filePath, file.content);
+      }
+    }
+  }
+  return helperFailed;
+}
+
+// src/commands/ui/list.ts
+async function listCommand(options = {}) {
+  logger.info("\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u4E00\u89A7\u3092\u53D6\u5F97\u4E2D...");
+  const fetchOpts = { ref: options.ref };
+  let catalog;
+  try {
+    catalog = await fetchCatalog(fetchOpts);
+  } catch (err) {
+    const refInfo = options.ref ? ` (ref: ${options.ref})` : "";
+    const reason = err instanceof Error ? err.message : String(err);
+    logger.error(`\u30AB\u30BF\u30ED\u30B0\u306E\u53D6\u5F97\u306B\u5931\u6557\u3057\u307E\u3057\u305F${refInfo}: ${reason}`);
+    process.exit(1);
+  }
+  logger.log(`
+Lism UI v${catalog.version}
+`);
+  logger.log("\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8:");
+  for (const component of catalog.components) {
+    const helpers = component.helpers.length > 0 ? ` (helpers: ${component.helpers.join(", ")})` : "";
+    logger.log(`  - ${component.name}${helpers}`);
+  }
+  logger.log(`
+\u5408\u8A08: ${catalog.components.length} \u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8`);
+}
+
+// src/commands/ui/index.ts
+function createUiCommand() {
+  const ui = new Command("ui").description("Lism UI \u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u306E\u8FFD\u52A0\u30FB\u7BA1\u7406");
+  ui.command("init").description("lism.config.js \u306E cli \u30BB\u30AF\u30B7\u30E7\u30F3\u3092\u751F\u6210\u3059\u308B").addOption(new Option("--framework <name>", "\u30D5\u30EC\u30FC\u30E0\u30EF\u30FC\u30AF").choices(["react", "astro"])).option("--components-dir <path>", "\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u306E\u51FA\u529B\u5148\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA").option("--helper-dir <path>", "helper \u306E\u51FA\u529B\u5148\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA").option("-f, --force", "\u65E2\u5B58\u306E cli \u30BB\u30AF\u30B7\u30E7\u30F3\u3092\u4E0A\u66F8\u304D", false).action(initCommand);
+  ui.command("add").description("\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u3092\u8FFD\u52A0\u3059\u308B").argument("[names...]", "\u8FFD\u52A0\u3059\u308B\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u540D").option("-o, --overwrite", "\u65E2\u5B58\u30D5\u30A1\u30A4\u30EB\u3092\u78BA\u8A8D\u306A\u3057\u3067\u4E0A\u66F8\u304D", false).option("-a, --all", "\u5168\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u3092\u8FFD\u52A0", false).option("--ref <ref>", "\u53D6\u5F97\u5143\u306E Git ref\uFF08\u30D6\u30E9\u30F3\u30C1 / \u30BF\u30B0 / \u30B3\u30DF\u30C3\u30C8\uFF09").action(addCommand);
+  ui.command("list").description("\u5229\u7528\u53EF\u80FD\u306A\u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u4E00\u89A7\u3092\u8868\u793A\u3059\u308B").option("--ref <ref>", "\u53D6\u5F97\u5143\u306E Git ref\uFF08\u30D6\u30E9\u30F3\u30C1 / \u30BF\u30B0 / \u30B3\u30DF\u30C3\u30C8\uFF09").action(listCommand);
+  return ui;
+}
+
+// src/commands/skill/index.ts
+import { Command as Command2 } from "commander";
+
+// src/commands/skill/add.ts
+import fs5 from "fs";
+import path6 from "path";
+import { checkbox, confirm as confirm2 } from "@inquirer/prompts";
+
+// src/commands/skill/paths.ts
+var SKILL_PATHS = {
+  claude: ".claude/skills/lism-css-guide",
+  codex: ".agents/skills/lism-css-guide",
+  cursor: ".cursor/skills/lism-css-guide",
+  windsurf: ".windsurf/skills/lism-css-guide",
+  cline: ".cline/skills/lism-css-guide",
+  copilot: ".github/skills/lism-css-guide",
+  gemini: ".gemini/skills/lism-css-guide",
+  junie: ".junie/skills/lism-css-guide"
+};
+var ALL_SKILL_TOOLS = Object.keys(SKILL_PATHS);
+var TOOL_MARKERS = {
+  claude: [".claude"],
+  codex: [".agents", ".codex"],
+  cursor: [".cursor"],
+  windsurf: [".windsurf"],
+  cline: [".cline"],
+  copilot: [".github/copilot-instructions.md", ".github/copilot"],
+  gemini: [".gemini"],
+  junie: [".junie"]
+};
+
+// src/commands/skill/skillSource.ts
+import crypto from "crypto";
+import fs4 from "fs";
+import os2 from "os";
+import path5 from "path";
+import { downloadTemplate as downloadTemplate2 } from "giget";
+async function fetchSkillSource(ref = DEFAULT_SKILL_REF) {
+  const tmpDir = fs4.mkdtempSync(path5.join(os2.tmpdir(), "lism-skill-"));
+  await downloadTemplate2(`github:${SOURCE_REPO}/${SKILL_SOURCE_PATH}#${ref}`, {
+    dir: tmpDir,
+    force: true,
+    forceClean: true
+  });
+  return { dir: tmpDir, ref };
+}
+function cleanupTempDir(dir) {
+  try {
+    fs4.rmSync(dir, { recursive: true, force: true });
+  } catch {
+  }
+}
+function walkFiles2(root) {
+  const results = [];
+  const stack = [""];
+  while (stack.length > 0) {
+    const rel = stack.pop();
+    const abs = path5.join(root, rel);
+    for (const entry of fs4.readdirSync(abs, { withFileTypes: true })) {
+      const childRel = rel ? path5.join(rel, entry.name) : entry.name;
+      if (entry.isDirectory()) {
+        stack.push(childRel);
+      } else if (entry.isFile()) {
+        results.push(childRel);
+      }
+    }
+  }
+  return results;
+}
+function hashFile(filePath) {
+  const buf = fs4.readFileSync(filePath);
+  return crypto.createHash("sha256").update(buf).digest("hex");
+}
+function compareSkillDirs(localDir, remoteDir) {
+  const localExists = fs4.existsSync(localDir);
+  const remoteFiles = new Set(walkFiles2(remoteDir));
+  const localFiles = new Set(localExists ? walkFiles2(localDir) : []);
+  const diff = { unchanged: [], modified: [], added: [], localOnly: [] };
+  for (const rel of remoteFiles) {
+    if (!localFiles.has(rel)) {
+      diff.added.push(rel);
+      continue;
+    }
+    const localHash = hashFile(path5.join(localDir, rel));
+    const remoteHash = hashFile(path5.join(remoteDir, rel));
+    if (localHash === remoteHash) diff.unchanged.push(rel);
+    else diff.modified.push(rel);
+  }
+  for (const rel of localFiles) {
+    if (!remoteFiles.has(rel)) diff.localOnly.push(rel);
+  }
+  for (const list of Object.values(diff)) list.sort();
+  return diff;
+}
+function hasDiff(diff) {
+  return diff.modified.length > 0 || diff.added.length > 0 || diff.localOnly.length > 0;
+}
+function copyDirRecursive(src, dest) {
+  fs4.mkdirSync(dest, { recursive: true });
+  for (const entry of fs4.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path5.join(src, entry.name);
+    const destPath = path5.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, destPath);
+    } else if (entry.isFile()) {
+      fs4.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+// src/commands/skill/add.ts
+function resolveExplicitTools(options) {
+  if (options.all) return [...ALL_SKILL_TOOLS];
+  const explicit = ALL_SKILL_TOOLS.filter((t) => options[t]);
+  return explicit;
+}
+function autoDetectTools(cwd) {
+  return ALL_SKILL_TOOLS.filter((tool) => TOOL_MARKERS[tool].some((marker) => fs5.existsSync(path6.resolve(cwd, marker))));
+}
+async function skillAddCommand(options) {
+  const cwd = process.cwd();
+  let targets = resolveExplicitTools(options);
+  if (targets.length === 0) {
+    const detected = autoDetectTools(cwd);
+    if (detected.length > 0) {
+      logger.info(`\u691C\u51FA\u3057\u305F AI \u30C4\u30FC\u30EB: ${detected.join(", ")}`);
+    }
+    targets = await checkbox({
+      message: "\u914D\u7F6E\u5148\u306E\u30C4\u30FC\u30EB\u3092\u9078\u629E\u3057\u3066\u304F\u3060\u3055\u3044\uFF08\u30B9\u30DA\u30FC\u30B9\u3067\u9078\u629E\u3001Enter \u3067\u78BA\u5B9A\uFF09:",
+      choices: ALL_SKILL_TOOLS.map((t) => ({
+        name: `${t}  \u2192  ${SKILL_PATHS[t]}`,
+        value: t,
+        checked: detected.includes(t)
+      }))
+    });
+  }
+  if (targets.length === 0) {
+    logger.warn("\u914D\u7F6E\u5148\u304C\u9078\u629E\u3055\u308C\u307E\u305B\u3093\u3067\u3057\u305F\u3002");
+    return;
+  }
+  const ref = options.ref ?? DEFAULT_SKILL_REF;
+  logger.info(`\u30B9\u30AD\u30EB\u3092\u53D6\u5F97\u4E2D\uFF08ref: ${ref}\uFF09...`);
+  const { dir: srcDir } = await fetchSkillSource(ref);
+  try {
+    for (const tool of targets) {
+      await deploySkillTo(srcDir, tool, options);
+    }
+    logger.success("\u5B8C\u4E86\u3057\u307E\u3057\u305F\u3002");
+  } finally {
+    cleanupTempDir(srcDir);
+  }
+}
+async function deploySkillTo(srcDir, tool, options) {
+  const destDir = path6.resolve(process.cwd(), SKILL_PATHS[tool]);
+  const existing = fs5.existsSync(destDir);
+  if (existing && !options.overwrite) {
+    const diff = compareSkillDirs(destDir, srcDir);
+    const label = `${tool} (${SKILL_PATHS[tool]})`;
+    if (!hasDiff(diff)) {
+      logger.log(`  \u30B9\u30AD\u30C3\u30D7\uFF08\u5DEE\u5206\u306A\u3057\uFF09: ${label}`);
+      return;
+    }
+    logger.log("");
+    logger.log(`  ${label} \u306B\u5DEE\u5206\u304C\u3042\u308A\u307E\u3059:`);
+    if (diff.modified.length > 0) logger.log(`    \u5909\u66F4: ${diff.modified.length} \u30D5\u30A1\u30A4\u30EB`);
+    if (diff.added.length > 0) logger.log(`    \u8FFD\u52A0: ${diff.added.length} \u30D5\u30A1\u30A4\u30EB`);
+    if (diff.localOnly.length > 0) {
+      logger.log(`    \u524A\u9664: ${diff.localOnly.length} \u30D5\u30A1\u30A4\u30EB\uFF08\u30ED\u30FC\u30AB\u30EB\u306E\u307F\u306B\u5B58\u5728\u3001\u4E0A\u66F8\u304D\u6642\u306B\u524A\u9664\u3055\u308C\u307E\u3059\uFF09`);
+      for (const rel of diff.localOnly) logger.log(`      - ${rel}`);
+    }
+    const go = await confirm2({
+      message: `${SKILL_PATHS[tool]} \u3092\u4E0A\u66F8\u304D\u3057\u307E\u3059\u304B\uFF1F`,
+      default: false
+    });
+    if (!go) {
+      logger.log(`  \u30B9\u30AD\u30C3\u30D7: ${tool}`);
+      return;
+    }
+  }
+  if (existing) fs5.rmSync(destDir, { recursive: true, force: true });
+  copyDirRecursive(srcDir, destDir);
+  logger.log(`  \u914D\u7F6E: ${tool} \u2192 ${path6.relative(process.cwd(), destDir)}`);
+}
+
+// src/commands/skill/check.ts
+import fs6 from "fs";
+import path7 from "path";
+async function skillCheckCommand(options = {}) {
+  const cwd = process.cwd();
+  const installed = ALL_SKILL_TOOLS.filter((tool) => fs6.existsSync(path7.join(cwd, SKILL_PATHS[tool], "SKILL.md")));
+  if (installed.length === 0) {
+    logger.info("\u30A4\u30F3\u30B9\u30C8\u30FC\u30EB\u6E08\u307F\u306E\u30B9\u30AD\u30EB\u306F\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3067\u3057\u305F\u3002`lism skill add` \u3067\u914D\u7F6E\u3067\u304D\u307E\u3059\u3002");
+    return;
+  }
+  const ref = options.ref ?? DEFAULT_SKILL_REF;
+  logger.info(`\u30EA\u30E2\u30FC\u30C8\u30B9\u30AD\u30EB\u3092\u53D6\u5F97\u4E2D\uFF08ref: ${ref}\uFF09...`);
+  const { dir: remoteDir } = await fetchSkillSource(ref);
+  try {
+    let outdatedCount = 0;
+    for (const tool of installed) {
+      const localDir = path7.resolve(cwd, SKILL_PATHS[tool]);
+      const diff = compareSkillDirs(localDir, remoteDir);
+      const label = `${tool.padEnd(9)} ${SKILL_PATHS[tool]}`;
+      if (!hasDiff(diff)) {
+        logger.log(`  \u2713 ${label}  (\u6700\u65B0)`);
+        continue;
+      }
+      outdatedCount += 1;
+      logger.warn(`  ! ${label}`);
+      logger.log(formatDiffSummary(diff));
+      if (options.verbose) logger.log(formatDiffDetails(diff));
+    }
+    logger.log("");
+    if (outdatedCount === 0) {
+      logger.success("\u3059\u3079\u3066\u306E\u30B9\u30AD\u30EB\u304C\u6700\u65B0\u3067\u3059\u3002");
+    } else {
+      logger.info(`${outdatedCount} \u4EF6\u306E\u30C4\u30FC\u30EB\u306B\u5DEE\u5206\u304C\u3042\u308A\u307E\u3059\u3002\`lism skill update\` \u3067\u6700\u65B0\u306B\u66F4\u65B0\u3067\u304D\u307E\u3059\u3002`);
+    }
+  } finally {
+    cleanupTempDir(remoteDir);
+  }
+}
+function formatDiffSummary(diff) {
+  const parts = [];
+  if (diff.modified.length > 0) parts.push(`\u5909\u66F4 ${diff.modified.length}`);
+  if (diff.added.length > 0) parts.push(`\u8FFD\u52A0 ${diff.added.length}`);
+  if (diff.localOnly.length > 0) parts.push(`\u524A\u9664 ${diff.localOnly.length}`);
+  return `      ${parts.join(" / ")}`;
+}
+function formatDiffDetails(diff) {
+  const lines = [];
+  for (const rel of diff.modified) lines.push(`      ~ ${rel}`);
+  for (const rel of diff.added) lines.push(`      + ${rel}`);
+  for (const rel of diff.localOnly) lines.push(`      - ${rel}`);
+  return lines.join("\n");
+}
+
+// src/commands/skill/update.ts
+async function skillUpdateCommand(options) {
+  await skillAddCommand({ ...options, overwrite: true });
+}
+
+// src/commands/skill/index.ts
+function createSkillCommand() {
+  const skill = new Command2("skill").description("AI \u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u5411\u3051\u30B9\u30AD\u30EB\uFF08SKILL.md\uFF09\u306E\u914D\u7F6E\u3068\u7BA1\u7406");
+  const toolFlags = (cmd) => cmd.option("--all", "\u5168\u30C4\u30FC\u30EB\u306B\u914D\u7F6E").option("--claude", ".claude/skills/ \u306B\u914D\u7F6E").option("--codex", ".agents/skills/ \u306B\u914D\u7F6E").option("--cursor", ".cursor/skills/ \u306B\u914D\u7F6E").option("--windsurf", ".windsurf/skills/ \u306B\u914D\u7F6E").option("--cline", ".cline/skills/ \u306B\u914D\u7F6E").option("--copilot", ".github/skills/ \u306B\u914D\u7F6E").option("--gemini", ".gemini/skills/ \u306B\u914D\u7F6E").option("--junie", ".junie/skills/ \u306B\u914D\u7F6E");
+  toolFlags(
+    skill.command("add").description("\u30B9\u30AD\u30EB\u3092\u914D\u7F6E\u3059\u308B").option("-o, --overwrite", "\u78BA\u8A8D\u306A\u3057\u3067\u4E0A\u66F8\u304D", false).option("--ref <ref>", "GitHub \u306E\u53D6\u5F97\u5143 ref\uFF08\u30D6\u30E9\u30F3\u30C1\uFF0F\u30BF\u30B0\uFF0F\u30B3\u30DF\u30C3\u30C8\uFF09")
+  ).action(skillAddCommand);
+  skill.command("check").description("\u914D\u7F6E\u6E08\u307F\u30B9\u30AD\u30EB\u3068\u30EA\u30E2\u30FC\u30C8\u306E\u5DEE\u5206\u3092\u78BA\u8A8D\u3059\u308B").option("--ref <ref>", "GitHub \u306E\u53D6\u5F97\u5143 ref\uFF08\u30D6\u30E9\u30F3\u30C1\uFF0F\u30BF\u30B0\uFF0F\u30B3\u30DF\u30C3\u30C8\uFF09").option("-v, --verbose", "\u30D5\u30A1\u30A4\u30EB\u5358\u4F4D\u306E\u5DEE\u5206\u3092\u8868\u793A").action(skillCheckCommand);
+  toolFlags(
+    skill.command("update").description("\u914D\u7F6E\u6E08\u307F\u30B9\u30AD\u30EB\u3092\u6700\u65B0\u7248\u3067\u4E0A\u66F8\u304D\u3059\u308B\uFF08--overwrite \u540C\u7B49\uFF09").option("--ref <ref>", "GitHub \u306E\u53D6\u5F97\u5143 ref\uFF08\u30D6\u30E9\u30F3\u30C1\uFF0F\u30BF\u30B0\uFF0F\u30B3\u30DF\u30C3\u30C8\uFF09")
+  ).action(skillUpdateCommand);
+  return skill;
+}
+
+// src/createProgram.ts
+function createLismProgram() {
+  const program2 = new Command3();
+  program2.name("lism").description("Lism CSS / UI \u5411\u3051 CLI").version(CLI_VERSION);
+  program2.command("create").description("examples \u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u304B\u3089\u65B0\u898F\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3092\u751F\u6210\u3059\u308B").argument("[targetDir]", "\u51FA\u529B\u5148\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA").option("-t, --template <name>", "\u4F7F\u7528\u3059\u308B\u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u540D\uFF08\u4F8B: astro-minimal\uFF09").option("-f, --force", "\u65E2\u5B58\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\u3092\u5F37\u5236\u4E0A\u66F8\u304D", false).action(createCommand);
+  program2.addCommand(createUiCommand());
+  program2.addCommand(createSkillCommand());
+  return program2;
+}
+
+// src/index.ts
+var program = createLismProgram();
+program.parse();

package/dist/lib.d.ts

@@ -0,0 +1,9 @@
+interface RunCreateArgs {
+    template?: string;
+    targetDir?: string;
+    force?: boolean;
+}
+/** `lism create` / `create-lism` から共通で使える実体関数 */
+declare function runCreate({ template, targetDir, force }: RunCreateArgs): Promise<void>;
+
+export { type RunCreateArgs, runCreate };

package/dist/lib.js

@@ -0,0 +1,6 @@
+import {
+  runCreate
+} from "./chunk-4TQG5MGT.js";
+export {
+  runCreate
+};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "lism-cli",
+  "version": "0.0.1",
+  "description": "CLI for adding Lism UI components to your project",
+  "type": "module",
+  "bin": {
+    "lism": "./bin/lism.mjs"
+  },
+  "main": "./dist/lib.js",
+  "types": "./dist/lib.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/lib.d.ts",
+      "default": "./dist/lib.js"
+    }
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "scripts": {
+    "format": "prettier --write . --ignore-path ../../.prettierignore",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "commander": "^13.0.0",
+    "giget": "^3.2.0",
+    "jiti": "^2.6.1",
+    "picocolors": "^1.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.8.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT"
+}