@deftai/directive-core 0.92.0 → 0.93.0

package/dist/doctor/index.d.ts

@@ -7,6 +7,7 @@ export * from "./json.js";
 export * from "./main.js";
 export * from "./manifest.js";
 export * from "./npm-registry.js";
+export * from "./openclaw-l2-adapter.js";
 export * from "./openclaw-skills.js";
 export * from "./paths.js";
 export * from "./payload-staleness.js";

package/dist/doctor/index.js

@@ -7,6 +7,7 @@ export * from "./json.js";
 export * from "./main.js";
 export * from "./manifest.js";
 export * from "./npm-registry.js";
+export * from "./openclaw-l2-adapter.js";
 export * from "./openclaw-skills.js";
 export * from "./paths.js";
 export * from "./payload-staleness.js";

package/dist/doctor/main.js

@@ -22,6 +22,7 @@ import { formatAllowedFlagsHint, formatUnknownFlagsError, parseDoctorFlags } fro
 import { pythonJsonDump } from "./json.js";
 import { parseInstallRootFromAgentsMd } from "./manifest.js";
 import { runNpmRegistryMirrorCheck } from "./npm-registry.js";
+import { runOpenClawL2AdapterCheck } from "./openclaw-l2-adapter.js";
 import { runOpenClawSkillPinsCheck } from "./openclaw-skills.js";
 import { createPlainSink } from "./output.js";
 import { readTextSafe, resolveFrameworkRootForProject, resolvePath, resolveVersion, runningInsideDeftRepo, } from "./paths.js";
@@ -409,6 +410,17 @@ export function cmdDoctor(args, seams = {}) {
     if (!jsonMode) {
         sink.blank();
     }
+    sink.info("Checking OpenClaw L2 product-command skills...");
+    runOpenClawL2AdapterCheck(sink, addFinding, {
+        projectRoot,
+        fixMode,
+        jsonMode,
+        allAgents: flags.openclawAllAgents,
+        seams,
+    });
+    if (!jsonMode) {
+        sink.blank();
+    }
     sink.info("Checking xBRIEF project envelope version...");
     runXbriefEnvelopeVersionCheck(projectRoot, sink, addFinding, seams);
     let resolution = null;

package/dist/doctor/openclaw-l2-adapter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Doctor check + --fix wire for OpenClaw L2 product-command skills (#3064 D5).
+ *
+ * Primary operator recovery path when OpenClaw is detected. Deposits thin
+ * user-invocable router + 13 product skills into workspace skills roots.
+ * Fail-closed when OC signals are absent. Policy opt-out:
+ * `plan.policy.openClawProductCommands: false`.
+ */
+import { type OpenClawL2DepositResult } from "../slash/openclaw-deposit.js";
+import type { OutputSink } from "./output.js";
+import type { DoctorSeams, Finding } from "./types.js";
+/** Stable doctor check id for JSON findings. */
+export declare const OPENCLAW_L2_ADAPTER_CHECK = "openclaw-l2-product-commands";
+export interface RunOpenClawL2AdapterOptions {
+    readonly projectRoot: string;
+    readonly fixMode: boolean;
+    readonly jsonMode: boolean;
+    readonly allAgents: boolean;
+    readonly seams?: DoctorSeams;
+}
+/**
+ * Doctor check: OpenClaw L2 product-command skills present and current.
+ * No-ops when OpenClaw is not detected. Fix mode deposits managed skills.
+ */
+export declare function runOpenClawL2AdapterCheck(sink: OutputSink, addFinding: (finding: Finding) => void, options: RunOpenClawL2AdapterOptions): OpenClawL2DepositResult | null;
+//# sourceMappingURL=openclaw-l2-adapter.d.ts.map

package/dist/doctor/openclaw-l2-adapter.js

@@ -0,0 +1,199 @@
+/**
+ * Doctor check + --fix wire for OpenClaw L2 product-command skills (#3064 D5).
+ *
+ * Primary operator recovery path when OpenClaw is detected. Deposits thin
+ * user-invocable router + 13 product skills into workspace skills roots.
+ * Fail-closed when OC signals are absent. Policy opt-out:
+ * `plan.policy.openClawProductCommands: false`.
+ */
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { generateOpenClawSkillArtifacts, isManagedOpenClawL2Skill, listOpenClawManagedSkillSlugs, } from "../slash/openclaw-adapter.js";
+import { depositOpenClawL2ProductCommands, loadOpenClawProductCommandsPolicyFromProject, } from "../slash/openclaw-deposit.js";
+import { detectOpenClaw, listInScopeSkillsDirs } from "./openclaw-skills.js";
+/** Stable doctor check id for JSON findings. */
+export const OPENCLAW_L2_ADAPTER_CHECK = "openclaw-l2-product-commands";
+const DOC_OPENCLAW_HOST = "docs/openclaw-agent-host.md";
+const DOC_SLASH_MULTI = "docs/slash-multi-host.md";
+const REMEDIATION_FIX = "deft doctor --fix";
+function defaultIsDir(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function assessGaps(skillsDirs) {
+    const artifacts = generateOpenClawSkillArtifacts();
+    const missing = [];
+    const stale = [];
+    let present = 0;
+    for (const skillsDir of skillsDirs) {
+        for (const art of artifacts) {
+            const path = join(skillsDir, art.slug, "SKILL.md");
+            if (!existsSync(path)) {
+                missing.push(`${skillsDir}/${art.slug}`);
+                continue;
+            }
+            let raw;
+            try {
+                raw = readFileSync(path, "utf8");
+            }
+            catch {
+                missing.push(`${skillsDir}/${art.slug}`);
+                continue;
+            }
+            if (!isManagedOpenClawL2Skill(raw)) {
+                // Consumer customization — not a gap for doctor (preserve).
+                present += 1;
+                continue;
+            }
+            if (raw === art.skillMarkdown) {
+                present += 1;
+            }
+            else {
+                stale.push(`${skillsDir}/${art.slug}`);
+            }
+        }
+    }
+    return { missing, stale, present };
+}
+/**
+ * Doctor check: OpenClaw L2 product-command skills present and current.
+ * No-ops when OpenClaw is not detected. Fix mode deposits managed skills.
+ */
+export function runOpenClawL2AdapterCheck(sink, addFinding, options) {
+    const seams = options.seams ?? {};
+    const env = seams.openclawEnv ?? process.env;
+    const homeDirFn = seams.openclawHomeDir ?? (() => homedir());
+    const isDir = seams.isDir ?? defaultIsDir;
+    const home = homeDirFn();
+    const detect = detectOpenClaw(env, { homeDir: home, isDir });
+    if (!detect.detected) {
+        sink.info(`${OPENCLAW_L2_ADAPTER_CHECK}: skip -- OpenClaw not detected`);
+        addFinding({
+            severity: "skip",
+            message: "OpenClaw not detected",
+            check: OPENCLAW_L2_ADAPTER_CHECK,
+            status: "skip",
+            reason: "openclaw-not-detected",
+        });
+        return null;
+    }
+    const policy = loadOpenClawProductCommandsPolicyFromProject(options.projectRoot);
+    if (!policy) {
+        // Opt-out: under --fix, strip managed L2 skills so the adapter does not
+        // stay active after openClawProductCommands=false (#3064 Greptile P1).
+        let depositResult = null;
+        if (options.fixMode) {
+            depositResult = depositOpenClawL2ProductCommands({
+                projectRoot: options.projectRoot,
+                env,
+                homeDir: home,
+                allAgents: options.allAgents,
+                policy: false,
+                printf: (t) => {
+                    if (!options.jsonMode)
+                        sink.info(t.trimEnd());
+                },
+                isDir,
+            });
+            const message = `${OPENCLAW_L2_ADAPTER_CHECK}: opted out (plan.policy.openClawProductCommands=false); ` +
+                (depositResult.removedPaths.length > 0
+                    ? `removed ${depositResult.removedPaths.length} managed skill path(s)`
+                    : "no managed L2 skills to remove");
+            sink.success(message);
+            addFinding({
+                severity: "skip",
+                message,
+                check: OPENCLAW_L2_ADAPTER_CHECK,
+                status: "opted-out-fixed",
+                reason: "policy-false",
+                removed: depositResult.removedPaths,
+                detect_reasons: detect.reasons,
+            });
+            return depositResult;
+        }
+        sink.info(`${OPENCLAW_L2_ADAPTER_CHECK}: skip -- plan.policy.openClawProductCommands=false`);
+        addFinding({
+            severity: "skip",
+            message: "OpenClaw L2 product commands opted out via policy; run `deft doctor --fix` to remove managed skills",
+            check: OPENCLAW_L2_ADAPTER_CHECK,
+            status: "opted-out",
+            reason: "policy-false",
+        });
+        return null;
+    }
+    const skillsDirs = listInScopeSkillsDirs(detect.stateDir, options.allAgents, {
+        isDir,
+    });
+    const gaps = assessGaps(skillsDirs);
+    const expectedCount = listOpenClawManagedSkillSlugs().length * skillsDirs.length;
+    if (gaps.missing.length === 0 && gaps.stale.length === 0) {
+        const message = `${OPENCLAW_L2_ADAPTER_CHECK}: OpenClaw L2 product-command skills present ` +
+            `(router + 13) in ${options.allAgents ? "main + workspace-* seats" : "main workspace"}`;
+        sink.success(message);
+        addFinding({
+            severity: "skip",
+            message,
+            check: OPENCLAW_L2_ADAPTER_CHECK,
+            status: "present",
+            skills_dirs: skillsDirs,
+            expected: expectedCount,
+            present: gaps.present,
+            detect_reasons: detect.reasons,
+        });
+        return null;
+    }
+    let depositResult = null;
+    if (options.fixMode) {
+        depositResult = depositOpenClawL2ProductCommands({
+            projectRoot: options.projectRoot,
+            env,
+            homeDir: home,
+            allAgents: options.allAgents,
+            policy: true,
+            printf: (t) => {
+                if (!options.jsonMode)
+                    sink.info(t.trimEnd());
+            },
+            isDir,
+        });
+        const post = assessGaps(skillsDirs);
+        if (post.missing.length === 0 && post.stale.length === 0) {
+            const message = `${OPENCLAW_L2_ADAPTER_CHECK}: deposited OpenClaw L2 product-command skills; ` +
+                "restart the OpenClaw gateway or start a new session so available_skills refreshes";
+            sink.success(message);
+            addFinding({
+                severity: "skip",
+                message,
+                check: OPENCLAW_L2_ADAPTER_CHECK,
+                status: "fixed",
+                skills_dirs: skillsDirs,
+                written: depositResult.writtenPaths,
+                detect_reasons: detect.reasons,
+            });
+            return depositResult;
+        }
+    }
+    const message = `${OPENCLAW_L2_ADAPTER_CHECK}: OpenClaw L2 product-command skills incomplete ` +
+        `(missing: ${gaps.missing.length}, stale: ${gaps.stale.length}) under ${skillsDirs.join(", ")}. ` +
+        `Remediation: ${REMEDIATION_FIX}. See ${DOC_OPENCLAW_HOST}, ${DOC_SLASH_MULTI}.`;
+    sink.warn(message);
+    addFinding({
+        severity: "warning",
+        message,
+        check: OPENCLAW_L2_ADAPTER_CHECK,
+        status: "missing",
+        missing: gaps.missing,
+        stale: gaps.stale,
+        skills_dirs: skillsDirs,
+        suggestion: REMEDIATION_FIX,
+        docs: [DOC_OPENCLAW_HOST, DOC_SLASH_MULTI],
+        detect_reasons: detect.reasons,
+    });
+    return depositResult;
+}
+//# sourceMappingURL=openclaw-l2-adapter.js.map

package/dist/index.d.ts

@@ -50,6 +50,7 @@ export * as resolution from "./resolution/index.js";
 export * as scm from "./scm/index.js";
 export * as scope from "./scope/index.js";
 export * as session from "./session/index.js";
+export * as slash from "./slash/index.js";
 export * as slice from "./slice/index.js";
 export * as storyReady from "./story-ready/index.js";
 export * as swarm from "./swarm/index.js";
@@ -65,6 +66,7 @@ export * as vbriefValidation from "./vbrief-validation/index.js";
 export * as verifyEnv from "./verify-env/index.js";
 export * as verifySource from "./verify-source/index.js";
 export * as wipCap from "./wip-cap/index.js";
+export * as xbrief from "./xbrief/index.js";
 export * as xbriefMigrate from "./xbrief-migrate/index.js";
 export declare const CORE_PACKAGE: "@deftai/directive-core";
 /** Returns identifying metadata for the core engine package. */

package/dist/index.js

@@ -51,6 +51,7 @@ export * as resolution from "./resolution/index.js";
 export * as scm from "./scm/index.js";
 export * as scope from "./scope/index.js";
 export * as session from "./session/index.js";
+export * as slash from "./slash/index.js";
 export * as slice from "./slice/index.js";
 export * as storyReady from "./story-ready/index.js";
 export * as swarm from "./swarm/index.js";
@@ -66,6 +67,7 @@ export * as vbriefValidation from "./vbrief-validation/index.js";
 export * as verifyEnv from "./verify-env/index.js";
 export * as verifySource from "./verify-source/index.js";
 export * as wipCap from "./wip-cap/index.js";
+export * as xbrief from "./xbrief/index.js";
 export * as xbriefMigrate from "./xbrief-migrate/index.js";
 export const CORE_PACKAGE = "@deftai/directive-core";
 /** Returns identifying metadata for the core engine package. */

package/dist/init-deposit/hygiene.js

@@ -16,6 +16,9 @@ import { readdir, rm, stat } from "node:fs/promises";
 import { dirname, join, relative } from "node:path";
 import { gitPorcelain } from "../story-ready/git.js";
 import { CANONICAL_INSTALL_ROOT } from "./constants.js";
+import { CONSUMER_SKILL_DISCOVERY_INVENTORY } from "./skill-discovery-deposit.js";
+import { hostSkillRelativePath, listSkillDiscoveryHosts } from "./skill-discovery-hosts.js";
+import { slashCommandManagedExactPaths } from "./slash-deposit.js";
 export const CODEQL_CONFIG_REL = ".github/codeql/codeql-config.yml";
 export const CORE_GUARD_WORKFLOW_REL = ".github/workflows/deft-core-guard.yml";
 // The lifecycle dir names are identical across the legacy `vbrief/` tree and the
@@ -41,16 +44,35 @@ export const CONSUMER_GUARD_MUST_FIRE = [
     "xbrief/proposed/example-scope.xbrief.json",
     "vbrief/pending/example-scope.vbrief.json",
 ];
+/** Exact managed multi-host skill pointer paths only (#75 Greptile P1). */
+function multiHostSkillDiscoveryManagedMatchers() {
+    // Exact SKILL.md paths only so consumer-authored siblings under the same
+    // host skills tree stay app-owned (not staged / not guard-exempt).
+    const matchers = [];
+    for (const host of listSkillDiscoveryHosts()) {
+        for (const skill of CONSUMER_SKILL_DISCOVERY_INVENTORY) {
+            matchers.push({ exact: hostSkillRelativePath(host, skill.dir) });
+        }
+    }
+    return matchers;
+}
 /** Single source of truth for installer-managed paths (#1440 / #1576). */
 export function installerManagedMatchers() {
     return [
         { exact: "AGENTS.md" },
         { prefix: ".agents/" },
+        // Multi-host skill discovery thin pointers (#75 residual) — not slash commands (#55).
+        // Exact inventory paths only; never claim the whole host skills tree.
+        ...multiHostSkillDiscoveryManagedMatchers(),
         { prefix: ".githooks/" },
         { exact: ".claude/settings.json" },
         { exact: ".grok/hooks/deft.json" },
         { exact: ".cursor/hooks.json" },
         { exact: ".codex/hooks.json" },
+        // Multi-host slash product files only (#3054 / L8 prefer commit).
+        // Exact paths — not directory prefixes — so consumer custom commands under
+        // the same host dirs stay app-owned for staging + no-mixed-core-and-app.
+        ...slashCommandManagedExactPaths().map((exact) => ({ exact })),
         { exact: ".gitattributes" },
         { exact: ".gitignore" },
         // Installer-deposited Prettier gate exclusion (#2534); must be allowlisted or

package/dist/init-deposit/index.d.ts

@@ -6,5 +6,8 @@ export * from "./legacy-detect.js";
 export * from "./migrate.js";
 export * from "./refresh.js";
 export * from "./scaffold.js";
+export * from "./skill-discovery-deposit.js";
+export * from "./skill-discovery-hosts.js";
+export * from "./slash-deposit.js";
 export * from "./untrack-core.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/init-deposit/index.js

@@ -6,5 +6,8 @@ export * from "./legacy-detect.js";
 export * from "./migrate.js";
 export * from "./refresh.js";
 export * from "./scaffold.js";
+export * from "./skill-discovery-deposit.js";
+export * from "./skill-discovery-hosts.js";
+export * from "./slash-deposit.js";
 export * from "./untrack-core.js";
 //# sourceMappingURL=index.js.map

package/dist/init-deposit/init-deposit.js

@@ -14,6 +14,7 @@ import { prunePythonArtifactsFromDeposit } from "../deposit/python-free.js";
 import { resolveInstalledContentRoot } from "../deposit/resolve-content.js";
 import { readCorePackageVersion } from "../engine-version.js";
 import { renderProjectDefinition } from "../render/project-render.js";
+import { depositOpenClawL2ProductCommands } from "../slash/openclaw-deposit.js";
 import { removeStaleMigratedFrameworkNarrative } from "../xbrief-migrate/migrate-project.js";
 import { writeAgentHookDeposit } from "./agent-hooks.js";
 import { ensureInitGitignoreLines, reconstituteDepositFromContent } from "./gitignore.js";
@@ -22,6 +23,8 @@ import { buildLegacyRefusalJson, buildLegacyRefusalMessage, detectLegacyLayout,
 import { printMigrateNudgeIfNeeded } from "./migrate.js";
 import { ensurePrettierIgnoreLines } from "./prettierignore.js";
 import { CANONICAL_INSTALL_ROOT, depositNeutralization, ensureTaskfile, writeAgentsMd, writeAgentsSkills, writeConsumerGitHooks, writeConsumerVbrief, writeInstallManifest, } from "./scaffold.js";
+import { writeMultiHostSkillDiscovery } from "./skill-discovery-deposit.js";
+import { writeSlashCommandDeposit } from "./slash-deposit.js";
 import { syncBareVersionMarker } from "./xbrief-projections.js";
 export function parseInitArgv(canonicalArgv, userArgv = []) {
     const args = [...canonicalArgv, ...userArgv];
@@ -181,6 +184,7 @@ export async function runInitDeposit(args, io, seams = {}) {
     writeInstallManifest(projectDir, deftDir, manifestFields);
     writeAgentsMd(projectDir, deftDir, io);
     const skillsCreated = writeAgentsSkills(projectDir, io);
+    writeMultiHostSkillDiscovery(projectDir, io);
     await depositNeutralization(projectDir, io);
     await writeConsumerVbrief(projectDir, deftDir, io);
     seedMinimalProjectDefinition(projectDir, io);
@@ -191,6 +195,12 @@ export async function runInitDeposit(args, io, seams = {}) {
     removeStaleMigratedFrameworkNarrative(projectDir);
     writeConsumerGitHooks(projectDir, deftDir, io, seams.gitHooks);
     writeAgentHookDeposit(projectDir, io);
+    writeSlashCommandDeposit(projectDir, io);
+    // #3064: OpenClaw L2 product-command skills when OC signals present (fail-closed otherwise).
+    depositOpenClawL2ProductCommands({
+        projectRoot: projectDir,
+        printf: (t) => io.printf(t),
+    });
     let taskfileWired = false;
     if (args.nonInteractive) {
         taskfileWired = ensureTaskfile(projectDir, io);

package/dist/init-deposit/refresh.js

@@ -21,6 +21,7 @@ import { resolveLifecycleRoot } from "../layout/resolve.js";
 import { detectNoDeftDirective, NO_DEFT_DIRECTIVE_DISABLED_MESSAGE, NO_DEFT_DIRECTIVE_FLAG_NAME, NO_DEFT_DIRECTIVE_INCONSISTENT_MESSAGE, NO_DEFT_DIRECTIVE_INCONSISTENT_POLICY, } from "../policy/no-deft-directive.js";
 import { runOrgForceOnMigration } from "../policy/org-force-on-migration.js";
 import { checkLocalEngineIntegrity, classify, ENGINE_PACKAGE, plan, renderGlobalInstall, resolveEngine, } from "../resolution/index.js";
+import { depositOpenClawL2ProductCommands } from "../slash/openclaw-deposit.js";
 import { gitPorcelain } from "../story-ready/git.js";
 import { removeStaleMigratedFrameworkNarrative } from "../xbrief-migrate/migrate-project.js";
 import { writeAgentHookDeposit } from "./agent-hooks.js";
@@ -31,6 +32,8 @@ import { buildLegacyRefusalJson, buildLegacyRefusalMessage, detectLegacyLayout,
 import { printMigrateNudgeIfNeeded } from "./migrate.js";
 import { ensurePrettierIgnoreLines } from "./prettierignore.js";
 import { CANONICAL_INSTALL_ROOT, depositNeutralization, ensureTaskfile, writeAgentsMd, writeConsumerGitHooks, writeInstallManifest, } from "./scaffold.js";
+import { writeMultiHostSkillDiscovery } from "./skill-discovery-deposit.js";
+import { writeSlashCommandDeposit } from "./slash-deposit.js";
 import { syncBareVersionMarker, syncConsumerXbriefSchemas, syncExistingBareVersionMarker, } from "./xbrief-projections.js";
 function hasCanonicalXbriefLifecycle(projectDir) {
     try {
@@ -464,6 +467,14 @@ export async function runRefreshDeposit(args, io, seams = {}) {
     }
     const agentsMdUpdated = writeAgentsMd(projectDir, deftDir, io);
     writeAgentHookDeposit(projectDir, io);
+    // #75 residual: multi-host thin skill discovery (mirror `.agents/skills` inventory).
+    writeMultiHostSkillDiscovery(projectDir, io);
+    writeSlashCommandDeposit(projectDir, io);
+    // #3064: OpenClaw L2 product-command skills when OC signals present (fail-closed otherwise).
+    depositOpenClawL2ProductCommands({
+        projectRoot: projectDir,
+        printf: (t) => io.printf(t),
+    });
     // #2530: root `.githooks/` is a consumer derivative like #2595 marker/schemas —
     // repair on every refresh, including the already-current no-op path.
     writeConsumerGitHooks(projectDir, deftDir, io, seams.gitHooks);

package/dist/init-deposit/scaffold.js

@@ -15,6 +15,7 @@ import { agentsRefreshPlan } from "../platform/agents-md.js";
 import { MIGRATED_ARTIFACT_DIR } from "../xbrief-migrate/constants.js";
 import { CANONICAL_INSTALL_ROOT } from "./constants.js";
 import { assertInstallerAllowlistHonors1430, installerManagedGuardEre } from "./hygiene.js";
+import { writeAgentsSkillsFromInventory } from "./skill-discovery-deposit.js";
 import { syncConsumerXbriefSchemas } from "./xbrief-projections.js";
 export { CANONICAL_INSTALL_ROOT };
 export const CORE_GLOB = ".deft/core/**";
@@ -90,125 +91,6 @@ const DEFT_INCLUDE_CHILD_BLOCK = "  # Added by deft-install --yes (Epic-4)\n" +
     "  deft:\n" +
     "    taskfile: ./.deft/core/Taskfile.yml\n" +
     "    optional: true\n";
-const AGENTS_SKILLS = [
-    {
-        dir: "deft",
-        content: `---
-name: deft
-description: Apply deft framework standards for AI-assisted development. Use when starting projects, writing code, running tests, making commits, or when the user references deft, project standards, or coding guidelines.
----
-
-Read and follow: .deft/core/SKILL.md
-`,
-    },
-    {
-        dir: "deft-directive-setup",
-        content: `---
-name: deft-directive-setup
-description: >-
-  Set up a new project with Deft framework standards. Use when the user wants
-  to bootstrap user preferences, configure a project, or generate a project
-  specification. Walks through setup conversationally — no separate CLI needed.
----
-
-Read and follow: .deft/core/skills/deft-directive-setup/SKILL.md
-`,
-    },
-    {
-        dir: "deft-directive-build",
-        content: `---
-name: deft-directive-build
-description: >-
-  Build a project from scope vBRIEFs following Deft framework standards.
-  Use after deft-directive-setup has generated the project definition, or when
-  the user has scope vBRIEFs ready to implement. Handles scaffolding,
-  implementation, testing, and quality checks phase by phase.
----
-
-Read and follow: .deft/core/skills/deft-directive-build/SKILL.md
-`,
-    },
-    {
-        dir: "deft-directive-review-cycle",
-        content: `---
-name: deft-directive-review-cycle
-description: >-
-  Greptile bot reviewer response workflow. Use when running a review cycle
-  on a PR — to audit process prerequisites, fetch bot findings, fix all
-  issues in a single batch commit, and exit cleanly when no P0/P1 issues
-  remain. Enables cloud agents to run autonomous PR review cycles.
----
-
-Read and follow: .deft/core/skills/deft-directive-review-cycle/SKILL.md
-`,
-    },
-    {
-        dir: "deft-directive-refinement",
-        content: `---
-name: deft-directive-refinement
-description: >-
-  Structured refinement workflow. Compares open GitHub issues against
-  the roadmap, triages new issues one-at-a-time with human review, and updates
-  the roadmap with phase placement, analysis comments, and index entries.
----
-
-Read and follow: .deft/core/skills/deft-directive-refinement/SKILL.md
-`,
-    },
-    {
-        dir: "deft-directive-swarm",
-        content: `---
-name: deft-directive-swarm
-description: >-
-  Parallel local agent orchestration. Use when running multiple agents
-  on roadmap items simultaneously — to select non-overlapping tasks, set up
-  isolated worktrees, launch agents with proven prompts, monitor progress,
-  handle stalled review cycles, and close out PRs cleanly.
----
-
-Read and follow: .deft/core/skills/deft-directive-swarm/SKILL.md
-`,
-    },
-    {
-        dir: "deft-directive-interview",
-        content: `---
-name: deft-directive-interview
-description: >-
-  Deterministic structured Q&A interview skill. Use when a skill or workflow
-  needs to collect structured answers from the user — one question per turn,
-  numbered options, default acceptance, and a confirmation gate.
----
-
-Read and follow: .deft/core/skills/deft-directive-interview/SKILL.md
-`,
-    },
-    {
-        dir: "deft-directive-pre-pr",
-        content: `---
-name: deft-directive-pre-pr
-description: >-
-  Iterative pre-PR quality loop (Read-Write-Lint-Diff-Loop). Use before
-  pushing a branch for PR creation — structured self-review that agents run
-  to catch issues before they reach the bot reviewer.
----
-
-Read and follow: .deft/core/skills/deft-directive-pre-pr/SKILL.md
-`,
-    },
-    {
-        dir: "deft-directive-sync",
-        content: `---
-name: deft-directive-sync
-description: >-
-  Session-start framework sync skill. Use at the beginning of a session to
-  pull latest framework updates, validate project files, and confirm alignment
-  before starting work.
----
-
-Read and follow: .deft/core/skills/deft-directive-sync/SKILL.md
-`,
-    },
-];
 const BARE_SEMVER = /^\d+\.\d+\.\d+([-+][0-9A-Za-z.-]+)?$/;
 export function buildInstallManifestText(fields) {
     let effectiveTag = fields.tag;
@@ -376,20 +258,8 @@ export async function writeConsumerVbrief(projectDir, deftDir, io) {
     return true;
 }
 export function writeAgentsSkills(projectDir, io) {
-    projectionTarget(projectDir, ".agents");
-    const allExist = AGENTS_SKILLS.every((skill) => existsSync(join(projectDir, ".agents", "skills", skill.dir, "SKILL.md")));
-    if (allExist) {
-        io.printf(".agents/skills/ already present — skipping.\n");
-        return false;
-    }
-    for (const skill of AGENTS_SKILLS) {
-        const path = projectionTarget(projectDir, ".agents", "skills", skill.dir, "SKILL.md");
-        if (existsSync(path))
-            continue;
-        containedProjectWrite(projectDir, path, skill.content);
-    }
-    io.printf(".agents/skills/ created — deft skills will be auto-discovered.\n");
-    return true;
+    // Shared inventory with multi-host skill discovery (#75 residual).
+    return writeAgentsSkillsFromInventory(projectDir, io);
 }
 function hasTopLevelIncludes(content) {
     if (!content)

package/dist/init-deposit/skill-discovery-deposit.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Multi-host thin skill discovery deposit (#75 residual).
+ *
+ * Mirrors the consumer skill inventory already written to `.agents/skills/`
+ * into additional host paths (`.claude/skills/`, `.codex/skills/`,
+ * `.github/skills/`, `.cursor/skills/`). Thin pointers only — no full skill
+ * body copies. Windows-safe file writes (no elevated symlink requirement).
+ *
+ * Distinct from epic #55 slash-command deposit (#3054).
+ */
+import type { InitDepositIo } from "./constants.js";
+import { type HostSkillDiscoveryPolicy, type SkillDiscoveryHostId } from "./skill-discovery-hosts.js";
+export type { InitDepositIo };
+/**
+ * Consumer skill discovery inventory shared by `.agents/skills/` and multi-host
+ * deposit. Each entry is a thin SKILL.md pointer into `.deft/core/…` — never a
+ * full skill body. Keep this list the single SoT for install-time discovery.
+ */
+export declare const CONSUMER_SKILL_DISCOVERY_INVENTORY: ReadonlyArray<{
+    dir: string;
+    content: string;
+}>;
+/** Max bytes for a thin pointer body — fat full-skill copies fail this guard. */
+export declare const MAX_THIN_SKILL_POINTER_BYTES = 1200;
+/**
+ * True when content is a thin discovery pointer (not an inlined skill body).
+ * Managed deposit must stay pointer-shaped so updates do not rot full copies.
+ */
+export declare function isThinSkillPointer(content: string): boolean;
+export interface MultiHostSkillDiscoveryDepositResult {
+    readonly changed: boolean;
+    /** Repo-relative posix paths written or rewritten. */
+    readonly changedPaths: string[];
+    /** Hosts that received at least one write. */
+    readonly hostsTouched: SkillDiscoveryHostId[];
+    /** Hosts skipped because `plan.policy.hostSkillDiscovery.<host>` is false. */
+    readonly hostsSkipped: SkillDiscoveryHostId[];
+}
+export interface WriteMultiHostSkillDiscoveryOptions {
+    /** Override policy (tests); default loads from PROJECT-DEFINITION. */
+    policy?: HostSkillDiscoveryPolicy;
+    /**
+     * Skill inventory to deposit. Defaults to the shared consumer inventory
+     * (same set as `.agents/skills/`).
+     */
+    inventory?: ReadonlyArray<{
+        dir: string;
+        content: string;
+    }>;
+}
+/**
+ * Deposit thin skill discovery pointers into enabled multi-host paths.
+ * Idempotent: skips write when on-disk content already matches. Never creates
+ * symlinks (Windows-safe without elevation).
+ */
+export declare function writeMultiHostSkillDiscovery(projectDir: string, io: InitDepositIo, options?: WriteMultiHostSkillDiscoveryOptions): MultiHostSkillDiscoveryDepositResult;
+/**
+ * Shared inventory helper for `.agents/skills/` (canonical) deposit.
+ * Returns true when any pointer was created (matching writeAgentsSkills).
+ */
+export declare function writeAgentsSkillsFromInventory(projectDir: string, io: InitDepositIo, inventory?: ReadonlyArray<{
+    dir: string;
+    content: string;
+}>): boolean;
+//# sourceMappingURL=skill-discovery-deposit.d.ts.map