@inhuman.tools/project-skills 0.0.0-stage → 0.1.0

package/LICENSE.md

@@ -0,0 +1,7 @@
+Copyright 2026 Merkle Bonsai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export type DiscoveredSkill = {
+    readonly name: string;
+    readonly description: string;
+    readonly location: string;
+    readonly invoke: string;
+};
+export declare function discoverProjectSkills(projectPath: string, home?: string | null, reserved?: ReadonlySet<string>): DiscoveredSkill[];
+export type SkillExpansion = {
+    /** What was typed. Unchanged when the slash is not a skill. */
+    readonly prompt: string;
+    /** Model injection when it differs from `prompt`. Null otherwise. */
+    readonly derived: string | null;
+};
+export declare function expandSkillPrompt(text: string, skills: readonly {
+    readonly name: string;
+    readonly location: string;
+    readonly invoke?: string;
+}[], reserved: ReadonlySet<string>): SkillExpansion;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqCA,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EACpB,QAAQ,GAAE,WAAW,CAAC,MAAM,CAAa,GACxC,eAAe,EAAE,CAkBnB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EACjG,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,cAAc,CAiBhB"}

package/dist/index.js

@@ -0,0 +1,301 @@
+/**
+ * Gentlemen's drawers first, then courtesy vendor dirs. Project walks
+ * cwd to git root. One level. Farm symlink is not the Claude drawer.
+ */
+import { existsSync, lstatSync, readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, resolve, sep } from "node:path";
+import { parse as parseYaml } from "yaml";
+const NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const DESCRIPTION_MAX = 1024;
+const GITDIR_LINE = /^gitdir:\s*(\S.*)$/m;
+const PROJECT_DRAWERS = [
+    ".agents/skills",
+    ".claude/skills",
+    ".cursor/skills",
+    ".codex/skills",
+    ".github/skills",
+    ".gemini/skills",
+    ".grok/skills",
+    ".opencode/skills",
+    ".pi/skills",
+];
+const USER_DRAWERS = [
+    ".agents/skills",
+    ".config/agents/skills",
+    ".claude/skills",
+    ".cursor/skills",
+    ".codex/skills",
+    ".copilot/skills",
+    ".gemini/skills",
+    ".grok/skills",
+    ".config/opencode/skills",
+    ".pi/agent/skills",
+];
+export function discoverProjectSkills(projectPath, home, reserved = new Set()) {
+    if (projectPath === "")
+        return [];
+    const seen = new Set();
+    const texts = new Map();
+    const project = [];
+    for (const dir of walkToRepoRoot(projectPath)) {
+        for (const drawer of PROJECT_DRAWERS) {
+            scanDrawer(join(dir, ...drawer.split("/")), dir, project, seen, texts);
+        }
+    }
+    const user = [];
+    const userHome = home === undefined ? userSkillsHome() : home;
+    if (userHome != null && userHome !== "") {
+        for (const drawer of USER_DRAWERS) {
+            scanDrawer(join(userHome, ...drawer.split("/")), userHome, user, seen, texts);
+        }
+    }
+    return qualify([...project, ...user], reserved);
+}
+export function expandSkillPrompt(text, skills, reserved) {
+    const trimmed = text.trim();
+    const hit = skillSlash(trimmed, skills, reserved);
+    if (hit == null)
+        return { prompt: trimmed, derived: null };
+    let source;
+    try {
+        source = readFileSync(hit.skill.location, "utf8");
+    }
+    catch {
+        return { prompt: trimmed, derived: null };
+    }
+    const parsed = parseSkillMarkdown(source, hit.skill.name);
+    if (parsed == null)
+        return { prompt: trimmed, derived: null };
+    const body = parsed.body.trim();
+    if (body === "")
+        return { prompt: trimmed, derived: null };
+    const injection = skillInjection(hit.skill.name, hit.skill.location, body, hit.rest);
+    if (injection === trimmed)
+        return { prompt: trimmed, derived: null };
+    return { prompt: trimmed, derived: injection };
+}
+function skillInjection(name, location, body, rest) {
+    const block = `<skill name="${name}" location="${location}">\n${body}\n</skill>`;
+    return rest === "" ? block : `${block}\n\n${rest}`;
+}
+/** Closed under Vitest unless `INHUMAN_HOME` points at a fixture. */
+function userSkillsHome() {
+    const override = process.env.INHUMAN_HOME?.trim();
+    if (override !== undefined && override !== "")
+        return override;
+    if (process.env.VITEST)
+        return null;
+    return homedir();
+}
+function walkToRepoRoot(start) {
+    const out = [];
+    let dir = resolve(start);
+    for (;;) {
+        out.push(dir);
+        if (gitDirOf(dir) != null)
+            return out;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return [resolve(start)];
+        dir = parent;
+    }
+}
+/** A `.git` directory, or a file whose `gitdir:` line resolves. A stray file does not count. */
+function gitDirOf(root) {
+    const dot = join(root, ".git");
+    try {
+        const st = statSync(dot);
+        if (st.isDirectory())
+            return dot;
+        if (!st.isFile())
+            return null;
+        const match = GITDIR_LINE.exec(readFileSync(dot, "utf8"));
+        const line = match?.[1];
+        if (line == null)
+            return null;
+        return resolve(root, line.trim());
+    }
+    catch {
+        return null;
+    }
+}
+function scanDrawer(root, origin, out, seen, texts) {
+    if (pointsAtClaude(root, origin) || pointsAtClaude(dirname(root), origin))
+        return;
+    let entries;
+    try {
+        entries = readdirSync(root, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory() && !entry.isSymbolicLink())
+            continue;
+        const name = entry.name;
+        if (!NAME.test(name) || name.length > 64)
+            continue;
+        const location = join(root, name, "SKILL.md");
+        let real;
+        try {
+            real = realpathSync(location);
+        }
+        catch {
+            continue;
+        }
+        if (seen.has(real))
+            continue;
+        const parsed = parseSkillFile(location, name);
+        if (parsed == null)
+            continue;
+        const bag = texts.get(name) ?? new Set();
+        if (bag.has(parsed.text))
+            continue;
+        seen.add(real);
+        bag.add(parsed.text);
+        texts.set(name, bag);
+        out.push({ name: parsed.name, description: parsed.description, location, invoke: parsed.name });
+    }
+}
+function qualify(rows, reserved) {
+    const used = new Set();
+    const seenName = new Set();
+    const out = [];
+    for (const row of rows) {
+        const first = !seenName.has(row.name);
+        seenName.add(row.name);
+        const invoke = first && !reserved.has(row.name)
+            ? row.name
+            : first
+                ? uniqueInvoke(`skill:${row.name}`, used)
+                : uniqueInvoke(qualifyInvoke(row), used);
+        used.add(invoke);
+        used.add(row.name);
+        out.push({ ...row, invoke });
+    }
+    out.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    return out;
+}
+function qualifyInvoke(row) {
+    const location = row.location.replaceAll("\\", "/");
+    if (location.includes("/.config/agents/skills/"))
+        return `config:${row.name}`;
+    if (location.includes("/.config/opencode/skills/"))
+        return `opencode:${row.name}`;
+    if (location.includes("/.pi/agent/skills/"))
+        return `pi:${row.name}`;
+    if (location.includes("/.claude/skills/"))
+        return `claude:${row.name}`;
+    if (location.includes("/.agents/skills/"))
+        return `agents:${row.name}`;
+    if (location.includes("/.cursor/skills/"))
+        return `cursor:${row.name}`;
+    if (location.includes("/.codex/skills/"))
+        return `codex:${row.name}`;
+    if (location.includes("/.github/skills/"))
+        return `github:${row.name}`;
+    if (location.includes("/.copilot/skills/"))
+        return `copilot:${row.name}`;
+    if (location.includes("/.gemini/skills/"))
+        return `gemini:${row.name}`;
+    if (location.includes("/.grok/skills/"))
+        return `grok:${row.name}`;
+    if (location.includes("/.opencode/skills/"))
+        return `opencode:${row.name}`;
+    if (location.includes("/.pi/skills/"))
+        return `pi:${row.name}`;
+    return row.name;
+}
+function uniqueInvoke(base, used) {
+    if (!used.has(base))
+        return base;
+    let i = 2;
+    for (;;) {
+        const next = `${base}-${i}`;
+        if (!used.has(next))
+            return next;
+        i += 1;
+    }
+}
+function skillSlash(text, skills, reserved) {
+    const first = (text.split("\n")[0] ?? "").trim();
+    const token = first.split(/\s/)[0] ?? "";
+    if (!token.startsWith("/") || token.length < 2)
+        return null;
+    if (token.includes("/", 1) || token.includes("\\"))
+        return null;
+    const verb = token.slice(1);
+    if (reserved.has(verb))
+        return null;
+    const prefixed = verb.startsWith("skill:") ? verb.slice("skill:".length) : null;
+    if (prefixed != null && !NAME.test(prefixed))
+        return null;
+    const skill = prefixed != null
+        ? skills.find((row) => row.name === prefixed)
+        : (skills.find((row) => (row.invoke ?? row.name) === verb) ??
+            skills.find((row) => row.name === verb && !reserved.has(row.name)));
+    if (skill == null)
+        return null;
+    const rest = text.slice(text.indexOf(verb) + verb.length).trim();
+    return { skill, rest };
+}
+function pointsAtClaude(path, projectPath) {
+    try {
+        if (!lstatSync(path).isSymbolicLink())
+            return false;
+        const target = realpathSync(path);
+        const claude = join(projectPath, ".claude");
+        const claudeReal = existsSync(claude) ? realpathSync(claude) : resolve(claude);
+        return target === claudeReal || target.startsWith(claudeReal + sep);
+    }
+    catch {
+        return false;
+    }
+}
+function parseSkillFile(location, dirName) {
+    let source;
+    try {
+        source = readFileSync(location, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const parsed = parseSkillMarkdown(source, dirName);
+    if (parsed == null)
+        return null;
+    return { name: parsed.name, description: parsed.description, text: parsed.text };
+}
+function parseSkillMarkdown(source, dirName) {
+    const text = source.replace(/^\uFEFF/, "").replaceAll("\r\n", "\n");
+    const match = /^---\n([\s\S]*?)\n---\n?/.exec(text);
+    if (match == null)
+        return null;
+    const bag = frontmatterRecord(match[1]);
+    if (bag == null)
+        return null;
+    const parsedName = typeof bag.name === "string" ? bag.name : "";
+    const name = parsedName === "" ? dirName : parsedName;
+    const description = typeof bag.description === "string" ? bag.description : "";
+    if (name !== dirName || !NAME.test(name) || name.length > 64)
+        return null;
+    if (description === "" || description.length > DESCRIPTION_MAX)
+        return null;
+    return { name, description, body: text.slice(match[0].length), text };
+}
+function frontmatterRecord(text) {
+    let parsed;
+    try {
+        parsed = parseYaml(text) ?? {};
+    }
+    catch {
+        return null;
+    }
+    if (parsed == null || typeof parsed !== "object" || Array.isArray(parsed))
+        return null;
+    const bag = {};
+    for (const [key, item] of Object.entries(parsed))
+        bag[key] = item;
+    return bag;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@inhuman.tools/project-skills",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Skill drawers from the working directory up to the git root, then the user home.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!**/__tests__"
+  ],
+  "dependencies": {
+    "yaml": "^2.8.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "eslint": "9.39.2",
+    "typescript": "6.0.2",
+    "vitest": "4.1.0",
+    "@-internal-/eslint-configs": "0.0.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/here-build/inhuman-harness.git",
+    "directory": "packages/project-skills"
+  },
+  "browserslist": [
+    "node >= 22"
+  ],
+  "author": "Merkle Bonsai",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "tsc -p tsconfig.json --noEmit && vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }

package/src/index.ts

@@ -0,0 +1,301 @@
+/**
+ * Gentlemen's drawers first, then courtesy vendor dirs. Project walks
+ * cwd to git root. One level. Farm symlink is not the Claude drawer.
+ */
+import { existsSync, lstatSync, readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, resolve, sep } from "node:path";
+
+import { parse as parseYaml } from "yaml";
+
+const NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const DESCRIPTION_MAX = 1024;
+const GITDIR_LINE = /^gitdir:\s*(\S.*)$/m;
+const PROJECT_DRAWERS = [
+  ".agents/skills",
+  ".claude/skills",
+  ".cursor/skills",
+  ".codex/skills",
+  ".github/skills",
+  ".gemini/skills",
+  ".grok/skills",
+  ".opencode/skills",
+  ".pi/skills",
+] as const;
+const USER_DRAWERS = [
+  ".agents/skills",
+  ".config/agents/skills",
+  ".claude/skills",
+  ".cursor/skills",
+  ".codex/skills",
+  ".copilot/skills",
+  ".gemini/skills",
+  ".grok/skills",
+  ".config/opencode/skills",
+  ".pi/agent/skills",
+] as const;
+
+export type DiscoveredSkill = {
+  readonly name: string;
+  readonly description: string;
+  readonly location: string;
+  readonly invoke: string;
+};
+
+export function discoverProjectSkills(
+  projectPath: string,
+  home?: string | null,
+  reserved: ReadonlySet<string> = new Set(),
+): DiscoveredSkill[] {
+  if (projectPath === "") return [];
+  const seen = new Set<string>();
+  const texts = new Map<string, Set<string>>();
+  const project: DiscoveredSkill[] = [];
+  for (const dir of walkToRepoRoot(projectPath)) {
+    for (const drawer of PROJECT_DRAWERS) {
+      scanDrawer(join(dir, ...drawer.split("/")), dir, project, seen, texts);
+    }
+  }
+  const user: DiscoveredSkill[] = [];
+  const userHome = home === undefined ? userSkillsHome() : home;
+  if (userHome != null && userHome !== "") {
+    for (const drawer of USER_DRAWERS) {
+      scanDrawer(join(userHome, ...drawer.split("/")), userHome, user, seen, texts);
+    }
+  }
+  return qualify([...project, ...user], reserved);
+}
+
+export type SkillExpansion = {
+  /** What was typed. Unchanged when the slash is not a skill. */
+  readonly prompt: string;
+  /** Model injection when it differs from `prompt`. Null otherwise. */
+  readonly derived: string | null;
+};
+
+export function expandSkillPrompt(
+  text: string,
+  skills: readonly { readonly name: string; readonly location: string; readonly invoke?: string }[],
+  reserved: ReadonlySet<string>,
+): SkillExpansion {
+  const trimmed = text.trim();
+  const hit = skillSlash(trimmed, skills, reserved);
+  if (hit == null) return { prompt: trimmed, derived: null };
+  let source;
+  try {
+    source = readFileSync(hit.skill.location, "utf8");
+  } catch {
+    return { prompt: trimmed, derived: null };
+  }
+  const parsed = parseSkillMarkdown(source, hit.skill.name);
+  if (parsed == null) return { prompt: trimmed, derived: null };
+  const body = parsed.body.trim();
+  if (body === "") return { prompt: trimmed, derived: null };
+  const injection = skillInjection(hit.skill.name, hit.skill.location, body, hit.rest);
+  if (injection === trimmed) return { prompt: trimmed, derived: null };
+  return { prompt: trimmed, derived: injection };
+}
+
+function skillInjection(name: string, location: string, body: string, rest: string): string {
+  const block = `<skill name="${name}" location="${location}">\n${body}\n</skill>`;
+  return rest === "" ? block : `${block}\n\n${rest}`;
+}
+
+/** Closed under Vitest unless `INHUMAN_HOME` points at a fixture. */
+function userSkillsHome(): string | null {
+  const override = process.env.INHUMAN_HOME?.trim();
+  if (override !== undefined && override !== "") return override;
+  if (process.env.VITEST) return null;
+  return homedir();
+}
+
+function walkToRepoRoot(start: string): string[] {
+  const out: string[] = [];
+  let dir = resolve(start);
+  for (;;) {
+    out.push(dir);
+    if (gitDirOf(dir) != null) return out;
+    const parent = dirname(dir);
+    if (parent === dir) return [resolve(start)];
+    dir = parent;
+  }
+}
+
+/** A `.git` directory, or a file whose `gitdir:` line resolves. A stray file does not count. */
+function gitDirOf(root: string): string | null {
+  const dot = join(root, ".git");
+  try {
+    const st = statSync(dot);
+    if (st.isDirectory()) return dot;
+    if (!st.isFile()) return null;
+    const match = GITDIR_LINE.exec(readFileSync(dot, "utf8"));
+    const line = match?.[1];
+    if (line == null) return null;
+    return resolve(root, line.trim());
+  } catch {
+    return null;
+  }
+}
+
+function scanDrawer(
+  root: string,
+  origin: string,
+  out: DiscoveredSkill[],
+  seen: Set<string>,
+  texts: Map<string, Set<string>>,
+): void {
+  if (pointsAtClaude(root, origin) || pointsAtClaude(dirname(root), origin)) return;
+  let entries;
+  try {
+    entries = readdirSync(root, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;
+    const name = entry.name;
+    if (!NAME.test(name) || name.length > 64) continue;
+    const location = join(root, name, "SKILL.md");
+    let real;
+    try {
+      real = realpathSync(location);
+    } catch {
+      continue;
+    }
+    if (seen.has(real)) continue;
+    const parsed = parseSkillFile(location, name);
+    if (parsed == null) continue;
+    const bag = texts.get(name) ?? new Set<string>();
+    if (bag.has(parsed.text)) continue;
+    seen.add(real);
+    bag.add(parsed.text);
+    texts.set(name, bag);
+    out.push({ name: parsed.name, description: parsed.description, location, invoke: parsed.name });
+  }
+}
+
+function qualify(rows: DiscoveredSkill[], reserved: ReadonlySet<string>): DiscoveredSkill[] {
+  const used = new Set<string>();
+  const seenName = new Set<string>();
+  const out: DiscoveredSkill[] = [];
+  for (const row of rows) {
+    const first = !seenName.has(row.name);
+    seenName.add(row.name);
+    const invoke =
+      first && !reserved.has(row.name)
+        ? row.name
+        : first
+          ? uniqueInvoke(`skill:${row.name}`, used)
+          : uniqueInvoke(qualifyInvoke(row), used);
+    used.add(invoke);
+    used.add(row.name);
+    out.push({ ...row, invoke });
+  }
+  out.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+  return out;
+}
+
+function qualifyInvoke(row: DiscoveredSkill): string {
+  const location = row.location.replaceAll("\\", "/");
+  if (location.includes("/.config/agents/skills/")) return `config:${row.name}`;
+  if (location.includes("/.config/opencode/skills/")) return `opencode:${row.name}`;
+  if (location.includes("/.pi/agent/skills/")) return `pi:${row.name}`;
+  if (location.includes("/.claude/skills/")) return `claude:${row.name}`;
+  if (location.includes("/.agents/skills/")) return `agents:${row.name}`;
+  if (location.includes("/.cursor/skills/")) return `cursor:${row.name}`;
+  if (location.includes("/.codex/skills/")) return `codex:${row.name}`;
+  if (location.includes("/.github/skills/")) return `github:${row.name}`;
+  if (location.includes("/.copilot/skills/")) return `copilot:${row.name}`;
+  if (location.includes("/.gemini/skills/")) return `gemini:${row.name}`;
+  if (location.includes("/.grok/skills/")) return `grok:${row.name}`;
+  if (location.includes("/.opencode/skills/")) return `opencode:${row.name}`;
+  if (location.includes("/.pi/skills/")) return `pi:${row.name}`;
+  return row.name;
+}
+
+function uniqueInvoke(base: string, used: Set<string>): string {
+  if (!used.has(base)) return base;
+  let i = 2;
+  for (;;) {
+    const next = `${base}-${i}`;
+    if (!used.has(next)) return next;
+    i += 1;
+  }
+}
+
+function skillSlash(
+  text: string,
+  skills: readonly { readonly name: string; readonly location: string; readonly invoke?: string }[],
+  reserved: ReadonlySet<string>,
+): { skill: { name: string; location: string }; rest: string } | null {
+  const first = (text.split("\n")[0] ?? "").trim();
+  const token = first.split(/\s/)[0] ?? "";
+  if (!token.startsWith("/") || token.length < 2) return null;
+  if (token.includes("/", 1) || token.includes("\\")) return null;
+  const verb = token.slice(1);
+  if (reserved.has(verb)) return null;
+  const prefixed = verb.startsWith("skill:") ? verb.slice("skill:".length) : null;
+  if (prefixed != null && !NAME.test(prefixed)) return null;
+  const skill =
+    prefixed != null
+      ? skills.find((row) => row.name === prefixed)
+      : (skills.find((row) => (row.invoke ?? row.name) === verb) ??
+        skills.find((row) => row.name === verb && !reserved.has(row.name)));
+  if (skill == null) return null;
+  const rest = text.slice(text.indexOf(verb) + verb.length).trim();
+  return { skill, rest };
+}
+
+function pointsAtClaude(path: string, projectPath: string): boolean {
+  try {
+    if (!lstatSync(path).isSymbolicLink()) return false;
+    const target = realpathSync(path);
+    const claude = join(projectPath, ".claude");
+    const claudeReal = existsSync(claude) ? realpathSync(claude) : resolve(claude);
+    return target === claudeReal || target.startsWith(claudeReal + sep);
+  } catch {
+    return false;
+  }
+}
+
+function parseSkillFile(location: string, dirName: string): { name: string; description: string; text: string } | null {
+  let source;
+  try {
+    source = readFileSync(location, "utf8");
+  } catch {
+    return null;
+  }
+  const parsed = parseSkillMarkdown(source, dirName);
+  if (parsed == null) return null;
+  return { name: parsed.name, description: parsed.description, text: parsed.text };
+}
+
+function parseSkillMarkdown(
+  source: string,
+  dirName: string,
+): { name: string; description: string; body: string; text: string } | null {
+  const text = source.replace(/^\uFEFF/, "").replaceAll("\r\n", "\n");
+  const match = /^---\n([\s\S]*?)\n---\n?/.exec(text);
+  if (match == null) return null;
+  const bag = frontmatterRecord(match[1]);
+  if (bag == null) return null;
+  const parsedName = typeof bag.name === "string" ? bag.name : "";
+  const name = parsedName === "" ? dirName : parsedName;
+  const description = typeof bag.description === "string" ? bag.description : "";
+  if (name !== dirName || !NAME.test(name) || name.length > 64) return null;
+  if (description === "" || description.length > DESCRIPTION_MAX) return null;
+  return { name, description, body: text.slice(match[0].length), text };
+}
+
+function frontmatterRecord(text: string): Record<string, unknown> | null {
+  let parsed: unknown;
+  try {
+    parsed = parseYaml(text) ?? {};
+  } catch {
+    return null;
+  }
+  if (parsed == null || typeof parsed !== "object" || Array.isArray(parsed)) return null;
+  const bag: Record<string, unknown> = {};
+  for (const [key, item] of Object.entries(parsed)) bag[key] = item;
+  return bag;
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-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.