@liuovo/skills 0.0.0-stage → 0.1.2

package/README.md

@@ -1,3 +1,74 @@
-# Temporary Holding Version
+# @liuovo/skills
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+一份精选的 Skills 清单，用交互式向导按需安装到 Codex、Claude Code 或 OpenCode。
+
+## 使用
+
+需要 Node.js >= 22.20.0、pnpm，以及可访问 GitHub 的 Git / 网络环境。
+
+```bash
+pnpx @liuovo/skills
+```
+
+这里只选择清单里的 Skills；随后由原生 `skills` 处理 Agent、安装范围、确认和安装结果。输入关键词搜索，`Tab` 多选，`Enter` 确认，`Esc` 取消清单选择。多个来源会分别进入原生安装流程。
+
+取消原生安装时遵循其退出码：返回非零才停止后续来源；若原生把取消视为正常结束并返回 `0`，仍会继续下一个来源。因此，在原生提示中按 `Ctrl+C` 或 `Esc` 不保证结束整轮操作。
+
+```bash
+# 查看清单
+pnpx @liuovo/skills list
+
+# 指定清单项，继续原生交互
+pnpx @liuovo/skills --skill handoff research
+
+# 原生参数直接透传，不限制 Agent 名称
+pnpx @liuovo/skills --skill handoff --global --agent codex
+
+# -- 后的所有参数原样交给 skills add
+pnpx @liuovo/skills --skill handoff -- --global --agent codex --copy --yes
+
+# 只查看将执行的命令参数，不下载、不安装
+pnpx @liuovo/skills --skill handoff --dry-run
+```
+
+安装时优先使用 `PATH` 中已有的 `skills`；没有时执行 `pnpx skills@latest`。已有安装器不会被自动升级。
+
+**同名 Skill 的处理遵循原生 `skills`，本工具不再默认跳过或自行保护已有目录。** 不自动添加 `--yes`；显式传入 `--yes` 可能覆盖已有内容和本地修改。原封装的 `--project`、`--overwrite` 不再作为自有选项；安装范围与覆盖行为以原生 CLI 为准。`--json` 在 `list` 中输出清单 JSON，在安装命令中则直接透传给原生。
+
+原生 `skills` 也可能根据运行环境（例如编码 Agent）自行进入非交互模式，本工具不改写这些规则。
+
+更新、卸载也直接使用原生命令，例如：
+
+```bash
+pnpx skills update --global
+pnpx skills update --project
+pnpx skills remove handoff --global
+```
+
+更新可能覆盖本地修改；不会自动安装本清单新增的条目。
+
+## Skills
+
+当前包含 19 个外部 Skills 引用，安装时从各自上游获取，未复制上游正文。
+
+| Skill                                                                                                                   | 用途                                           | 来源               |
+| ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | ------------------ |
+| [grill-me](https://github.com/mattpocock/skills/blob/HEAD/skills/productivity/grill-me/SKILL.md)                        | 通过连续追问，把模糊方案打磨清楚。             | mattpocock/skills  |
+| [grilling](https://github.com/mattpocock/skills/blob/HEAD/skills/productivity/grilling/SKILL.md)                        | 质询计划与决策，找出遗漏和薄弱环节。           | mattpocock/skills  |
+| [handoff](https://github.com/mattpocock/skills/blob/HEAD/skills/productivity/handoff/SKILL.md)                          | 把当前对话整理成可接续的交接文档。             | mattpocock/skills  |
+| [codebase-design](https://github.com/mattpocock/skills/blob/HEAD/skills/engineering/codebase-design/SKILL.md)           | 用统一概念设计职责清晰、接口简洁的模块。       | mattpocock/skills  |
+| [writing-for-agents](https://github.com/mattpocock/skills/blob/HEAD/skills/productivity/writing-for-agents/SKILL.md)    | 编写清晰、可执行的 Agent 文档与 Skills。       | mattpocock/skills  |
+| [to-questionnaire](https://github.com/mattpocock/skills/blob/HEAD/skills/productivity/to-questionnaire/SKILL.md)        | 将难以独自定夺的决策整理成问卷，交给他人填写。 | mattpocock/skills  |
+| [code-review](https://github.com/mattpocock/skills/blob/HEAD/skills/engineering/code-review/SKILL.md)                   | 对照仓库规范与原始需求，审查指定基准后的改动。 | mattpocock/skills  |
+| [research](https://github.com/mattpocock/skills/blob/HEAD/skills/engineering/research/SKILL.md)                         | 基于高可信一手来源调研，并将结论写入仓库。     | mattpocock/skills  |
+| [improve](https://github.com/shadcn/improve/blob/HEAD/skills/improve/SKILL.md)                                          | 审视代码库，按优先级生成可交付的改进计划。     | shadcn/improve     |
+| [dry-refactoring](https://github.com/kucherenko/jscpd/blob/HEAD/skills/dry-refactoring/SKILL.md)                        | 结合 jscpd 检测结果，逐步消除重复代码。        | kucherenko/jscpd   |
+| [i-have-adhd](https://github.com/ayghri/i-have-adhd/blob/HEAD/skills/i-have-adhd/SKILL.md)                              | 突出下一步、拆分步骤，减少阅读干扰。           | ayghri/i-have-adhd |
+| [vue-best-practices](https://github.com/vuejs-ai/skills/blob/HEAD/skills/vue-best-practices/SKILL.md)                   | 用 TypeScript 和组合式 API 编写 Vue 3。        | vuejs-ai/skills    |
+| [vue-router-best-practices](https://github.com/vuejs-ai/skills/blob/HEAD/skills/vue-router-best-practices/SKILL.md)     | 处理 Vue Router 路由、守卫与组件生命周期。     | vuejs-ai/skills    |
+| [vue-pinia-best-practices](https://github.com/vuejs-ai/skills/blob/HEAD/skills/vue-pinia-best-practices/SKILL.md)       | 规范 Pinia 状态管理与响应式数据组织。          | vuejs-ai/skills    |
+| [vue-testing-best-practices](https://github.com/vuejs-ai/skills/blob/HEAD/skills/vue-testing-best-practices/SKILL.md)   | 编写 Vue 组件测试、模拟依赖与端到端测试。      | vuejs-ai/skills    |
+| [vue-debug-guides](https://github.com/vuejs-ai/skills/blob/HEAD/skills/vue-debug-guides/SKILL.md)                       | 定位 Vue 运行时、异步与服务端渲染问题。        | vuejs-ai/skills    |
+| [create-adaptable-composable](https://github.com/vuejs-ai/skills/blob/HEAD/skills/create-adaptable-composable/SKILL.md) | 编写兼容普通值、ref 和 getter 的组合函数。     | vuejs-ai/skills    |
+| [frontend-design](https://github.com/anthropics/skills/blob/HEAD/skills/frontend-design/SKILL.md)                       | 打造有辨识度、视觉统一的前端界面。             | anthropics/skills  |
+| [antfu](https://github.com/antfu/skills/blob/HEAD/skills/antfu/SKILL.md)                                                | 采用 Anthony Fu 的 JS/TS 工具链与工程约定。    | antfu/skills       |

package/dist/args.d.ts

@@ -0,0 +1,10 @@
+export interface Options {
+    command: "install" | "list" | "help" | "version";
+    names: string[];
+    all: boolean;
+    dryRun: boolean;
+    json: boolean;
+    nativeArgs: string[];
+}
+export declare function parseArgs(args: string[]): Options;
+export declare const help = "Usage: liuovo-skills [install] [catalog options] [native options]\n       liuovo-skills list [--json]\n\nNo arguments: choose catalog skills, then continue in the native skills CLI.\n\n  -s, --skill <names...>   Select catalog names or owner/repo@name identifiers\n      --all               Select the entire curated catalog\n      --dry-run           Print command arguments only; no downloads or writes\n  -h, --help              Show this help\n  -v, --version           Show package version\n\nOther options are forwarded to skills add unchanged.\nUse -- to pass all remaining arguments directly to skills add.\nFor example: --global --agent codex, or -- --copy --yes.\nInstallation prompts, agents, scope, conflicts, and lock files belong to skills.\nNo --yes or --json is added automatically. Explicit --yes may overwrite skills.\n";

package/dist/args.js

@@ -0,0 +1,72 @@
+export function parseArgs(args) {
+    const options = {
+        command: "install",
+        names: [],
+        all: false,
+        dryRun: false,
+        json: false,
+        nativeArgs: [],
+    };
+    let i = 0;
+    if (["install", "list"].includes(args[0] ?? "")) {
+        options.command = args[0];
+        i++;
+    }
+    for (; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--") {
+            options.nativeArgs.push(...args.slice(i + 1));
+            break;
+        }
+        if (arg === "--help" || arg === "-h")
+            options.command = "help";
+        else if (arg === "--version" || arg === "-v")
+            options.command = "version";
+        else if (arg === "--all")
+            options.all = true;
+        else if (arg === "--dry-run")
+            options.dryRun = true;
+        else if (arg === "--json" && options.command === "list")
+            options.json = true;
+        else if (arg === "--skill" || arg === "-s") {
+            const start = options.names.length;
+            while (args[i + 1] && !args[i + 1].startsWith("-")) {
+                options.names.push(args[++i]);
+            }
+            if (options.names.length === start) {
+                throw new Error(`${arg} requires at least one value.`);
+            }
+        }
+        else {
+            options.nativeArgs.push(arg);
+        }
+    }
+    if (options.all && options.names.length) {
+        throw new Error("--all and --skill are mutually exclusive.");
+    }
+    if (options.command === "list" &&
+        (options.all ||
+            options.names.length ||
+            options.dryRun ||
+            options.nativeArgs.length)) {
+        throw new Error("list only accepts --json.");
+    }
+    return options;
+}
+export const help = `Usage: liuovo-skills [install] [catalog options] [native options]
+       liuovo-skills list [--json]
+
+No arguments: choose catalog skills, then continue in the native skills CLI.
+
+  -s, --skill <names...>   Select catalog names or owner/repo@name identifiers
+      --all               Select the entire curated catalog
+      --dry-run           Print command arguments only; no downloads or writes
+  -h, --help              Show this help
+  -v, --version           Show package version
+
+Other options are forwarded to skills add unchanged.
+Use -- to pass all remaining arguments directly to skills add.
+For example: --global --agent codex, or -- --copy --yes.
+Installation prompts, agents, scope, conflicts, and lock files belong to skills.
+No --yes or --json is added automatically. Explicit --yes may overwrite skills.
+`;

package/dist/catalog.d.ts

@@ -0,0 +1,6 @@
+import type { Skill } from "./types.js";
+export declare const packageRoot: string;
+export declare function validateName(name: unknown): asserts name is string;
+export declare function loadCatalog(root?: string): Promise<Skill[]>;
+export declare function groupByCategory(catalog: Skill[]): Map<string, Skill[]>;
+export declare function selectSkills(catalog: Skill[], names: string[]): Skill[];

package/dist/catalog.js

@@ -0,0 +1,155 @@
+import { readFile, readdir } from "node:fs/promises";
+import { join, relative, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import { parse } from "yaml";
+export const packageRoot = fileURLToPath(new URL("../", import.meta.url));
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+export function validateName(name) {
+    if (typeof name !== "string" ||
+        !/^[a-z0-9]+(?:[-_][a-z0-9]+)*$/.test(name) ||
+        name.length > 64) {
+        throw new Error(`Invalid skill name: ${String(name)}`);
+    }
+}
+function validateSource(source) {
+    if (typeof source !== "string" ||
+        !/^[a-zA-Z0-9_-]+\/[a-zA-Z0-9_.-]+$/.test(source)) {
+        throw new Error(`Expected a GitHub owner/repo source: ${String(source)}`);
+    }
+}
+export async function loadCatalog(root = packageRoot) {
+    const pkg = JSON.parse(await readFile(join(root, "package.json"), "utf8"));
+    if (!record(pkg) ||
+        !Array.isArray(pkg.skills) ||
+        !record(pkg.skillsPack) ||
+        !record(pkg.skillsPack.metadata)) {
+        throw new Error("Invalid package.json skills / skillsPack configuration.");
+    }
+    const metadata = pkg.skillsPack.metadata;
+    const categories = pkg.skillsPack.categories ?? [];
+    if (!Array.isArray(categories) ||
+        categories.some((category) => typeof category !== "string" || !category.trim()) ||
+        new Set(categories).size !== categories.length) {
+        throw new Error("skillsPack.categories must be an array of unique, non-empty category names.");
+    }
+    const categoryOrder = ["自有 Skills", ...categories, "其他"];
+    validateSource(pkg.skillsPack.ownSource);
+    const ownSource = pkg.skillsPack.ownSource;
+    const catalog = [];
+    for (const group of pkg.skills) {
+        if (!record(group) || !Array.isArray(group.skills)) {
+            throw new Error("Each skills entry needs a source and a skills array.");
+        }
+        validateSource(group.source);
+        for (const name of group.skills) {
+            validateName(name);
+            const id = `${group.source}@${name}`;
+            const meta = metadata[id];
+            if (!record(meta) ||
+                typeof meta.description !== "string" ||
+                !meta.description.trim() ||
+                typeof meta.path !== "string" ||
+                !/^skills\/[a-zA-Z0-9_/-]+$/.test(meta.path) ||
+                meta.path.split("/").some((part) => !part)) {
+                throw new Error(`Missing or invalid display metadata for ${id}.`);
+            }
+            const category = meta.category ?? "其他";
+            if (typeof category !== "string" || !category.trim()) {
+                throw new Error(`Category must be a non-empty string for ${id}.`);
+            }
+            if (categories.length && !categoryOrder.includes(category)) {
+                throw new Error(`Category for ${id} is not declared in skillsPack.categories: ${category}`);
+            }
+            catalog.push({
+                id,
+                name,
+                source: group.source,
+                kind: "external",
+                description: meta.description,
+                category,
+                url: `https://github.com/${group.source}/blob/HEAD/${meta.path}/SKILL.md`,
+            });
+        }
+    }
+    async function walk(directory) {
+        let entries;
+        try {
+            entries = await readdir(directory, { withFileTypes: true });
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return;
+            throw error;
+        }
+        entries.sort((a, b) => a.name.localeCompare(b.name));
+        if (entries.some((entry) => entry.name === "SKILL.md" && entry.isFile())) {
+            const text = await readFile(join(directory, "SKILL.md"), "utf8");
+            const header = text.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/)?.[1];
+            const data = header === undefined ? undefined : parse(header);
+            if (!record(data) ||
+                typeof data.description !== "string" ||
+                !data.description.trim()) {
+                throw new Error(`Invalid skill frontmatter: ${directory}/SKILL.md`);
+            }
+            validateName(data.name);
+            catalog.push({
+                id: `${ownSource}@${data.name}`,
+                name: data.name,
+                description: data.description,
+                category: "自有 Skills",
+                source: ownSource,
+                kind: "own",
+                url: `https://github.com/${ownSource}/blob/HEAD/${relative(root, directory).split(sep).join("/")}/SKILL.md`,
+            });
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.isDirectory() &&
+                !entry.name.startsWith(".") &&
+                entry.name !== "node_modules") {
+                await walk(join(directory, entry.name));
+            }
+        }
+    }
+    await walk(join(root, "skills"));
+    const ids = new Set();
+    for (const skill of catalog) {
+        if (ids.has(skill.id))
+            throw new Error(`Duplicate catalog entry: ${skill.id}`);
+        ids.add(skill.id);
+    }
+    const categoryRank = (category) => {
+        const rank = categoryOrder.indexOf(category);
+        return rank === -1 ? categoryOrder.length : rank;
+    };
+    return catalog.sort((a, b) => categoryRank(a.category) - categoryRank(b.category) ||
+        a.category.localeCompare(b.category, "zh-CN") ||
+        a.source.localeCompare(b.source) ||
+        a.name.localeCompare(b.name));
+}
+export function groupByCategory(catalog) {
+    const groups = new Map();
+    for (const skill of catalog) {
+        const group = groups.get(skill.category) ?? [];
+        group.push(skill);
+        groups.set(skill.category, group);
+    }
+    return groups;
+}
+export function selectSkills(catalog, names) {
+    const selected = names.map((name) => {
+        const matches = catalog.filter((skill) => skill.id === name || skill.name === name);
+        if (matches.length === 0)
+            throw new Error(`Unknown skill: ${name}`);
+        if (matches.length > 1) {
+            throw new Error(`Ambiguous skill "${name}". Use one of: ${matches.map((s) => s.id).join(", ")}`);
+        }
+        return matches[0];
+    });
+    const unique = [
+        ...new Map(selected.map((skill) => [skill.id, skill])).values(),
+    ];
+    return unique;
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { help, parseArgs } from "./args.js";
+import { groupByCategory, loadCatalog, packageRoot } from "./catalog.js";
+import { buildCommands, installSkills } from "./install.js";
+import { Cancelled, choose } from "./ui.js";
+async function main() {
+    const options = parseArgs(process.argv.slice(2));
+    if (options.command === "help") {
+        console.log(help);
+        return;
+    }
+    if (options.command === "version") {
+        const pkg = JSON.parse(await readFile(join(packageRoot, "package.json"), "utf8"));
+        console.log(`${pkg.name} ${pkg.version}`);
+        return;
+    }
+    const catalog = await loadCatalog();
+    if (options.command === "list") {
+        if (options.json)
+            console.log(JSON.stringify(catalog, null, 2));
+        else {
+            for (const [category, skills] of groupByCategory(catalog)) {
+                console.log(`\n${category} (${skills.length} skills)`);
+                for (const skill of skills) {
+                    console.log(`  ${skill.name} — ${skill.description}\n    Source: ${skill.source}${skill.kind === "own" ? " (own)" : ""}`);
+                }
+            }
+            console.log(`\n${catalog.length} skills.`);
+        }
+        return;
+    }
+    const skills = await choose(options, catalog, Boolean(process.stdin.isTTY && process.stdout.isTTY));
+    const commands = buildCommands(skills, options.nativeArgs);
+    if (options.dryRun) {
+        console.log(JSON.stringify(commands.map((args) => ["skills", ...args]), null, 2));
+        return;
+    }
+    process.exitCode = await installSkills(commands, {
+        cwd: process.cwd(),
+        env: process.env,
+    });
+}
+main().catch((error) => {
+    console.error(`${error instanceof Cancelled ? "" : "Error: "}${error instanceof Error ? error.message : String(error)}`);
+    process.exitCode = error instanceof Cancelled ? 130 : 1;
+});

package/dist/install.d.ts

@@ -0,0 +1,5 @@
+import type { Context, Skill } from "./types.js";
+export type Runner = (args: string[], context: Context, signal?: AbortSignal) => Promise<number>;
+export declare const runSkills: Runner;
+export declare function buildCommands(skills: Skill[], nativeArgs: string[]): string[][];
+export declare function installSkills(commands: string[][], context: Context, run?: Runner): Promise<number>;

package/dist/install.js

@@ -0,0 +1,58 @@
+import { spawn } from "node:child_process";
+import { constants } from "node:os";
+async function runCommand(command, args, context, signal) {
+    return await new Promise((accept, reject) => {
+        const child = spawn(command, args, {
+            cwd: context.cwd,
+            env: context.env,
+            stdio: "inherit",
+            ...(signal ? { signal } : {}),
+        });
+        child.once("error", reject);
+        child.once("close", (code, childSignal) => {
+            accept(code ?? (childSignal ? 128 + constants.signals[childSignal] : 1));
+        });
+    });
+}
+export const runSkills = async (args, context, signal) => {
+    try {
+        return await runCommand("skills", args, context, signal);
+    }
+    catch (error) {
+        // Only a missing executable permits fallback; never retry a started install.
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+    try {
+        return await runCommand("pnpx", ["skills@latest", ...args], context, signal);
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            throw new Error("Neither skills nor pnpx was found on PATH. Install skills or pnpm, then retry.");
+        }
+        throw error;
+    }
+};
+export function buildCommands(skills, nativeArgs) {
+    const groups = new Map();
+    for (const skill of skills) {
+        const names = groups.get(skill.source) ?? [];
+        names.push(skill.name);
+        groups.set(skill.source, names);
+    }
+    return [...groups].map(([source, names]) => [
+        "add",
+        source,
+        "--skill",
+        ...names,
+        ...nativeArgs,
+    ]);
+}
+export async function installSkills(commands, context, run = runSkills) {
+    for (const args of commands) {
+        const code = await run(args, context);
+        if (code !== 0)
+            return code;
+    }
+    return 0;
+}

package/dist/picker.d.ts

@@ -0,0 +1,21 @@
+import { AutocompletePrompt } from "@clack/core";
+export interface PickerOption {
+    value: string;
+    label: string;
+    description: string;
+    category: string;
+    source?: string;
+}
+export declare function matchesOption(query: string, option: PickerOption): boolean;
+export interface PickerFrame {
+    message: string;
+    state: AutocompletePrompt<PickerOption>["state"];
+    options: PickerOption[];
+    filtered: PickerOption[];
+    selected: string[];
+    cursor: number;
+    input: string;
+    error: string;
+}
+export declare function renderPicker(frame: PickerFrame): string;
+export declare function searchMultiselect(message: string, options: PickerOption[]): Promise<string[] | symbol>;

package/dist/picker.js

@@ -0,0 +1,89 @@
+import { AutocompletePrompt, isCancel } from "@clack/core";
+import { limitOptions, symbol } from "@clack/prompts";
+import { styleText } from "node:util";
+export function matchesOption(query, option) {
+    const terms = query.trim().toLocaleLowerCase().split(/\s+/);
+    const text = [
+        option.value,
+        option.label,
+        option.description,
+        option.category,
+        option.source,
+    ]
+        .join(" ")
+        .toLocaleLowerCase();
+    return terms.every((term) => text.includes(term));
+}
+// Clack owns keyboard input and selection state; this renderer adds category
+// headings and always-visible descriptions without making headings selectable.
+export function renderPicker(frame) {
+    const heading = `${symbol(frame.state)}  ${frame.message}`;
+    const chosen = frame.options
+        .filter((option) => frame.selected.includes(option.value))
+        .map((option) => option.label);
+    if (frame.state === "submit") {
+        return `${heading}\n│  ${chosen.length} items selected: ${chosen.join(", ")}`;
+    }
+    if (frame.state === "cancel")
+        return `${heading}\n│  Cancelled.`;
+    const focused = frame.filtered[frame.cursor];
+    const lines = [
+        heading,
+        `│  Search: ${frame.input || styleText("dim", "Name / description / category / source")}`,
+        `│  ${frame.filtered.length} matches · ${frame.selected.length} selected${focused ? ` · Category: ${focused.category}` : ""}`,
+    ];
+    if (frame.state === "error")
+        lines.push(`│  ${styleText("yellow", frame.error)}`);
+    if (!frame.filtered.length)
+        lines.push("│  No matches found. Try another keyword.");
+    let previousCategory;
+    const rows = limitOptions({
+        options: frame.filtered,
+        cursor: frame.cursor,
+        maxItems: 10,
+        columnPadding: 3,
+        rowPadding: lines.length + 4,
+        style: (option, active) => {
+            const category = previousCategory === option.category
+                ? ""
+                : `${styleText("cyan", `── ${option.category} ──`)}\n`;
+            previousCategory = option.category;
+            const checkbox = frame.selected.includes(option.value) ? "[✓]" : "[ ]";
+            const name = active ? styleText("bold", option.label) : option.label;
+            return `${category}${active ? "›" : " "} ${checkbox} ${name}  ${styleText("dim", option.description)}`;
+        },
+    });
+    lines.push(...rows.map((row) => `│  ${row}`));
+    if (focused?.source)
+        lines.push(`│  Source: ${focused.source}`);
+    lines.push("│  ↑/↓ to navigate · Tab: select · Enter: confirm", "│  Type to search; selections are preserved · Esc: cancel", "└");
+    return lines.join("\n");
+}
+export async function searchMultiselect(message, options) {
+    const prompt = new AutocompletePrompt({
+        options,
+        multiple: true,
+        filter: matchesOption,
+        validate: () => prompt.selectedValues.length
+            ? undefined
+            : "Please select at least one item.",
+        render() {
+            return renderPicker({
+                message,
+                state: this.state,
+                options: this.options,
+                filtered: this.filteredOptions,
+                selected: this.selectedValues,
+                cursor: this.cursor,
+                input: this.userInput ? this.userInputWithCursor : "",
+                error: this.error,
+            });
+        },
+    });
+    const answer = await prompt.prompt();
+    if (isCancel(answer))
+        return answer;
+    if (!Array.isArray(answer))
+        throw new Error("Invalid selection result. Please try again.");
+    return answer;
+}

package/dist/types.d.ts

@@ -0,0 +1,13 @@
+export interface Skill {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+    source: string;
+    kind: "own" | "external";
+    url?: string;
+}
+export interface Context {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/ui.d.ts

@@ -0,0 +1,5 @@
+import type { Options } from "./args.js";
+import type { Skill } from "./types.js";
+export declare class Cancelled extends Error {
+}
+export declare function choose(options: Options, catalog: Skill[], interactive: boolean): Promise<Skill[]>;

package/dist/ui.js

@@ -0,0 +1,25 @@
+import { selectSkills } from "./catalog.js";
+import { searchMultiselect } from "./picker.js";
+export class Cancelled extends Error {
+}
+export async function choose(options, catalog, interactive) {
+    if (!catalog.length)
+        throw new Error("The catalog is empty.");
+    if (options.all)
+        return selectSkills(catalog, catalog.map((skill) => skill.id));
+    if (options.names.length)
+        return selectSkills(catalog, options.names);
+    if (!interactive) {
+        throw new Error("Non-interactive catalog selection requires --skill <names...> or --all.");
+    }
+    const names = await searchMultiselect("Which skills? Type to search; Tab to select.", catalog.map((skill) => ({
+        value: skill.id,
+        label: skill.name,
+        description: skill.description,
+        category: skill.category,
+        source: skill.kind === "own" ? `${skill.source} (own)` : skill.source,
+    })));
+    if (typeof names === "symbol")
+        throw new Cancelled("Cancelled.");
+    return selectSkills(catalog, names);
+}

package/package.json

@@ -1,6 +1,213 @@
 {
   "name": "@liuovo/skills",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.2",
+  "description": "Personal skills and curated upstream references, installed through one interactive CLI.",
+  "type": "module",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/liuc-c/skills.git"
+  },
+  "bin": {
+    "liuovo-skills": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "engines": {
+    "node": ">=22.20.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@clack/core": "1.5.1",
+    "@clack/prompts": "1.8.1",
+    "yaml": "2.9.1"
+  },
+  "devDependencies": {
+    "@types/node": "22.20.5",
+    "bumpp": "12.3.0",
+    "prettier": "3.9.10",
+    "skills": "latest",
+    "tsx": "4.23.15",
+    "typescript": "5.9.3"
+  },
+  "skills": [
+    {
+      "source": "mattpocock/skills",
+      "skills": [
+        "grill-me",
+        "grilling",
+        "handoff",
+        "codebase-design",
+        "writing-for-agents",
+        "to-questionnaire",
+        "code-review",
+        "research"
+      ]
+    },
+    {
+      "source": "shadcn/improve",
+      "skills": [
+        "improve"
+      ]
+    },
+    {
+      "source": "kucherenko/jscpd",
+      "skills": [
+        "dry-refactoring"
+      ]
+    },
+    {
+      "source": "ayghri/i-have-adhd",
+      "skills": [
+        "i-have-adhd"
+      ]
+    },
+    {
+      "source": "vuejs-ai/skills",
+      "skills": [
+        "vue-best-practices",
+        "vue-router-best-practices",
+        "vue-pinia-best-practices",
+        "vue-testing-best-practices",
+        "vue-debug-guides",
+        "create-adaptable-composable"
+      ]
+    },
+    {
+      "source": "anthropics/skills",
+      "skills": [
+        "frontend-design"
+      ]
+    },
+    {
+      "source": "antfu/skills",
+      "skills": [
+        "antfu"
+      ]
+    }
+  ],
+  "skillsPack": {
+    "ownSource": "liuc-c/skills",
+    "metadata": {
+      "mattpocock/skills@grill-me": {
+        "description": "通过连续追问，把模糊方案打磨清楚。",
+        "path": "skills/productivity/grill-me",
+        "category": "方案推敲"
+      },
+      "mattpocock/skills@grilling": {
+        "description": "质询计划与决策，找出遗漏和薄弱环节。",
+        "path": "skills/productivity/grilling",
+        "category": "方案推敲"
+      },
+      "mattpocock/skills@handoff": {
+        "description": "把当前对话整理成可接续的交接文档。",
+        "path": "skills/productivity/handoff",
+        "category": "协作与表达"
+      },
+      "mattpocock/skills@codebase-design": {
+        "description": "用统一概念设计职责清晰、接口简洁的模块。",
+        "path": "skills/engineering/codebase-design",
+        "category": "代码设计与重构"
+      },
+      "mattpocock/skills@writing-for-agents": {
+        "description": "编写清晰、可执行的 Agent 文档与 Skills。",
+        "path": "skills/productivity/writing-for-agents",
+        "category": "协作与表达"
+      },
+      "mattpocock/skills@to-questionnaire": {
+        "description": "将难以独自定夺的决策整理成问卷，交给他人填写。",
+        "path": "skills/productivity/to-questionnaire",
+        "category": "方案推敲"
+      },
+      "mattpocock/skills@code-review": {
+        "description": "对照仓库规范与原始需求，审查指定基准后的改动。",
+        "path": "skills/engineering/code-review",
+        "category": "代码设计与重构"
+      },
+      "mattpocock/skills@research": {
+        "description": "基于高可信一手来源调研，并将结论写入仓库。",
+        "path": "skills/engineering/research",
+        "category": "协作与表达"
+      },
+      "shadcn/improve@improve": {
+        "description": "审视代码库，按优先级生成可交付的改进计划。",
+        "path": "skills/improve",
+        "category": "代码设计与重构"
+      },
+      "kucherenko/jscpd@dry-refactoring": {
+        "description": "结合 jscpd 检测结果，逐步消除重复代码。",
+        "path": "skills/dry-refactoring",
+        "category": "代码设计与重构"
+      },
+      "ayghri/i-have-adhd@i-have-adhd": {
+        "description": "突出下一步、拆分步骤，减少阅读干扰。",
+        "path": "skills/i-have-adhd",
+        "category": "协作与表达"
+      },
+      "vuejs-ai/skills@vue-best-practices": {
+        "description": "用 TypeScript 和组合式 API 编写 Vue 3。",
+        "path": "skills/vue-best-practices",
+        "category": "Vue 开发"
+      },
+      "vuejs-ai/skills@vue-router-best-practices": {
+        "description": "处理 Vue Router 路由、守卫与组件生命周期。",
+        "path": "skills/vue-router-best-practices",
+        "category": "Vue 开发"
+      },
+      "vuejs-ai/skills@vue-pinia-best-practices": {
+        "description": "规范 Pinia 状态管理与响应式数据组织。",
+        "path": "skills/vue-pinia-best-practices",
+        "category": "Vue 开发"
+      },
+      "vuejs-ai/skills@vue-testing-best-practices": {
+        "description": "编写 Vue 组件测试、模拟依赖与端到端测试。",
+        "path": "skills/vue-testing-best-practices",
+        "category": "Vue 开发"
+      },
+      "vuejs-ai/skills@vue-debug-guides": {
+        "description": "定位 Vue 运行时、异步与服务端渲染问题。",
+        "path": "skills/vue-debug-guides",
+        "category": "Vue 开发"
+      },
+      "vuejs-ai/skills@create-adaptable-composable": {
+        "description": "编写兼容普通值、ref 和 getter 的组合函数。",
+        "path": "skills/create-adaptable-composable",
+        "category": "Vue 开发"
+      },
+      "anthropics/skills@frontend-design": {
+        "description": "打造有辨识度、视觉统一的前端界面。",
+        "path": "skills/frontend-design",
+        "category": "前端设计"
+      },
+      "antfu/skills@antfu": {
+        "description": "采用 Anthony Fu 的 JS/TS 工具链与工程约定。",
+        "path": "skills/antfu",
+        "category": "代码设计与重构"
+      }
+    },
+    "categories": [
+      "方案推敲",
+      "协作与表达",
+      "代码设计与重构",
+      "前端设计",
+      "Vue 开发"
+    ]
+  },
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
+    "test": "node --import tsx --test test/*.test.ts",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "check": "pnpm typecheck && pnpm test && pnpm format:check",
+    "preversion": "git rev-parse --verify @{upstream} && pnpm check",
+    "release:check": "pnpm check && npm pack --dry-run",
+    "release": "bumpp && pnpm publish"
+  }
 }

package/skills/.gitkeep

@@ -0,0 +1 @@
+