@axm.sh/cli 0.0.1

package/dist/src/cli-commands/skills/fork/handler.js

@@ -0,0 +1,180 @@
+/**
+ * Fork command handler — Effect-based orchestration for `axm skills fork`.
+ *
+ * Converts an unmanaged skill into a managed extension:
+ * 1. Registry guard (ensure registry configured)
+ * 2. Parse source via resolveSource
+ * 3. Scope resolution
+ * 4. Discover skills via SourceProviders
+ * 5. Filter by --skill globs (if provided)
+ * 6. Build plan: fork → publish → install (sequential)
+ * 7. Execute via resolvePlan
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Path from "@effect/platform/Path";
+import { resolveSource, printSourceInput, SourceProviders, registryGuard, } from "../../../sources/index.js";
+import * as Array from "effect/Array";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { Log, Spinner } from "../../../tui/index.js";
+import { formatError } from "../../../utils/errors.js";
+import { Workspace as Workspace } from "../../../workspace/index.js";
+import { copySkill } from "../copy-skill.js";
+import { installSkill } from "../install/install-skill.js";
+import { publishSkill } from "../publish-skill.js";
+import { expandGlobs } from "../../../skills/index.js";
+// -----------------------------------------------------------------------------
+// Errors
+// -----------------------------------------------------------------------------
+export class ForkError extends Data.TaggedError("ForkError") {
+}
+// -----------------------------------------------------------------------------
+// Main Handler
+// -----------------------------------------------------------------------------
+/**
+ * Handles the `axm skills fork` command.
+ */
+export const handleFork = (args) => Effect.gen(function* () {
+    const ws = yield* Workspace;
+    const path = yield* Path.Path;
+    const log = yield* Log;
+    const spinnerSvc = yield* Spinner;
+    const sources = yield* SourceProviders;
+    const base = path.dirname(ws.path);
+    yield* log.info("axm skills fork");
+    // Step 1: Registry guard
+    yield* registryGuard;
+    // Step 2: Resolve scope
+    const scope = yield* ws.getConfiguredScope().pipe(Effect.mapError((e) => new ForkError({
+        message: `Failed to resolve scope: ${e._tag}`,
+        cause: e,
+    })));
+    // Step 3: Parse source and discover skills
+    const handle = yield* spinnerSvc.start("Resolving skills...");
+    const source = yield* resolveSource(args.source).pipe(Effect.mapError((error) => new ForkError({
+        message: formatError(`Invalid source: ${error.message}`, [`Provided: ${args.source}`], "Valid formats: installed skill name, local path, github:owner/repo"),
+        cause: error,
+    })), Effect.tapError(() => handle.stop("Failed")));
+    const allRefs = yield* sources
+        .resolveExtension(source, { names: [], agents: [], type: "skill" })
+        .pipe(Effect.mapError((error) => new ForkError({
+        message: formatError(`Failed to discover skills: ${error.message}`, [`Source: ${printSourceInput(source)}`], "Verify the source path contains directories with SKILL.md files."),
+        cause: error,
+    })), Effect.tapError(() => handle.stop("Failed")));
+    const discoveredSkills = Array.filter(allRefs, (ref) => ref.type === "skill");
+    if (discoveredSkills.length === 0) {
+        yield* handle.stop("No skills found");
+        return yield* new ForkError({
+            message: formatError("No skills found in source", [`Source: ${printSourceInput(source)}`], "Verify the source path contains directories with SKILL.md files."),
+            cause: undefined,
+        });
+    }
+    // Step 4: Filter by --skill globs (if provided)
+    const filtered = args.skills.length > 0
+        ? (() => {
+            const allNames = Array.map(discoveredSkills, (r) => r.skill.name);
+            const matched = expandGlobs(args.skills, allNames);
+            if (matched.length === 0) {
+                // Yield an error — cannot be done inside the IIFE, so return empty and check below
+                return [];
+            }
+            return Array.filter(discoveredSkills, (s) => matched.includes(s.skill.name));
+        })()
+        : discoveredSkills;
+    if (args.skills.length > 0 && filtered.length === 0) {
+        yield* handle.stop("No matches");
+        const allNames = Array.map(discoveredSkills, (r) => r.skill.name);
+        return yield* new ForkError({
+            message: formatError("No skills matched the given patterns", [`Patterns: ${args.skills.join(", ")}`, `Available: ${allNames.join(", ")}`], "Check skill names with `axm skills install --list <source>`."),
+            cause: undefined,
+        });
+    }
+    yield* handle.stop(`Found ${filtered.length} skill(s)`);
+    // Step 5: Get agents from workspace
+    const agentIds = yield* ws.getConfiguredAgents();
+    // Step 6: Determine first registry source name for publishing
+    const registrySources = yield* ws.getConfiguredRegistrySources(Option.none()).pipe(Effect.mapError((e) => new ForkError({
+        message: `Failed to get registry sources: ${e._tag}`,
+        cause: e,
+    })));
+    if (registrySources.length === 0) {
+        return yield* new ForkError({
+            message: "No registry sources configured. Run the registry guard first.",
+            cause: undefined,
+        });
+    }
+    const registryName = registrySources[0].name;
+    // Step 7: Build plan — fork + publish + install per skill (3 sequential ops)
+    const steps = Array.flatMap(filtered, (ref) => {
+        const targetName = `${scope}/${ref.skill.name}`;
+        const installArgs = {
+            source: { type: "registry", scope, name: ref.skill.name },
+            agents: [...agentIds],
+            force: true,
+            skill: {
+                name: ref.skill.name,
+                description: ref.skill.description,
+                metadata: ref.skill.metadata,
+            },
+            location: "file://" + path.join(base, ".axm/extensions", scope, "skills", ref.skill.name, "src"),
+            version: Option.some("0.1.0"),
+            gitTreeSha: Option.none(),
+        };
+        return [
+            {
+                _tag: "PlannedJobStep",
+                operation: {
+                    name: "copy-skill",
+                    args: {
+                        source: {
+                            type: "local",
+                            path: ref.location.replace("file://", ""),
+                        },
+                        targetName,
+                        location: ref.location,
+                    },
+                },
+                expectedResult: {
+                    result: "success",
+                    message: `Copied ${ref.skill.name} to ${targetName}`,
+                },
+                label: `Fork ${ref.skill.name}`,
+            },
+            {
+                _tag: "PlannedJobStep",
+                operation: {
+                    name: "publish-skill",
+                    args: {
+                        name: targetName,
+                        registryName,
+                    },
+                },
+                expectedResult: { result: "success", message: `Published ${targetName}` },
+                label: `Publish ${targetName}`,
+            },
+            {
+                _tag: "PlannedJobStep",
+                operation: {
+                    name: "install-skill",
+                    args: installArgs,
+                },
+                expectedResult: { result: "success", message: `Installed ${ref.skill.name}` },
+                label: `Install ${ref.skill.name}`,
+            },
+        ];
+    });
+    const plan = {
+        name: "Fork skill(s)",
+        description: Option.some(`Fork and publish ${filtered.length} skill(s)`),
+        jobs: [{ steps, concurrency: 1 }],
+    };
+    yield* ws.resolvePlan(plan, {
+        "copy-skill": copySkill,
+        "publish-skill": publishSkill,
+        "install-skill": installSkill,
+    });
+    yield* log.success("Done");
+});
+//# sourceMappingURL=handler.js.map

package/dist/src/cli-commands/skills/fork/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../../src/cli-commands/skills/fork/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,IAAI,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAOrE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAsBvD,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,MAAM,OAAO,SAAU,SAAQ,IAAI,CAAC,WAAW,CAAC,WAAW,CAGzD;CAAG;AAEL,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAqB,EAAE,EAAE,CAClD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC;IACvB,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC;IAClC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAEnC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAEnC,yBAAyB;IACzB,KAAK,CAAC,CAAC,aAAa,CAAC;IAErB,wBAAwB;IACxB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,IAAI,CAC/C,MAAM,CAAC,QAAQ,CACb,CAAC,CAAC,EAAE,EAAE,CACJ,IAAI,SAAS,CAAC;QACZ,OAAO,EAAE,4BAA4B,CAAC,CAAC,IAAI,EAAE;QAC7C,KAAK,EAAE,CAAC;KACT,CAAC,CACL,CACF,CAAC;IAEF,2CAA2C;IAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAE9D,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CACnD,MAAM,CAAC,QAAQ,CACb,CAAC,KAAK,EAAE,EAAE,CACR,IAAI,SAAS,CAAC;QACZ,OAAO,EAAE,WAAW,CAClB,mBAAmB,KAAK,CAAC,OAAO,EAAE,EAClC,CAAC,aAAa,IAAI,CAAC,MAAM,EAAE,CAAC,EAC5B,oEAAoE,CACrE;QACD,KAAK,EAAE,KAAK;KACb,CAAC,CACL,EACD,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAC7C,CAAC;IAEF,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,OAAO;SAC3B,gBAAgB,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;SAClE,IAAI,CACH,MAAM,CAAC,QAAQ,CACb,CAAC,KAAK,EAAE,EAAE,CACR,IAAI,SAAS,CAAC;QACZ,OAAO,EAAE,WAAW,CAClB,8BAA8B,KAAK,CAAC,OAAO,EAAE,EAC7C,CAAC,WAAW,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,EACvC,kEAAkE,CACnE;QACD,KAAK,EAAE,KAAK;KACb,CAAC,CACL,EACD,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAC7C,CAAC;IAEJ,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,EAAmB,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAC/F,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACtC,OAAO,KAAK,CAAC,CAAC,IAAI,SAAS,CAAC;YAC1B,OAAO,EAAE,WAAW,CAClB,2BAA2B,EAC3B,CAAC,WAAW,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,EACvC,kEAAkE,CACnE;YACD,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;IACL,CAAC;IAED,gDAAgD;IAChD,MAAM,QAAQ,GACZ,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACpB,CAAC,CAAC,CAAC,GAAG,EAAE;YACJ,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClE,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,mFAAmF;gBACnF,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,OAAO,KAAK,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/E,CAAC,CAAC,EAAE;QACN,CAAC,CAAC,gBAAgB,CAAC;IAEvB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC,CAAC,IAAI,SAAS,CAAC;YAC1B,OAAO,EAAE,WAAW,CAClB,sCAAsC,EACtC,CAAC,aAAa,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAC5E,8DAA8D,CAC/D;YACD,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,WAAW,CAAC,CAAC;IAExD,oCAAoC;IACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC;IAEjD,8DAA8D;IAC9D,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,4BAA4B,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAChF,MAAM,CAAC,QAAQ,CACb,CAAC,CAAC,EAAE,EAAE,CACJ,IAAI,SAAS,CAAC;QACZ,OAAO,EAAE,mCAAmC,CAAC,CAAC,IAAI,EAAE;QACpD,KAAK,EAAE,CAAC;KACT,CAAC,CACL,CACF,CAAC;IACF,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,CAAC,IAAI,SAAS,CAAC;YAC1B,OAAO,EAAE,+DAA+D;YACxE,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,YAAY,GAAG,eAAe,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC;IAE9C,6EAA6E;IAC7E,MAAM,KAAK,GAA0C,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;QACnF,MAAM,UAAU,GAAG,GAAG,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChD,MAAM,WAAW,GAA8B;YAC7C,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;YACzD,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC;YACrB,KAAK,EAAE,IAAI;YACX,KAAK,EAAE;gBACL,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI;gBACpB,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,WAAW;gBAClC,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ;aAC7B;YACD,QAAQ,EACN,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;YACxF,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YAC7B,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE;SAC1B,CAAC;QACF,OAAO;YACL;gBACE,IAAI,EAAE,gBAAyB;gBAC/B,SAAS,EAAE;oBACT,IAAI,EAAE,YAAY;oBAClB,IAAI,EAAE;wBACJ,MAAM,EAAE;4BACN,IAAI,EAAE,OAAO;4BACb,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;yBACK;wBAChD,UAAU;wBACV,QAAQ,EAAE,GAAG,CAAC,QAAQ;qBACvB;iBAC2B;gBAC9B,cAAc,EAAE;oBACd,MAAM,EAAE,SAAS;oBACjB,OAAO,EAAE,UAAU,GAAG,CAAC,KAAK,CAAC,IAAI,OAAO,UAAU,EAAE;iBACrD;gBACD,KAAK,EAAE,QAAQ,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;aAChC;YACD;gBACE,IAAI,EAAE,gBAAyB;gBAC/B,SAAS,EAAE;oBACT,IAAI,EAAE,eAAe;oBACrB,IAAI,EAAE;wBACJ,IAAI,EAAE,UAAU;wBAChB,YAAY;qBACb;iBAC8B;gBACjC,cAAc,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,UAAU,EAAE,EAAE;gBACzE,KAAK,EAAE,WAAW,UAAU,EAAE;aAC/B;YACD;gBACE,IAAI,EAAE,gBAAyB;gBAC/B,SAAS,EAAE;oBACT,IAAI,EAAE,eAAe;oBACrB,IAAI,EAAE,WAAW;iBACc;gBACjC,cAAc,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE;gBAC7E,KAAK,EAAE,WAAW,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;aACnC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,oBAAoB,QAAQ,CAAC,MAAM,WAAW,CAAC;QACxE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAU,EAAE,CAAC;KAC3C,CAAC;IAEF,KAAK,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE;QAC1B,YAAY,EAAE,SAAS;QACvB,eAAe,EAAE,YAAY;QAC7B,eAAe,EAAE,YAAY;KAC9B,CAAC,CAAC;IAEH,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC,CAAC,CAAC"}

package/dist/src/cli-commands/skills/index.d.ts

@@ -0,0 +1,3 @@
+export { copySkillDirectory } from "./copy-skill-directory.js";
+export { sourceToLockEntry } from "./source-to-lock-entry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/cli-commands/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli-commands/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/src/cli-commands/skills/index.js

@@ -0,0 +1,3 @@
+export { copySkillDirectory } from "./copy-skill-directory.js";
+export { sourceToLockEntry } from "./source-to-lock-entry.js";
+//# sourceMappingURL=index.js.map

package/dist/src/cli-commands/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cli-commands/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/src/cli-commands/skills/install/build-plan.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Skills-specific plan builder.
+ *
+ * Diffs AddSkillOperations against lockfile state to produce a Plan.
+ * New skills become expected-success steps; already-installed skills become expected-no-op steps.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Option from "effect/Option";
+import type { Lockfile } from "../../../lockfile/schema.js";
+import type { Plan } from "../../../workspace/plan.js";
+import type { InstallSkillOperation } from "../operations.js";
+/**
+ * Build a plan by comparing operations against the lockfile.
+ *
+ * Pure function — no Effect needed.
+ */
+export declare const buildPlan: (ops: ReadonlyArray<InstallSkillOperation>, lockfile: Lockfile, name: string, description: Option.Option<string>) => Plan<InstallSkillOperation>;
+//# sourceMappingURL=build-plan.d.ts.map

package/dist/src/cli-commands/skills/install/build-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-plan.d.ts","sourceRoot":"","sources":["../../../../../src/cli-commands/skills/install/build-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,SAAS,GACpB,KAAK,aAAa,CAAC,qBAAqB,CAAC,EACzC,UAAU,QAAQ,EAClB,MAAM,MAAM,EACZ,aAAa,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KACjC,IAAI,CAAC,qBAAqB,CA2B3B,CAAC"}

package/dist/src/cli-commands/skills/install/build-plan.js

@@ -0,0 +1,43 @@
+/**
+ * Skills-specific plan builder.
+ *
+ * Diffs AddSkillOperations against lockfile state to produce a Plan.
+ * New skills become expected-success steps; already-installed skills become expected-no-op steps.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Option from "effect/Option";
+/**
+ * Build a plan by comparing operations against the lockfile.
+ *
+ * Pure function — no Effect needed.
+ */
+export const buildPlan = (ops, lockfile, name, description) => ({
+    name,
+    description,
+    jobs: [
+        {
+            concurrency: 1,
+            steps: ops.map((op) => {
+                const installed = Object.hasOwn(lockfile.skills, op.args.skill.name);
+                return installed && !op.args.force
+                    ? {
+                        _tag: "PlannedJobStep",
+                        operation: op,
+                        expectedResult: { result: "no-op", message: "already installed" },
+                        label: op.args.skill.name,
+                    }
+                    : {
+                        _tag: "PlannedJobStep",
+                        operation: op,
+                        expectedResult: {
+                            result: "success",
+                            message: `Installed ${op.args.skill.name}`,
+                        },
+                        label: op.args.skill.name,
+                    };
+            }),
+        },
+    ],
+});
+//# sourceMappingURL=build-plan.js.map

package/dist/src/cli-commands/skills/install/build-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-plan.js","sourceRoot":"","sources":["../../../../../src/cli-commands/skills/install/build-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,GAAyC,EACzC,QAAkB,EAClB,IAAY,EACZ,WAAkC,EACL,EAAE,CAAC,CAAC;IACjC,IAAI;IACJ,WAAW;IACX,IAAI,EAAE;QACJ;YACE,WAAW,EAAE,CAAC;YACd,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;gBACpB,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACrE,OAAO,SAAS,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK;oBAChC,CAAC,CAAE;wBACC,IAAI,EAAE,gBAAgB;wBACtB,SAAS,EAAE,EAAE;wBACb,cAAc,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE;wBACjE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI;qBACuB;oBACpD,CAAC,CAAE;wBACC,IAAI,EAAE,gBAAgB;wBACtB,SAAS,EAAE,EAAE;wBACb,cAAc,EAAE;4BACd,MAAM,EAAE,SAAS;4BACjB,OAAO,EAAE,aAAa,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;yBAC3C;wBACD,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI;qBACuB,CAAC;YACzD,CAAC,CAAC;SACH;KACF;CACF,CAAC,CAAC"}

package/dist/src/cli-commands/skills/install/command.d.ts

@@ -0,0 +1,16 @@
+import type { CommandModule } from "yargs";
+interface InstallCommandArgs {
+    source: string;
+    global: boolean;
+    agent: ReadonlyArray<string>;
+    skill: ReadonlyArray<string>;
+    yes: boolean;
+    list: boolean;
+    all: boolean;
+    force: boolean;
+    preview: boolean;
+    "non-interactive": boolean | undefined;
+}
+export declare const installCommand: CommandModule<{}, InstallCommandArgs>;
+export {};
+//# sourceMappingURL=command.d.ts.map

package/dist/src/cli-commands/skills/install/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../../src/cli-commands/skills/install/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAK3C,UAAU,kBAAkB;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7B,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC;AAGD,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,EAAE,EAAE,kBAAkB,CAkGhE,CAAC"}

package/dist/src/cli-commands/skills/install/command.js

@@ -0,0 +1,91 @@
+import * as Option from "effect/Option";
+import { run } from "../../../runtime/index.js";
+import { handleInstall } from "./handler.js";
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type -- yargs convention
+export const installCommand = {
+    command: "install <source>",
+    describe: "Install skills from a GitHub repo, local path, or URL",
+    builder: (yargs) => yargs
+        .positional("source", {
+        type: "string",
+        describe: "GitHub shorthand (owner/repo), local path, or URL",
+        demandOption: true,
+    })
+        .option("global", {
+        type: "boolean",
+        describe: "Install to global ~/.axm/ instead of local .axm/",
+        default: false,
+    })
+        .option("agent", {
+        type: "string",
+        array: true,
+        describe: "Install only to specified agent(s)",
+        default: [],
+    })
+        .option("skill", {
+        type: "string",
+        array: true,
+        describe: "Install only specified skill(s) by name",
+        default: [],
+    })
+        .option("yes", {
+        alias: "y",
+        type: "boolean",
+        describe: "Skip all confirmation prompts",
+        default: false,
+    })
+        .option("list", {
+        alias: "l",
+        type: "boolean",
+        describe: "List available skills without installing",
+        default: false,
+    })
+        .option("all", {
+        type: "boolean",
+        describe: "Install all discovered skills",
+        default: false,
+    })
+        .option("force", {
+        alias: "f",
+        type: "boolean",
+        describe: "Overwrite existing skills",
+        default: false,
+    })
+        .option("preview", {
+        type: "boolean",
+        describe: "Display installation plan without applying",
+        default: false,
+    })
+        .option("non-interactive", {
+        type: "boolean",
+        describe: "Disable all interactive prompts",
+    })
+        .example("$0 skills install owner/repo", "Clone GitHub repo and install skills interactively")
+        .example("$0 skills install owner/repo@v1.0.0", "Install from a specific tag, branch, or commit")
+        .example("$0 skills install ./path/to/skills", "Install from a local directory")
+        .example("$0 skills install owner/repo --list", "List available skills without installing")
+        .example("$0 skills install owner/repo --all --yes", "Install all skills to all agents (CI mode)")
+        .example("$0 skills install owner/repo --skill pr-review --agent claude-code", "Install specific skill to specific agent"),
+    handler: async (argv) => {
+        await run(handleInstall({
+            source: argv.source,
+            global: argv.global,
+            agents: argv.agent,
+            skills: argv.skill,
+            yes: argv.yes,
+            list: argv.list,
+            all: argv.all,
+            force: argv.force,
+            nonInteractive: Option.fromNullable(argv["non-interactive"]),
+        }), {
+            workspace: {
+                global: argv.global,
+                yes: argv.yes,
+                nonInteractive: Option.fromNullable(argv["non-interactive"]),
+                preview: argv.preview,
+                agents: Option.none(),
+            },
+        });
+    },
+};
+//# sourceMappingURL=command.js.map

package/dist/src/cli-commands/skills/install/command.js.map

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

package/dist/src/cli-commands/skills/install/discover-skills.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Skill discovery algorithm (3-phase: direct match, priority scan, recursive fallback).
+ *
+ * The `discoverSkillsInDir` function is used by source providers (local, git-hosting)
+ * to discover skills within a directory structure.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Path from "@effect/platform/Path";
+import type { SourceInput } from "../../../sources/types.js";
+import type { SkillRef } from "../operations.js";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+/**
+ * Options controlling discovery behavior.
+ */
+export interface DiscoveryOptions {
+    /** Exhaustive recursive search even if root skill found */
+    readonly fullDepth: boolean;
+    /** Include skills with metadata.internal: true */
+    readonly includeInternal: boolean;
+}
+declare const DiscoveryError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "DiscoveryError";
+} & Readonly<A>;
+/**
+ * Error during skill discovery.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare class DiscoveryError extends DiscoveryError_base<{
+    readonly message: string;
+    readonly path: unknown;
+    readonly cause: unknown;
+    readonly retryable: boolean;
+}> {
+}
+/**
+ * Derive the full Phase 2 priority directory list.
+ *
+ * Composition:
+ * 1. `.` (searchPath root) — always first, highest priority
+ * 2. Non-agent static dirs: skills/.curated, skills/.experimental, skills/.system
+ * 3. Agent dirs: unique `skills.dir` values from the AgentDescriptor registry
+ */
+export declare const getPriorityDirectories: () => ReadonlyArray<string>;
+/**
+ * Discover skills in a directory using a 3-phase algorithm:
+ *
+ * Phase 1 — Direct match: check if search root itself contains SKILL.md
+ * Phase 2 — Priority directory scan: scan well-known directories one level deep
+ * Phase 3 — Recursive fallback: bounded DFS when prior phases find nothing or fullDepth is true
+ *
+ * Skills are deduplicated by name (first-found wins). Internal skills are
+ * filtered unless opted in.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const discoverSkillsInDir: (basePath: string, subPath: Option.Option<string>, options: DiscoveryOptions, source: SourceInput) => Effect.Effect<ReadonlyArray<SkillRef>, DiscoveryError, FileSystem.FileSystem | Path.Path>;
+export {};
+//# sourceMappingURL=discover-skills.d.ts.map

package/dist/src/cli-commands/skills/install/discover-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-skills.d.ts","sourceRoot":"","sources":["../../../../../src/cli-commands/skills/install/discover-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAI7D,OAAO,KAAK,EAAS,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGxD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAcxC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;;;;AAMD;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,oBAAmC;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B,CAAC;CAAG;AAoBL;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,QAAO,aAAa,CAAC,MAAM,CAG7D,CAAC;AAmIF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,MAAM,EAChB,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAC9B,SAAS,gBAAgB,EACzB,QAAQ,WAAW,KAClB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,cAAc,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CA6EvF,CAAC"}