@ycodium-ai/plugin-skill-discovery 0.2.0

package/README.md

@@ -0,0 +1,35 @@
+# @ycodium-ai/plugin-skill-discovery
+
+Lists skill packages that other agent tools have already installed on this
+machine. The listing is read-only: those directories belong to the other
+tools.
+
+## What it does
+
+The `list` command scans Claude, Codex, Cursor, and the shared
+`~/.agents/skills` tree. Provider homes come from the host's current instance
+list, so a moved Claude or Codex home is still found. Skills with the same
+name are merged; identical copies are marked as such.
+
+## Install
+
+```
+ycodium plugin add @ycodium-ai/plugin-skill-discovery
+```
+
+The plugin asks to read provider home directories and `~/.agents/skills`. It
+does not write or take over those files.
+
+Ycodium ships it enabled as `core.skill-discovery`. Disabling it stops the
+listing command. Uninstalling it writes a removal to the home patch so a
+restart does not bring it back.
+
+## Developing
+
+Built from the Ycodium repository. The Node entry is bundled, but
+`@ycodium-ai/plugin-api` stays external and is provided by the Ycodium host at
+load time.
+
+## License
+
+UNLICENSED.

package/dist/index.js

@@ -0,0 +1,153 @@
+// src/index.ts
+import * as NodeCrypto from "node:crypto";
+import * as NodeOS from "node:os";
+import * as NodePath from "node:path";
+import { definePlugin } from "@ycodium-ai/plugin-api";
+
+// src/discovery.ts
+var SKILLS_SUBDIRECTORY = {
+  claude: "skills",
+  codex: "skills",
+  // 不是 `skills`。抄错这一个字符的后果是「Cursor 的技能一个都读不到」,而且不会报错。
+  cursor: "skills-cursor"
+};
+var DEFAULT_HOME_DIRECTORY = {
+  claude: ".claude",
+  codex: ".codex",
+  cursor: ".cursor"
+};
+var SHARED_HOME_DIRECTORY = ".agents";
+var SHARED_SKILLS_SUBDIRECTORY = "skills";
+var skillSourceRoots = (input) => {
+  const seen = /* @__PURE__ */ new Set();
+  const roots = [];
+  const push = (tool, path) => {
+    if (seen.has(path)) return;
+    seen.add(path);
+    roots.push({ tool, path });
+  };
+  push("shared", input.join(input.homedir, SHARED_HOME_DIRECTORY, SHARED_SKILLS_SUBDIRECTORY));
+  for (const tool of ["claude", "codex", "cursor"]) {
+    const subdirectory = SKILLS_SUBDIRECTORY[tool];
+    if (subdirectory === null) continue;
+    const homes = input.resolvedHomes[tool] ?? [];
+    if (homes.length === 0) {
+      push(tool, input.join(input.homedir, DEFAULT_HOME_DIRECTORY[tool], subdirectory));
+      continue;
+    }
+    for (const home of homes) push(tool, input.join(home, subdirectory));
+  }
+  return roots;
+};
+var mergeDiscoveredSkills = (discovered) => {
+  const byName = /* @__PURE__ */ new Map();
+  for (const skill of discovered) {
+    const existing = byName.get(skill.name);
+    if (existing === void 0) byName.set(skill.name, [skill]);
+    else existing.push(skill);
+  }
+  return [...byName.entries()].map(([name, sources]) => ({
+    name,
+    sources,
+    identical: sources.every((source) => source.digest === sources[0]?.digest)
+  })).sort((left, right) => left.name.localeCompare(right.name));
+};
+var parseSkillFrontMatter = (content) => {
+  const lines = content.split(/\r?\n/);
+  if (lines[0]?.trim() !== "---") return { description: null, version: null };
+  let description = null;
+  let version = null;
+  for (const line of lines.slice(1)) {
+    if (line.trim() === "---") break;
+    const match = /^(description|version):\s*(.+)$/.exec(line);
+    if (match === null) continue;
+    const value = (match[2] ?? "").trim().replace(/^["']|["']$/g, "");
+    if (value.length === 0) continue;
+    if (match[1] === "description" && description === null) description = value;
+    if (match[1] === "version" && version === null) version = value;
+  }
+  return { description, version };
+};
+
+// src/index.ts
+var SKILL_FILE = "SKILL.md";
+var LIST_PAYLOAD_SCHEMA = {
+  type: "object",
+  properties: {},
+  additionalProperties: false
+};
+var toolForDriver = (driver) => driver === "claudeAgent" ? "claude" : driver === "codex" ? "codex" : driver === "cursor" ? "cursor" : null;
+var digestOf = (content) => NodeCrypto.createHash("sha256").update(content, "utf8").digest("hex");
+var scanRoot = async (ctx, root) => {
+  let entries;
+  try {
+    entries = await ctx.fs.readDir(root.path);
+  } catch {
+    return [];
+  }
+  const found = [];
+  for (const entry of entries) {
+    if (entry.type !== "directory") continue;
+    const skillPath = NodePath.join(root.path, entry.name);
+    let content;
+    try {
+      content = await ctx.fs.readFile(NodePath.join(skillPath, SKILL_FILE));
+    } catch {
+      continue;
+    }
+    const { description, version } = parseSkillFrontMatter(content);
+    found.push({
+      tool: root.tool,
+      // 名字取目录名而不是 front matter 里的 `name`:调用它的是目录名,两者不一致时
+      // 显示 front matter 那个会让人按显示的名字去调,然后调不到。
+      name: entry.name,
+      path: skillPath,
+      digest: digestOf(content),
+      description,
+      version
+    });
+  }
+  return found;
+};
+var rootsFor = async (ctx) => {
+  const homes = {};
+  try {
+    for (const instance of await ctx.providers.listInstances()) {
+      const tool = toolForDriver(instance.driver);
+      if (tool === null || instance.homePath === null) continue;
+      (homes[tool] ??= []).push(instance.homePath);
+    }
+  } catch (error) {
+    ctx.log.warn("could not list provider instances; scanning the default locations only", {
+      detail: error instanceof Error ? error.message : String(error)
+    });
+  }
+  return skillSourceRoots({
+    homedir: NodeOS.homedir(),
+    resolvedHomes: homes,
+    join: (...segments) => NodePath.join(...segments)
+  });
+};
+var list = async (ctx) => {
+  const roots = await rootsFor(ctx);
+  const discovered = [];
+  for (const root of roots) discovered.push(...await scanRoot(ctx, root));
+  return { skills: mergeDiscoveredSkills(discovered), scannedRoots: roots.length };
+};
+var index_default = definePlugin({
+  id: "skill-discovery",
+  apiVersion: 2,
+  activate: (ctx) => {
+    ctx.command({
+      name: "list",
+      description: "Lists the skill packages other agent tools have installed on this machine.",
+      // 纯读盘,没有任何写操作。
+      scope: "read",
+      payloadSchema: LIST_PAYLOAD_SCHEMA,
+      handle: () => list(ctx)
+    });
+  }
+});
+export {
+  index_default as default
+};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@ycodium-ai/plugin-skill-discovery",
+  "version": "0.2.0",
+  "description": "Lists skill packages other agent tools have installed on this machine.",
+  "keywords": [
+    "skills",
+    "ycodium",
+    "ycodium-plugin"
+  ],
+  "license": "UNLICENSED",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@effect/vitest": "4.0.0-beta.103",
+    "@types/node": "24.12.4",
+    "esbuild": "0.28.1",
+    "vite-plus": "0.2.2",
+    "@ycodium-ai/plugin-api": "0.1.1"
+  },
+  "ycodium": {
+    "plugin": "./dist/index.js",
+    "displayName": "Skill discovery",
+    "description": "Lists skill packages other agent tools have installed on this machine.",
+    "icon": "blocks",
+    "permissions": [
+      {
+        "kind": "providers.homes"
+      },
+      {
+        "kind": "fs.read",
+        "paths": [
+          "~/.agents/skills"
+        ]
+      }
+    ]
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "typecheck": "tsgo --noEmit",
+    "test": "vp test run"
+  }
+}