@jean.gnc/harness-kit 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jean Gonçalves
+
+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/README.md

@@ -0,0 +1,190 @@
+# Harness Kit
+
+Typed framework for authoring Claude Code skills. A skill is a single `SKILL.md` file — frontmatter plus a Markdown body. The compiler validates references, expands placeholders, and emits the `SKILL.md` files Claude Code expects. A typed `SKILL.ts` form is also available when you want schema-checked metadata.
+
+## Requirements
+
+- Node ≥ 20
+- A package manager (pnpm, npm, yarn — pnpm is what this repo uses)
+- The `claude` and/or `codex` CLIs on `$PATH` — only needed to run `harness-kit install` / `uninstall`
+
+## Install
+
+```sh
+pnpm add @jean.gnc/harness-kit
+```
+
+## Authoring a skill
+
+Lay your sources out as a marketplace of plugins, each containing skills:
+
+```
+src/
+  .claude-plugin/
+    marketplace.json             # marketplace metadata, read by `install`
+  plugins/
+    <plugin>/
+      .claude-plugin/plugin.json # claude target manifest
+      .codex-plugin/plugin.json  # codex target manifest (optional)
+      skills/
+        <skill>/
+          SKILL.md
+          <companion>.md         # optional
+```
+
+Skills are auto-discovered by walking `<srcRoot>/plugins/<plugin>/skills/<name>/SKILL.md`. The `name` field in frontmatter must match the skill's folder name.
+
+```md
+<!-- SKILL.md -->
+---
+name: my-skill
+description: What the skill does — single line.
+companions:
+  - file: details.md
+    summary: Deeper notes.
+---
+
+# My Skill
+
+For type safety conventions, see {{skill:dev-tools:typescript}}.
+For TDD discipline, see {{ext:superpowers:test-driven-development}}.
+For details, see {{ref:details.md}}.
+
+{{companions}}
+```
+
+Compiles to:
+
+```md
+<!-- dist/plugins/<plugin>/skills/my-skill/SKILL.md -->
+---
+name: my-skill
+description: What the skill does — single line.
+companions:
+  - file: details.md
+    summary: Deeper notes.
+---
+
+# My Skill
+
+For type safety conventions, see `dev-tools:typescript`.
+For TDD discipline, see `superpowers:test-driven-development`.
+For details, see `details.md`.
+
+## Companion files (read on demand)
+
+- `details.md` — Deeper notes.
+```
+
+### Composing with includes
+
+Use `{{include:./fragment.md}}` to inline another Markdown file verbatim into the body. Includes expand recursively (an included file may itself contain `{{include:...}}`), and any other placeholders inside the inlined content are resolved against the **host skill**, not the include source.
+
+Constraints:
+
+- Path must be relative and stay inside the skill directory.
+- Target must end in `.md`.
+- Cycles are detected and fail the build.
+- Included files are not copied into `dist/` and are not flagged as undeclared companions.
+
+### Authoring with TypeScript (alternative)
+
+If you prefer typed metadata, use `SKILL.ts` + sibling `body.md` instead of a single `SKILL.md`:
+
+```ts
+// SKILL.ts
+import { defineSkill } from "@jean.gnc/harness-kit";
+
+export default defineSkill({
+  name: "my-skill",
+  description: "What the skill does — single line.",
+  companions: [{ file: "details.md", summary: "Deeper notes." }],
+});
+```
+
+```md
+<!-- body.md -->
+# My Skill
+
+For type safety conventions, see {{skill:dev-tools:typescript}}.
+```
+
+A skill folder must contain exactly one of `SKILL.md` or `SKILL.ts`. Both forms run through the same placeholder pipeline and produce identical `dist/` output.
+
+## Building
+
+The package ships a `harness-kit` CLI bin:
+
+```sh
+harness-kit build      # compile typed sources to dist/
+harness-kit lint       # lint compiled markdown under dist/ with default rules
+harness-kit check      # validate {{ext:...}} refs against installed plugins
+harness-kit install    # install dist/ plugins into Claude + Codex
+harness-kit uninstall  # remove them
+```
+
+In your `package.json`:
+
+```json
+{
+  "scripts": {
+    "build": "harness-kit build",
+    "lint": "harness-kit build && harness-kit lint",
+    "install:plugins": "harness-kit install",
+    "uninstall:plugins": "harness-kit uninstall"
+  },
+  "dependencies": {
+    "@jean.gnc/harness-kit": "latest"
+  }
+}
+```
+
+`build` defaults: `./src` → `./dist`. Override with `--src` and `--out`.
+
+`lint` defaults: `./dist`. Runs `markdownlint-cli2` against `plugins/**/*.md` with harness-kit's bundled rules — `MD013` (line length), `MD041` (first-line h1), and `MD033` (inline HTML) disabled; `MD024` scoped to `siblings_only`; `MD031` allows omitting blank lines around fences inside list items. Override with `--out`.
+
+`install` / `uninstall` defaults: reads `./dist`, targets both Claude and Codex. Filter with `--targets claude` or `--targets codex`. The marketplace name is read from `./dist/.claude-plugin/marketplace.json`, and the `claude` / `codex` CLIs must be on `$PATH`.
+
+For programmatic use:
+
+```ts
+import {
+  build,
+  lint,
+  install,
+  uninstall,
+  compile,
+  defineSkill,
+  parsePlaceholders,
+  substitute,
+  checkCompanionFiles,
+} from "@jean.gnc/harness-kit";
+
+await build({
+  srcRoot: "./src",
+  outRoot: "./dist",
+  bodyInvariants: [
+    /* (body) => string[] — extra checks to run on every skill body */
+  ],
+});
+
+await install({ targets: ["claude", "codex"] });
+```
+
+`bodyInvariants` are consumer-supplied predicates of type `(body: string) => string[]`. Each runs on every skill body (after `{{include:...}}` expansion, before placeholder substitution) during compile; any returned strings are reported as invariant violations and fail the build.
+
+## Placeholder reference
+
+Local skills are auto-discovered by walking `<srcRoot>/plugins/<plugin>/skills/<name>/`. Use `{{skill:...}}` for local references (build fails on typos) and `{{ext:...}}` for cross-plugin references (rendered as-is, no validation).
+
+| Placeholder | Renders to | Validation |
+| --- | --- | --- |
+| `{{skill:<plugin>:<name>}}` | `` `<plugin>:<name>` `` | Must be a discovered local skill |
+| `{{ext:<plugin>:<skill>}}` | `` `<plugin>:<skill>` `` | None — opaque external reference |
+| `{{ref:<relative-path>}}` | `` `<relative-path>` `` | Must be a file under the skill directory |
+| `{{include:<relative-path.md>}}` | Inlined content of the target file | Must be a `.md` file inside the skill, no cycles |
+| `{{companions}}` | Companion files section | Required iff companions are declared |
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md).

package/dist/agent/index.d.ts

@@ -0,0 +1,3 @@
+export { AgentSchema, defineAgent } from "./schema.js";
+export type { Agent } from "./schema.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC"}

package/dist/agent/index.js

@@ -0,0 +1,2 @@
+export { AgentSchema, defineAgent } from "./schema.js";
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/agent/schema.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export declare const AgentSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodEffects<z.ZodString, string, string>;
+    tools: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    model: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    tools?: string | string[] | undefined;
+    model?: string | undefined;
+}, {
+    name: string;
+    description: string;
+    tools?: string | string[] | undefined;
+    model?: string | undefined;
+}>;
+export type Agent = z.infer<typeof AgentSchema>;
+export declare function defineAgent(agent: Agent): Agent;
+//# sourceMappingURL=schema.d.ts.map

package/dist/agent/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/agent/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;EAcb,CAAC;AAEZ,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAE/C"}

package/dist/agent/schema.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export const AgentSchema = z
+    .object({
+    name: z
+        .string()
+        .min(1)
+        .regex(/^[a-z0-9-]+$/, "name must be lowercase kebab-case"),
+    description: z
+        .string()
+        .min(1)
+        .max(1024)
+        .refine((s) => !s.includes("\n"), "description cannot contain newlines"),
+    tools: z.union([z.string().min(1), z.array(z.string().min(1))]).optional(),
+    model: z.string().min(1).optional(),
+})
+    .strict();
+export function defineAgent(agent) {
+    return AgentSchema.parse(agent);
+}
+//# sourceMappingURL=schema.js.map

package/dist/agent/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/agent/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,KAAK,CAAC,cAAc,EAAE,mCAAmC,CAAC;IAC7D,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,qCAAqC,CAAC;IAC1E,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACpC,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,OAAO,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC"}

package/dist/build.d.ts

@@ -0,0 +1,9 @@
+import type { BodyInvariant } from "./compile/index.js";
+export interface BuildOptions {
+    readonly srcRoot?: string;
+    readonly outRoot?: string;
+    readonly bodyInvariants?: readonly BodyInvariant[];
+    readonly silent?: boolean;
+}
+export declare function build(options?: BuildOptions): Promise<void>;
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAarE"}

package/dist/build.js

@@ -0,0 +1,18 @@
+import { rm } from "node:fs/promises";
+import { resolve, join } from "node:path";
+import { compile } from "./compile/index.js";
+export async function build(options = {}) {
+    const srcRoot = resolve(options.srcRoot ?? "./src");
+    const outRoot = resolve(options.outRoot ?? "./dist");
+    await rm(join(outRoot, "plugins"), { recursive: true, force: true });
+    await rm(join(outRoot, ".claude-plugin"), { recursive: true, force: true });
+    await compile({
+        srcRoot,
+        outRoot,
+        ...(options.bodyInvariants ? { bodyInvariants: options.bodyInvariants } : {}),
+    });
+    if (!options.silent) {
+        console.log(`compiled → ${outRoot}`);
+    }
+}
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAU7C,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,UAAwB,EAAE;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC,CAAC;IACrD,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,MAAM,OAAO,CAAC;QACZ,OAAO;QACP,OAAO;QACP,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9E,CAAC,CAAC;IACH,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/check/index.d.ts

@@ -0,0 +1,27 @@
+import { type PluginSource } from "../installed.js";
+export type CheckMode = "local" | "installed" | "all";
+export interface CheckOptions {
+    readonly srcRoot: string;
+    readonly mode?: CheckMode;
+    readonly sources?: readonly PluginSource[];
+}
+export type ExtViolationKind = "malformed" | "unresolved";
+export interface ExtViolation {
+    readonly kind: ExtViolationKind;
+    readonly token: string;
+    readonly file: string;
+    readonly line: number;
+    readonly column: number;
+    readonly message: string;
+}
+export interface SourceSummary {
+    readonly source: string;
+    readonly skillCount: number;
+}
+export interface CheckResult {
+    readonly violations: readonly ExtViolation[];
+    readonly checkedFiles: number;
+    readonly indexedSources: readonly SourceSummary[];
+}
+export declare function check(options: CheckOptions): Promise<CheckResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/check/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/check/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AAKzB,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,KAAK,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAC5C;AAED,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,YAAY,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAC;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;CACnD;AASD,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAsCvE"}

package/dist/check/index.js

@@ -0,0 +1,160 @@
+import { readFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { pathExists } from "../fs.js";
+import { FQ_ID } from "../ids.js";
+import { offsetToLineCol, parsePlaceholders } from "../placeholders/index.js";
+import { findSkillFile, formatLoadSkillError, loadSkill } from "../skill/index.js";
+import { collectLocalIds, loadLayout, } from "../layout/index.js";
+import { defaultSources, discoverInstalled, indexInstalled, } from "../installed.js";
+import { installedKindConfigs, localKindConfigs } from "./kinds.js";
+import { closestMatch } from "./suggest.js";
+export async function check(options) {
+    const mode = options.mode ?? "installed";
+    const kinds = new Map();
+    let indexedSources = [];
+    let localAdapter = null;
+    if (mode === "installed" || mode === "all") {
+        const sources = options.sources ?? defaultSources();
+        const artifacts = await discoverInstalled(sources);
+        const index = indexInstalled(artifacts);
+        indexedSources = sources.map((s) => ({
+            source: s.name,
+            skillCount: artifacts.skills.filter((i) => i.source === s.name).length,
+        }));
+        for (const [prefix, cfg] of installedKindConfigs(index))
+            kinds.set(prefix, cfg);
+    }
+    if (mode === "local" || mode === "all") {
+        const loaded = await loadLayout(options.srcRoot);
+        if (!loaded.ok)
+            throw new Error(`failed to load layout: ${loaded.error.kind}`);
+        localAdapter = loaded.value;
+        const ids = await collectLocalIds(localAdapter);
+        for (const [prefix, cfg] of localKindConfigs(ids))
+            kinds.set(prefix, cfg);
+    }
+    const sources = await collectBodySources({
+        srcRoot: options.srcRoot,
+        mode,
+        adapter: localAdapter,
+    });
+    const violations = [];
+    for (const source of sources) {
+        for (const violation of validateBody(source, kinds)) {
+            violations.push(violation);
+        }
+    }
+    return { violations, checkedFiles: sources.length, indexedSources };
+}
+async function collectBodySources(opts) {
+    const seen = new Set();
+    const out = [];
+    const push = async (filePath, body, bodyOffset) => {
+        if (seen.has(filePath))
+            return;
+        seen.add(filePath);
+        const fileText = await readFile(filePath, "utf8");
+        out.push({ body, bodyOffset, fileText, filePath });
+    };
+    if (opts.mode === "installed" || opts.mode === "all") {
+        for await (const skillDir of findSkillDirs(opts.srcRoot)) {
+            const loaded = await loadSkill(skillDir);
+            if (!loaded.ok) {
+                throw new Error(`failed to load skill at ${skillDir}:\n  - ${formatLoadSkillError(loaded.error).join("\n  - ")}`);
+            }
+            await push(loaded.value.bodyFilePath, loaded.value.body, loaded.value.bodyOffset);
+        }
+    }
+    if ((opts.mode === "local" || opts.mode === "all") && opts.adapter) {
+        for (const plugin of opts.adapter.plugins) {
+            for (const file of await collectPluginBodies(plugin)) {
+                await push(file.filePath, file.body, file.bodyOffset);
+            }
+        }
+    }
+    return out;
+}
+async function collectPluginBodies(plugin) {
+    const out = [];
+    if (await pathExists(plugin.skillsDir)) {
+        for (const entry of await readdir(plugin.skillsDir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const skillDir = join(plugin.skillsDir, entry.name);
+            const found = await findSkillFile(skillDir);
+            if (!found.ok || !found.value)
+                continue;
+            const loaded = await loadSkill(skillDir);
+            if (!loaded.ok) {
+                throw new Error(`failed to load skill at ${skillDir}:\n  - ${formatLoadSkillError(loaded.error).join("\n  - ")}`);
+            }
+            out.push({
+                filePath: loaded.value.bodyFilePath,
+                body: loaded.value.body,
+                bodyOffset: loaded.value.bodyOffset,
+            });
+        }
+    }
+    for (const dir of [plugin.commandsDir, plugin.agentsDir]) {
+        if (!(await pathExists(dir)))
+            continue;
+        for (const entry of await readdir(dir, { withFileTypes: true })) {
+            if (!entry.isFile() || !entry.name.endsWith(".md"))
+                continue;
+            const filePath = join(dir, entry.name);
+            const body = await readFile(filePath, "utf8");
+            out.push({ filePath, body, bodyOffset: 0 });
+        }
+    }
+    return out;
+}
+function validateBody(source, kinds) {
+    const violations = [];
+    for (const token of parsePlaceholders(source.body)) {
+        const kind = kinds.get(token.prefix);
+        if (!kind)
+            continue;
+        const { line, column } = offsetToLineCol(source.fileText, source.bodyOffset + token.start);
+        const at = { token: token.raw, file: source.filePath, line, column };
+        if (token.value === null || !FQ_ID.test(token.value)) {
+            violations.push({ ...at, kind: "malformed", message: kind.malformedHint });
+            continue;
+        }
+        if (kind.haystack.has(token.value))
+            continue;
+        const suggestion = closestMatch(token.value, [...kind.haystack]);
+        violations.push({
+            ...at,
+            kind: "unresolved",
+            message: suggestion
+                ? `\`${token.value}\` ${kind.noun} ${kind.missingHint} (did you mean \`${suggestion}\`?)`
+                : `\`${token.value}\` ${kind.noun} ${kind.missingHint}`,
+        });
+    }
+    return violations;
+}
+async function* findSkillDirs(srcRoot) {
+    if (!(await pathExists(srcRoot)))
+        return;
+    for await (const dir of walkDirs(srcRoot)) {
+        const found = await findSkillFile(dir);
+        if (!found.ok || found.value)
+            yield dir;
+    }
+}
+async function* walkDirs(dir) {
+    yield dir;
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.isDirectory() && !entry.isSymbolicLink()) {
+            yield* walkDirs(join(dir, entry.name));
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/check/index.js.map

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

package/dist/check/kinds.d.ts

@@ -0,0 +1,11 @@
+import type { InstalledIndex } from "../installed.js";
+import type { LocalIds } from "../layout/index.js";
+export interface KindConfig {
+    readonly noun: string;
+    readonly missingHint: string;
+    readonly malformedHint: string;
+    readonly haystack: ReadonlySet<string>;
+}
+export declare function installedKindConfigs(index: InstalledIndex): ReadonlyMap<string, KindConfig>;
+export declare function localKindConfigs(ids: LocalIds): ReadonlyMap<string, KindConfig>;
+//# sourceMappingURL=kinds.d.ts.map

package/dist/check/kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../../src/check/kinds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACxC;AAKD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CA8B3F;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CA8B/E"}

package/dist/check/kinds.js

@@ -0,0 +1,65 @@
+const INSTALLED_MISSING = "not installed";
+const LOCAL_MISSING = "not found in this marketplace";
+export function installedKindConfigs(index) {
+    return new Map([
+        [
+            "ext",
+            {
+                noun: "skill",
+                missingHint: INSTALLED_MISSING,
+                malformedHint: "expected `{{ext:<plugin>:<skill>}}` in kebab-case",
+                haystack: new Set(index.skills.keys()),
+            },
+        ],
+        [
+            "ext-command",
+            {
+                noun: "command",
+                missingHint: INSTALLED_MISSING,
+                malformedHint: "expected `{{ext-command:<plugin>:<command>}}` in kebab-case",
+                haystack: new Set(index.commands.keys()),
+            },
+        ],
+        [
+            "ext-agent",
+            {
+                noun: "agent",
+                missingHint: INSTALLED_MISSING,
+                malformedHint: "expected `{{ext-agent:<plugin>:<agent>}}` in kebab-case",
+                haystack: new Set(index.agents.keys()),
+            },
+        ],
+    ]);
+}
+export function localKindConfigs(ids) {
+    return new Map([
+        [
+            "skill",
+            {
+                noun: "skill",
+                missingHint: LOCAL_MISSING,
+                malformedHint: "expected `{{skill:<plugin>:<skill>}}` in kebab-case",
+                haystack: ids.skills,
+            },
+        ],
+        [
+            "command",
+            {
+                noun: "command",
+                missingHint: LOCAL_MISSING,
+                malformedHint: "expected `{{command:<plugin>:<command>}}` in kebab-case",
+                haystack: ids.commands,
+            },
+        ],
+        [
+            "agent",
+            {
+                noun: "agent",
+                missingHint: LOCAL_MISSING,
+                malformedHint: "expected `{{agent:<plugin>:<agent>}}` in kebab-case",
+                haystack: ids.agents,
+            },
+        ],
+    ]);
+}
+//# sourceMappingURL=kinds.js.map

package/dist/check/kinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinds.js","sourceRoot":"","sources":["../../src/check/kinds.ts"],"names":[],"mappings":"AAUA,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAC1C,MAAM,aAAa,GAAG,+BAA+B,CAAC;AAEtD,MAAM,UAAU,oBAAoB,CAAC,KAAqB;IACxD,OAAO,IAAI,GAAG,CAAqB;QACjC;YACE,KAAK;YACL;gBACE,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,iBAAiB;gBAC9B,aAAa,EAAE,mDAAmD;gBAClE,QAAQ,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;aACvC;SACF;QACD;YACE,aAAa;YACb;gBACE,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,iBAAiB;gBAC9B,aAAa,EAAE,6DAA6D;gBAC5E,QAAQ,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;aACzC;SACF;QACD;YACE,WAAW;YACX;gBACE,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,iBAAiB;gBAC9B,aAAa,EAAE,yDAAyD;gBACxE,QAAQ,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;aACvC;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAa;IAC5C,OAAO,IAAI,GAAG,CAAqB;QACjC;YACE,OAAO;YACP;gBACE,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,aAAa;gBAC1B,aAAa,EAAE,qDAAqD;gBACpE,QAAQ,EAAE,GAAG,CAAC,MAAM;aACrB;SACF;QACD;YACE,SAAS;YACT;gBACE,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,aAAa;gBAC1B,aAAa,EAAE,yDAAyD;gBACxE,QAAQ,EAAE,GAAG,CAAC,QAAQ;aACvB;SACF;QACD;YACE,OAAO;YACP;gBACE,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,aAAa;gBAC1B,aAAa,EAAE,qDAAqD;gBACpE,QAAQ,EAAE,GAAG,CAAC,MAAM;aACrB;SACF;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/check/suggest.d.ts

@@ -0,0 +1,2 @@
+export declare function closestMatch(needle: string, haystack: readonly string[]): string | null;
+//# sourceMappingURL=suggest.d.ts.map

package/dist/check/suggest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../src/check/suggest.ts"],"names":[],"mappings":"AAGA,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAYvF"}

package/dist/check/suggest.js

@@ -0,0 +1,37 @@
+const SUGGESTION_DISTANCE_FLOOR = 2;
+const SUGGESTION_DISTANCE_DIVISOR = 3;
+export function closestMatch(needle, haystack) {
+    let best = null;
+    const threshold = Math.max(SUGGESTION_DISTANCE_FLOOR, Math.floor(needle.length / SUGGESTION_DISTANCE_DIVISOR));
+    for (const candidate of haystack) {
+        const distance = levenshtein(needle, candidate);
+        if (distance > threshold)
+            continue;
+        if (!best || distance < best.distance)
+            best = { value: candidate, distance };
+    }
+    return best?.value ?? null;
+}
+function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    let prev = Array.from({ length: b.length + 1 }, (_, j) => j);
+    let curr = new Array(b.length + 1).fill(0);
+    for (let i = 1; i <= a.length; i += 1) {
+        curr[0] = i;
+        for (let j = 1; j <= b.length; j += 1) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            const deletion = (curr[j - 1] ?? 0) + 1;
+            const insertion = (prev[j] ?? 0) + 1;
+            const substitution = (prev[j - 1] ?? 0) + cost;
+            curr[j] = Math.min(deletion, insertion, substitution);
+        }
+        [prev, curr] = [curr, prev];
+    }
+    return prev[b.length] ?? 0;
+}
+//# sourceMappingURL=suggest.js.map