@owlmeans/agent-skills 0.1.15 → 0.1.16

package/build/llm/plugin.js

@@ -0,0 +1,115 @@
+import { PromptBlock, resolveFileProvider } from '@owlmeans/llm-common';
+import { renderSkill } from '@owlmeans/llm/prompt';
+import { loadPackageSkills } from './resolve.js';
+import { OWLMEANS_SCOPE } from './types.js';
+export const PACKAGE_SKILLS_PLUGIN = 'owlmeans-packages';
+const DEFAULT_MAX_PACKAGES = 5;
+const DEFAULT_CATEGORIES = ['package-specific', 'multi-package'];
+const escape = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+const textOf = (content) => {
+    if (typeof content === 'string') {
+        return content;
+    }
+    if (Array.isArray(content)) {
+        return content
+            .map(part => {
+            const text = part.text;
+            return typeof text === 'string' ? text : '';
+        })
+            .join('\n');
+    }
+    return '';
+};
+/**
+ * A prompt plugin that notices which `@owlmeans/*` packages a request talks about and
+ * loads their published skills into the system prompt.
+ *
+ * Everything the package documents is loaded — there is no relevance filtering, by
+ * design: choosing a subset would need a judgement the model is better placed to make
+ * than a regex, and a partial answer about an API is worse than none.
+ *
+ * The result lands in the `Packages` block, which sits behind its own cache breakpoint.
+ * That is the whole reason the block exists: what a request mentions changes call to
+ * call, and it must not shift a single byte of the role and skills every call shares.
+ */
+export const owlmeansPackagesPlugin = (options = {}) => {
+    const scopes = options.scopes ?? [OWLMEANS_SCOPE];
+    // No dots and no trailing hyphen, so `@owlmeans/llm.` yields `@owlmeans/llm` — prose
+    // and code both end package names with punctuation.
+    const pattern = new RegExp(`(?:${scopes.map(escape).join('|')})\\/[a-z0-9](?:[a-z0-9-]*[a-z0-9])?`, 'g');
+    const exclude = options.exclude ?? [];
+    const maxPackages = options.maxPackages ?? DEFAULT_MAX_PACKAGES;
+    const categories = options.categories ?? [...DEFAULT_CATEGORIES];
+    /**
+     * Resolved packages, negatives included. Without caching the misses, a prompt that
+     * mentions a package which does not publish skills would hit GitHub on every call.
+     */
+    const cache = new Map();
+    /**
+     * Per-provider caches, keyed by the provider INSTANCE.
+     *
+     * A host's file provider is usually per-project (a sandbox, a slot, one checkout), so
+     * two executions can resolve the same package name to different content. Sharing one
+     * cache across them would serve project A's skills to project B. A `WeakMap` keeps the
+     * entries alive exactly as long as the provider is.
+     */
+    const perProvider = new WeakMap();
+    const load = (packageName, ctx) => {
+        // The context's provider is the specific one — it sees the project this call is
+        // actually about. The constructor option is the fallback for a host that wires one
+        // globally. Without this, a per-execution provider was never consulted at all.
+        const provider = resolveFileProvider(ctx.files) ?? resolveFileProvider(options.files);
+        const store = provider != null
+            ? perProvider.get(provider) ?? (() => {
+                const fresh = new Map();
+                perProvider.set(provider, fresh);
+                return fresh;
+            })()
+            : cache;
+        const pending = store.get(packageName);
+        if (pending != null) {
+            return pending;
+        }
+        const promise = loadPackageSkills(packageName, { ...options, files: provider }, categories);
+        store.set(packageName, promise);
+        return promise;
+    };
+    const detect = (ctx) => {
+        const found = new Set();
+        for (const message of ctx.messages) {
+            const text = textOf(message.content);
+            if (text === '') {
+                continue;
+            }
+            for (const match of text.matchAll(pattern)) {
+                found.add(match[0]);
+            }
+        }
+        // Alphabetical, not first-seen: two prompts that mention the same packages in a
+        // different order must still produce the same bytes.
+        return [...found]
+            .filter(name => !exclude.includes(name))
+            .sort()
+            .slice(0, maxPackages);
+    };
+    return {
+        alias: PACKAGE_SKILLS_PLUGIN,
+        order: 50,
+        inspect: async (ctx) => {
+            const names = detect(ctx);
+            if (names.length === 0) {
+                return;
+            }
+            const resolved = await Promise.all(names.map(name => load(name, ctx)));
+            for (const found of resolved) {
+                if (found == null) {
+                    continue;
+                }
+                for (const skill of found.skills) {
+                    ctx.add(PromptBlock.Packages, renderSkill(skill));
+                }
+            }
+        },
+    };
+};
+//# sourceMappingURL=plugin.js.map

package/build/llm/plugin.js.map

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

package/build/llm/resolve.d.ts

@@ -0,0 +1,4 @@
+import type { PackageSkills, PackageSkillsOptions } from './types.js';
+/** Try each source in order of trustworthiness and cost. */
+export declare const loadPackageSkills: (packageName: string, options: PackageSkillsOptions, categories: readonly string[]) => Promise<PackageSkills | null>;
+//# sourceMappingURL=resolve.d.ts.map

package/build/llm/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/llm/resolve.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AA0JrE,4DAA4D;AAC5D,eAAO,MAAM,iBAAiB,GAC5B,aAAa,MAAM,EACnB,SAAS,oBAAoB,EAC7B,YAAY,SAAS,MAAM,EAAE,KAC5B,OAAO,CAAC,aAAa,GAAG,IAAI,CAe9B,CAAA"}

package/build/llm/resolve.js

@@ -0,0 +1,145 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve as resolvePath } from 'node:path';
+import { resolveFileProvider } from '@owlmeans/llm-common';
+import { parseManifest, skillEntries, stripMeta, toSkill, unscoped } from './manifest.js';
+const AGENT_META = 'agent-meta';
+const MANIFEST = 'manifest.json';
+const DEFAULT_REPO = 'owlmeans/common';
+const DEFAULT_REF = 'main';
+const DEFAULT_TIMEOUT = 5000;
+/** Path of an embedded file relative to a project root, in the host's own terms. */
+const projectPath = (packageName, ...parts) => ['node_modules', packageName, AGENT_META, ...parts].join('/');
+/**
+ * Source 1 — the host's own file access.
+ *
+ * Tried first because it is the only one that sees the project the model is actually
+ * working on: a sandbox, a remote workspace, a container this process cannot reach.
+ */
+const fromFiles = async (packageName, provider, categories) => {
+    const read = async (path) => {
+        try {
+            return await provider.readFile(path, true) ?? '';
+        }
+        catch {
+            return '';
+        }
+    };
+    const manifest = parseManifest(await read(projectPath(packageName, MANIFEST)));
+    if (manifest == null) {
+        return null;
+    }
+    const skills = [];
+    for (const entry of skillEntries(manifest, categories)) {
+        const body = stripMeta(await read(projectPath(packageName, entry.file)));
+        if (body !== '') {
+            skills.push(toSkill(packageName, entry, body));
+        }
+    }
+    return skills.length > 0
+        ? { packageName, version: manifest.version, source: 'files', skills }
+        : null;
+};
+/**
+ * Source 2 — an installed copy on this filesystem.
+ *
+ * Walks upward rather than assuming a layout: a hoisted install puts the package at the
+ * workspace root, a nested one puts it beside the consumer.
+ */
+const findLocalDir = (packageName, from) => {
+    let current = resolvePath(from);
+    for (;;) {
+        const candidate = join(current, 'node_modules', packageName, AGENT_META);
+        if (existsSync(join(candidate, MANIFEST))) {
+            return candidate;
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+};
+const fromLocal = (packageName, from, categories) => {
+    const dir = findLocalDir(packageName, from);
+    if (dir == null) {
+        return null;
+    }
+    const read = (path) => {
+        try {
+            return readFileSync(path, 'utf8');
+        }
+        catch {
+            return '';
+        }
+    };
+    const manifest = parseManifest(read(join(dir, MANIFEST)));
+    if (manifest == null) {
+        return null;
+    }
+    const skills = [];
+    for (const entry of skillEntries(manifest, categories)) {
+        const body = stripMeta(read(join(dir, ...entry.file.split('/'))));
+        if (body !== '') {
+            skills.push(toSkill(packageName, entry, body));
+        }
+    }
+    return skills.length > 0
+        ? { packageName, version: manifest.version, source: 'local', skills }
+        : null;
+};
+/**
+ * Source 3 — the canonical repository, for a package that is mentioned but not installed.
+ *
+ * It reads the EMBEDDED copies (`packages/<name>/agent-meta/`) rather than the canonical
+ * root ones: the embedded layout is uniform across packages and is exactly what the
+ * manifest describes, so one shape of URL works for every package.
+ */
+const fromRemote = async (packageName, options, categories) => {
+    if (options.fetch === false || typeof globalThis.fetch !== 'function') {
+        return null;
+    }
+    const repo = options.repo ?? DEFAULT_REPO;
+    const ref = options.ref ?? DEFAULT_REF;
+    const timeout = options.timeout ?? DEFAULT_TIMEOUT;
+    const url = (file) => `https://raw.githubusercontent.com/${repo}/${ref}/packages/${unscoped(packageName)}/${AGENT_META}/${file}`;
+    // Every failure here is a miss, never a throw: a prompt plugin that breaks the call
+    // because GitHub was slow is worse than a prompt without one package's knowledge.
+    const get = async (file) => {
+        try {
+            const response = await fetch(url(file), { signal: AbortSignal.timeout(timeout) });
+            return response.ok ? await response.text() : '';
+        }
+        catch {
+            return '';
+        }
+    };
+    const manifest = parseManifest(await get(MANIFEST));
+    if (manifest == null) {
+        return null;
+    }
+    const entries = skillEntries(manifest, categories);
+    const bodies = await Promise.all(entries.map(async (entry) => stripMeta(await get(entry.file))));
+    const skills = entries
+        .map((entry, i) => ({ entry, body: bodies[i] }))
+        .filter(({ body }) => body !== '')
+        .map(({ entry, body }) => toSkill(packageName, entry, body));
+    return skills.length > 0
+        ? { packageName, version: manifest.version, source: 'remote', skills }
+        : null;
+};
+/** Try each source in order of trustworthiness and cost. */
+export const loadPackageSkills = async (packageName, options, categories) => {
+    const provider = resolveFileProvider(options.files);
+    if (provider != null) {
+        const found = await fromFiles(packageName, provider, categories);
+        if (found != null) {
+            return found;
+        }
+    }
+    const local = fromLocal(packageName, options.dir ?? process.cwd(), categories);
+    if (local != null) {
+        return local;
+    }
+    return fromRemote(packageName, options, categories);
+};
+//# sourceMappingURL=resolve.js.map

package/build/llm/resolve.js.map

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

package/build/llm/types.d.ts

@@ -0,0 +1,59 @@
+import type { FileProviderRef, SkillDefinition } from '@owlmeans/llm-common';
+/** The default scope the plugin looks for in a prompt. */
+export declare const OWLMEANS_SCOPE = "@owlmeans";
+/** Where a package's skills came from — surfaced in logs, useful when a lookup surprises you. */
+export type SkillSource = 'files' | 'local' | 'remote';
+export interface PackageSkills {
+    packageName: string;
+    version: string;
+    source: SkillSource;
+    skills: SkillDefinition[];
+}
+export interface PackageSkillsOptions {
+    /**
+     * Host file access, tried FIRST. It reads the consuming project's own tree, so it is
+     * the only path that works when the project lives somewhere this process cannot reach
+     * directly — a sandbox, a remote workspace, a container.
+     */
+    files?: FileProviderRef;
+    /** Package scopes to detect. Defaults to `['@owlmeans']`. */
+    scopes?: string[];
+    /**
+     * Directory the local `node_modules` lookup starts from, walking upward.
+     * Defaults to `process.cwd()`.
+     */
+    dir?: string;
+    /** GitHub `owner/repo` holding the canonical packages. Defaults to `owlmeans/common`. */
+    repo?: string;
+    /**
+     * Git ref to read the embedded copies from. Defaults to `main`.
+     *
+     * The manifest deliberately carries no ref of its own — version-matching is guaranteed
+     * by shipping the copy inside the tarball, so there is nothing to pin against for a
+     * package that is NOT installed. Set this to a tag when reproducibility matters more
+     * than freshness.
+     */
+    ref?: string;
+    /** Set to `false` to skip the GitHub fallback entirely (air-gapped runs). */
+    fetch?: boolean;
+    /** Milliseconds before a remote lookup is abandoned. Defaults to 5000. */
+    timeout?: number;
+    /**
+     * Packages to ignore — typically the ones whose skills the static `Skills` block
+     * already carries, so they are not paid for twice.
+     */
+    exclude?: string[];
+    /**
+     * Ceiling on how many mentioned packages are loaded into one prompt. Defaults to 5.
+     * A prompt that name-drops a dozen packages is usually not asking about all of them,
+     * and every one of them costs context.
+     */
+    maxPackages?: number;
+    /**
+     * Manifest categories to include. Defaults to package knowledge only — `general`
+     * entries describe how an agent should behave, not what a package does, and belong in
+     * the host's own skill catalogue rather than in a package lookup.
+     */
+    categories?: Array<'package-specific' | 'multi-package' | 'general'>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/llm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE5E,0DAA0D;AAC1D,eAAO,MAAM,cAAc,cAAc,CAAA;AAEzC,iGAAiG;AACjG,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEtD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,WAAW,CAAA;IACnB,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,KAAK,CAAC,EAAE,eAAe,CAAA;IAEvB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IAEjB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ,yFAAyF;IACzF,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ,6EAA6E;IAC7E,KAAK,CAAC,EAAE,OAAO,CAAA;IAEf,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAElB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,kBAAkB,GAAG,eAAe,GAAG,SAAS,CAAC,CAAA;CACrE"}

package/build/llm/types.js

@@ -0,0 +1,3 @@
+/** The default scope the plugin looks for in a prompt. */
+export const OWLMEANS_SCOPE = '@owlmeans';
+//# sourceMappingURL=types.js.map

package/build/llm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAEA,0DAA0D;AAC1D,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAA"}

package/build/plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,eAAe,GACf,QAAQ,GACR,UAAU,CAAA;AAEd,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,eAAe,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,aAAa,CAAA;CACtB;AAED,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,gFAA2E,CAAA;AAS7G,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,eAAO,MAAM,WAAW,GACtB,SAAS,eAAe,EAAE,EAC1B,WAAW,MAAM,EACjB,OAAM,WAAgB,KACrB,WAAW,EAiCb,CAAA"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,eAAe,GACf,QAAQ,GACR,UAAU,CAAA;AAEd,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,eAAe,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,aAAa,CAAA;CACtB;AAED,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,gFAA2E,CAAA;AAW7G,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,eAAO,MAAM,WAAW,GACtB,SAAS,eAAe,EAAE,EAC1B,WAAW,MAAM,EACjB,OAAM,WAAgB,KACrB,WAAW,EAiCb,CAAA"}

package/build/plan.js

@@ -2,12 +2,13 @@ import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 /** The banner text injected by sync-agent-meta into every generated file. */
 export const AUTO_GENERATED_BANNER = '<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->';
-const targetPath = (targetDir, entry) => {
-    if (entry.kind === 'skill') {
-        return join(targetDir, '.claude', 'skills', entry.name, 'SKILL.md');
-    }
-    return join(targetDir, '.github', 'instructions', `${entry.name}.instructions.md`);
-};
+/**
+ * Skills install into `.agents/skills/<name>/SKILL.md` — the canonical store of the
+ * Agent Skills standard, discovered natively by Copilot and Codex. Claude Code reads
+ * them through the per-skill symlinks in `.claude/skills/` that {@link applyInstall}
+ * maintains.
+ */
+const targetPath = (targetDir, entry) => join(targetDir, '.agents', 'skills', entry.name, 'SKILL.md');
 export const planInstall = (entries, targetDir, opts = {}) => {
     return entries.map(entry => {
         const path = targetPath(targetDir, entry);

package/build/plan.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan.js","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAehC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,wEAAwE,CAAA;AAE7G,MAAM,UAAU,GAAG,CAAC,SAAiB,EAAE,KAAsB,EAAU,EAAE;IACvE,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IACrE,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC,IAAI,kBAAkB,CAAC,CAAA;AACpF,CAAC,CAAA;AAOD,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,OAA0B,EAC1B,SAAiB,EACjB,OAAoB,EAAE,EACP,EAAE;IACjB,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QACzB,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QAEzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;QACvD,CAAC;QAED,IAAI,QAAgB,CAAA;QACpB,IAAI,CAAC;YACH,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;QACvD,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;QAErD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,CAAA;QAC7D,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAA;QAC1D,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;QACtD,CAAC;QAED,oDAAoD;QACpD,OAAO;YACL,KAAK;YACL,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU;SAC3C,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA"}
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAehC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,wEAAwE,CAAA;AAE7G;;;;;GAKG;AACH,MAAM,UAAU,GAAG,CAAC,SAAiB,EAAE,KAAsB,EAAU,EAAE,CACvE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;AAO9D,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,OAA0B,EAC1B,SAAiB,EACjB,OAAoB,EAAE,EACP,EAAE;IACjB,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QACzB,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QAEzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;QACvD,CAAC;QAED,IAAI,QAAgB,CAAA;QACpB,IAAI,CAAC;YACH,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;QACvD,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;QAErD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,CAAA;QAC7D,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAA;QAC1D,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;QACtD,CAAC;QAED,oDAAoD;QACpD,OAAO;YACL,KAAK;YACL,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU;SAC3C,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/build/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA+CxC,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,GACX;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhC,eAAO,MAAM,GAAG,GAAU,MAAM,OAAO,KAAG,OAAO,CAAC,SAAS,CA+G1D,CAAA"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA2CxC,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,GACX;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhC,eAAO,MAAM,GAAG,GAAU,MAAM,OAAO,KAAG,OAAO,CAAC,SAAS,CAgH1D,CAAA"}

package/build/run.js

@@ -13,22 +13,18 @@ const ACTION_LABEL = {
 const padEnd = (s, n) => s + ' '.repeat(Math.max(0, n - s.length));
 const printTable = (items) => {
     const colWidths = {
-        kind: 11,
-        name: Math.max(...items.map(i => i.entry.name.length), 4) + 2,
+        name: Math.max(...items.map(i => i.entry.name.length), 5) + 2,
         pkg: Math.max(...items.map(i => i.entry.packageName.length), 7) + 2,
         action: 10,
     };
-    const header = padEnd('kind', colWidths.kind) +
-        padEnd('name', colWidths.name) +
+    const header = padEnd('skill', colWidths.name) +
         padEnd('package', colWidths.pkg) +
         'action';
     process.stdout.write(header + '\n');
     process.stdout.write('-'.repeat(header.length) + '\n');
     for (const item of items) {
-        const kindLabel = item.entry.kind === 'skill' ? 'skill' : 'instruction';
         const actionLabel = ACTION_LABEL[item.action];
-        process.stdout.write(padEnd(kindLabel, colWidths.kind) +
-            padEnd(item.entry.name, colWidths.name) +
+        process.stdout.write(padEnd(item.entry.name, colWidths.name) +
             padEnd(item.entry.packageName, colWidths.pkg) +
             actionLabel +
             '\n');
@@ -45,8 +41,8 @@ export const run = async (args) => {
             const more = linked.evidence.length > 5 ? ` (+${linked.evidence.length - 5} more)` : '';
             process.stderr.write(`\nerror: linked monorepo detected — ${pkgList}${more} are symlinked.\n\n` +
                 `In this setup, agents already load guidance from the linked monorepo's\n` +
-                `root .claude/skills/ and .github/instructions/. Installing embedded copies\n` +
-                `would place stale duplicates that conflict with the canonical live files.\n\n` +
+                `root AGENTS.md and .agents/skills/. Installing embedded copies would place\n` +
+                `stale duplicates that conflict with the canonical live files.\n\n` +
                 `Pass --force only if you understand this and want to proceed anyway.\n\n`);
             return { code: 4, message: 'linked monorepo' };
         }
@@ -55,8 +51,6 @@ export const run = async (args) => {
     const entries = discover(targetDir, {
         extras: args.extras,
         only: args.only.length > 0 ? args.only : undefined,
-        claudeOnly: args.claudeOnly,
-        copilotOnly: args.copilotOnly,
     });
     if (entries.length === 0) {
         process.stdout.write(`No embedded @owlmeans/* agent guidance found in node_modules.\n` +
@@ -116,9 +110,12 @@ export const run = async (args) => {
         }
     }
     // 7. Apply
-    const result = applyInstall(resolvedItems);
+    const result = applyInstall(resolvedItems, targetDir);
     process.stdout.write(`Done: ${result.installed} installed, ${result.updated} updated, ` +
         `${result.skipped} up-to-date, ${result.conflicts} skipped (conflicts).\n`);
+    if (result.linked > 0) {
+        process.stdout.write(`Linked ${result.linked} skill(s) into .claude/skills/ for Claude Code.\n`);
+    }
     return { code: 0 };
 };
 //# sourceMappingURL=run.js.map

package/build/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAG3D,MAAM,YAAY,GAAkC;IAClD,SAAS,EAAE,SAAS;IACpB,eAAe,EAAE,YAAY;IAC7B,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE,UAAU;CACvB,CAAA;AAED,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;AAE1F,MAAM,UAAU,GAAG,CAAC,KAAoB,EAAQ,EAAE;IAChD,MAAM,SAAS,GAAG;QAChB,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC;QAC7D,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC;QACnE,MAAM,EAAE,EAAE;KACX,CAAA;IAED,MAAM,MAAM,GACV,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC;QAC/B,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC;QAChC,QAAQ,CAAA;IACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAA;IAEtD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC;YAC7C,WAAW;YACX,IAAI,CACL,CAAA;IACH,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AAC5B,CAAC,CAAA;AASD,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,EAAE,IAAa,EAAsB,EAAE;IAC7D,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAEnC,2BAA2B;IAC3B,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,CAAA;QACtC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACtD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAA;YACvF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uCAAuC,OAAO,GAAG,IAAI,qBAAqB;gBAC1E,0EAA0E;gBAC1E,8EAA8E;gBAC9E,mEAAmE;gBACnE,0EAA0E,CAC3E,CAAA;YACD,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAA;QAChD,CAAC;IACH,CAAC;IAED,cAAc;IACd,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,EAAE;QAClC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;KACnD,CAAC,CAAA;IAEF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,iEAAiE;YACjE,oDAAoD,CACrD,CAAA;QACD,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,CAAA;IAC9C,CAAC;IAED,UAAU;IACV,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;IAEpE,iBAAiB;IACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC1B,UAAU,CAAC,KAAK,CAAC,CAAA;IAEjB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAA;QACtD,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;IACpB,CAAC;IAED,4BAA4B;IAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAA;IAClF,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAA;IAE5D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAA;QAChD,aAAa,EAAE,CAAA;QACf,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;IACpB,CAAC;IAED,wEAAwE;IACxE,MAAM,aAAa,GAAG,CAAC,GAAG,KAAK,CAAC,CAAA;IAEhC,IAAI,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,WAAW,OAAO,CAAC,MAAM,iBAAiB,SAAS,GAAG,CAAC,CAAA;QAChF,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;YAClC,aAAa,EAAE,CAAA;YACf,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;QACpB,CAAC;IACH,CAAC;IAED,2CAA2C;IAC3C,IAAI,KAAK,EAAE,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU;gBAAE,SAAQ;YACxC,MAAM,EAAE,GAAG,MAAM,OAAO,CACtB,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,gCAAgC,IAAI,CAAC,UAAU,GAAG,CACvE,CAAA;YACD,IAAI,EAAE,EAAE,CAAC;gBACP,oBAAoB;gBACpB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED,aAAa,EAAE,CAAA;IAEf,MAAM,kBAAkB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAA;IAC7E,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,cAAc,kBAAkB,CAAC,MAAM,8BAA8B,CACtE,CAAA;QACD,KAAK,MAAM,CAAC,IAAI,kBAAkB,EAAE,CAAC;YACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,UAAU,IAAI,CAAC,CAAA;QAC7C,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAA;QAEtD,iEAAiE;QACjE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACzC,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAA;QACrD,CAAC;IACH,CAAC;IAED,WAAW;IACX,MAAM,MAAM,GAAG,YAAY,CAAC,aAAa,EAAE,SAAS,CAAC,CAAA;IAErD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,SAAS,MAAM,CAAC,SAAS,eAAe,MAAM,CAAC,OAAO,YAAY;QAClE,GAAG,MAAM,CAAC,OAAO,gBAAgB,MAAM,CAAC,SAAS,yBAAyB,CAC3E,CAAA;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,MAAM,CAAC,MAAM,mDAAmD,CAAC,CAAA;IAClG,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;AACpB,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/agent-skills",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -22,15 +22,37 @@
       "default": "./build/index.js",
       "module": "./build/index.js",
       "types": "./build/index.d.ts"
+    },
+    "./llm": {
+      "import": "./build/llm/index.js",
+      "require": "./build/llm/index.js",
+      "default": "./build/llm/index.js",
+      "module": "./build/llm/index.js",
+      "types": "./build/llm/index.d.ts"
     }
   },
   "devDependencies": {
+    "@langchain/core": "^1.1.39",
     "@owlmeans/dep-config": "workspace:*",
+    "@owlmeans/llm": "^0.1.16",
+    "@owlmeans/llm-common": "^0.1.16",
     "@types/bun": "^1.3.14",
     "@types/node": "^26.1.0",
     "nodemon": "^3.1.14",
     "typescript": "^6.0.3"
   },
+  "peerDependencies": {
+    "@owlmeans/llm": "^0.1.16",
+    "@owlmeans/llm-common": "^0.1.16"
+  },
+  "peerDependenciesMeta": {
+    "@owlmeans/llm": {
+      "optional": true
+    },
+    "@owlmeans/llm-common": {
+      "optional": true
+    }
+  },
   "publishConfig": {
     "access": "public"
   }

package/src/apply.ts

@@ -1,5 +1,5 @@
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs'
-import { dirname } from 'node:path'
+import { existsSync, lstatSync, mkdirSync, readFileSync, rmSync, symlinkSync, writeFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
 import type { InstallItem } from './plan.js'
 
 export interface ApplyResult {
@@ -7,18 +7,50 @@ export interface ApplyResult {
   updated: number
   skipped: number
   conflicts: number
+  linked: number
+}
+
+/**
+ * Claude Code discovers skills only under `.claude/skills/`, so every installed skill
+ * gets a per-skill symlink into the canonical `.agents/skills/` store. Copilot and
+ * Codex read `.agents/skills/` directly and need nothing here.
+ *
+ * Only projects that already carry a `.claude/` directory are bridged — a
+ * Copilot/Codex-only project stays free of Claude Code scaffolding. Real files are
+ * never replaced, and failures (Windows without symlink rights) are non-fatal.
+ */
+const linkForClaude = (targetDir: string, names: string[]): number => {
+  if (!existsSync(join(targetDir, '.claude'))) return 0
+  const skillsDir = join(targetDir, '.claude', 'skills')
+  mkdirSync(skillsDir, { recursive: true })
+
+  let linked = 0
+  for (const name of names) {
+    const link = join(skillsDir, name)
+    try {
+      if (existsSync(link) || lstatSync(link, { throwIfNoEntry: false }) != null) {
+        if (!lstatSync(link).isSymbolicLink()) continue
+        rmSync(link)
+      }
+      symlinkSync(join('..', '..', '.agents', 'skills', name), link)
+      linked++
+    } catch { /* non-fatal: the repo's link-skills.sh can retry */ }
+  }
+  return linked
 }
 
 /**
  * Execute an install plan. Items with action 'conflict' or 'skip-uptodate'
  * are not written. Only 'install' and 'update' items are written.
  */
-export const applyInstall = (items: InstallItem[]): ApplyResult => {
-  const result: ApplyResult = { installed: 0, updated: 0, skipped: 0, conflicts: 0 }
+export const applyInstall = (items: InstallItem[], targetDir?: string): ApplyResult => {
+  const result: ApplyResult = { installed: 0, updated: 0, skipped: 0, conflicts: 0, linked: 0 }
+  const written: string[] = []
 
   for (const item of items) {
     if (item.action === 'skip-uptodate') {
       result.skipped++
+      written.push(item.entry.name)
       continue
     }
     if (item.action === 'conflict') {
@@ -29,10 +61,15 @@ export const applyInstall = (items: InstallItem[]): ApplyResult => {
     const content = readFileSync(item.entry.sourcePath, 'utf8')
     mkdirSync(dirname(item.targetPath), { recursive: true })
     writeFileSync(item.targetPath, content, 'utf8')
+    written.push(item.entry.name)
 
     if (item.action === 'install') result.installed++
     else result.updated++
   }
 
+  if (targetDir != null && written.length > 0) {
+    result.linked = linkForClaude(targetDir, written)
+  }
+
   return result
 }