@agentxm/client-core 0.1.6

package/dist/src/unstable/skills/operations/new-skill.d.ts

@@ -0,0 +1,42 @@
+/**
+ * New skill operation — scaffolds a new skill directory with manifest, SKILL.md,
+ * agent symlinks, and settings entry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import type { Handle } from "../../extensions/handle.js";
+import type { OperationHandler } from "../../workspace/apply-plan.js";
+import type { Operation } from "../../workspace/plan.js";
+import { Workspace } from "../../workspace/service-interface.js";
+/**
+ * Args for the new-skill operation.
+ */
+export interface NewSkillOperationArgs {
+    /** Skill name (validated, lowercase with hyphens). */
+    readonly name: string;
+    /** Profile (e.g., "@myorg"). */
+    readonly owner: Handle;
+    /** Agent IDs to create symlinks for. */
+    readonly agents: ReadonlyArray<string>;
+}
+/**
+ * Scaffold a new skill in the workspace.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type NewSkillOperation = Operation<"new-skill", NewSkillOperationArgs>;
+/**
+ * New-skill operation handler.
+ *
+ * 1. Compute paths via computeSkillPaths
+ * 2. Check if skill already exists in settings
+ * 3. Create skill directory (src/)
+ * 4. Write skill.json manifest
+ * 5. Write starter SKILL.md
+ * 6. Register in settings via ws.setSkillEntry
+ * 7. Create agent symlinks (concurrent)
+ */
+export declare const newSkill: OperationHandler<NewSkillOperation, FileSystem.FileSystem | Path.Path | Workspace>;
+//# sourceMappingURL=new-skill.d.ts.map

package/dist/src/unstable/skills/operations/new-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-skill.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/skills/operations/new-skill.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAMpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AASjE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;AAqB9E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,EAAE,gBAAgB,CACrC,iBAAiB,EACjB,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CAqH3C,CAAC"}

package/dist/src/unstable/skills/operations/new-skill.js

@@ -0,0 +1,125 @@
+/**
+ * New skill operation — scaffolds a new skill directory with manifest, SKILL.md,
+ * agent symlinks, and settings entry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { getAgentById } from "../../agents/index.js";
+import { makeAppError } from "../../app-error/index.js";
+import { decodeExtensionNameSync } from "../../extensions/index.js";
+import { createSymlink } from "../../utils/index.js";
+import { Workspace } from "../../workspace/service-interface.js";
+import { MANIFEST_FILENAME, MANIFEST_SCHEMA_URL } from "../manifest-schema.js";
+import { computeSkillPaths } from "../paths.js";
+import { decodeExactSemverVersionSync } from "../../version-constraints/version-constraints.js";
+// -----------------------------------------------------------------------------
+// Helpers
+// -----------------------------------------------------------------------------
+const makeSkillMd = (name) => `---
+name: ${name}
+description: A new skill
+---
+
+Describe what this skill does and when to use it.
+`;
+const INITIAL_SKILL_VERSION = decodeExactSemverVersionSync("0.0.1");
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * New-skill operation handler.
+ *
+ * 1. Compute paths via computeSkillPaths
+ * 2. Check if skill already exists in settings
+ * 3. Create skill directory (src/)
+ * 4. Write skill.json manifest
+ * 5. Write starter SKILL.md
+ * 6. Register in settings via ws.setSkillEntry
+ * 7. Create agent symlinks (concurrent)
+ */
+export const newSkill = (op) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const base = ws.baseDir;
+    const { name, owner, agents } = op.args;
+    const extensionName = decodeExtensionNameSync(name);
+    const fqn = `${owner}/skills/${name}`;
+    // 1. Check if skill already exists in settings
+    const configuredSkills = yield* ws.getConfiguredSkills();
+    if (name in configuredSkills) {
+        return yield* makeAppError({
+            code: "SKILL_ALREADY_EXISTS",
+            what: `Skill '${name}' already exists in settings`,
+            howToFix: "Choose a different name or remove the existing skill first",
+        });
+    }
+    // 2. Compute paths
+    const { canonicalPath, skillSrcPath } = computeSkillPaths(path.join, base, { refType: "registry", owner }, name);
+    // 3. Create skill directory (src/ implies canonicalPath is also created)
+    yield* fs.makeDirectory(skillSrcPath, { recursive: true }).pipe(Effect.mapError((e) => makeAppError({
+        code: "SKILL_CREATE_FAILED",
+        what: `Failed to create skill directory: ${skillSrcPath}`,
+        cause: e,
+    })));
+    // 4. Write manifest
+    const manifest = {
+        $schema: MANIFEST_SCHEMA_URL,
+        owner,
+        type: "skill",
+        name: decodeExtensionNameSync(name),
+        version: INITIAL_SKILL_VERSION,
+    };
+    yield* fs
+        .writeFileString(path.join(canonicalPath, MANIFEST_FILENAME), JSON.stringify(manifest, null, 2) + "\n")
+        .pipe(Effect.mapError((e) => makeAppError({
+        code: "SKILL_CREATE_FAILED",
+        what: `Failed to write skill manifest`,
+        cause: e,
+    })));
+    // 5. Write starter SKILL.md
+    yield* fs.writeFileString(path.join(skillSrcPath, "SKILL.md"), makeSkillMd(name)).pipe(Effect.mapError((e) => makeAppError({
+        code: "SKILL_CREATE_FAILED",
+        what: `Failed to write SKILL.md`,
+        cause: e,
+    })));
+    // 6. Register in settings
+    yield* ws.setSkillEntry(name, {
+        source: fqn,
+        enabled: true,
+    });
+    // 7. Create agent symlinks (concurrent)
+    yield* Effect.forEach(agents, (agentId) => Effect.gen(function* () {
+        const maybeAgent = getAgentById(agentId);
+        if (Option.isNone(maybeAgent))
+            return;
+        const agent = maybeAgent.value;
+        const link = path.join(base, agent.skills.dir, name);
+        yield* createSymlink({ target: skillSrcPath, link });
+    }), { concurrency: "unbounded" });
+    const now = new Date();
+    yield* ws.setSkillLock({
+        name,
+        versionConstraint: Option.none(),
+        lockEntry: {
+            type: "registry",
+            owner,
+            name: extensionName,
+            resolvedVersion: INITIAL_SKILL_VERSION,
+            integrity: "",
+            sourceName: "local",
+            agents,
+            installedAt: now,
+            updatedAt: now,
+        },
+    });
+    return {
+        result: "success",
+        message: `Created skill ${fqn}`,
+    };
+});
+//# sourceMappingURL=new-skill.js.map

package/dist/src/unstable/skills/operations/new-skill.js.map

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

package/dist/src/unstable/skills/operations/publish.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Publish skill executor — reads a managed extension's manifest, builds a zip
+ * archive, computes the SRI integrity hash, and publishes to a target registry.
+ *
+ * Pipeline: validate manifest → build archive → compute integrity →
+ * resolve registry provider → publish version (idempotent).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import type { OperationHandler } from "../../workspace/apply-plan.js";
+import type { Operation } from "../../workspace/plan.js";
+import { Workspace } from "../../workspace/service-interface.js";
+/**
+ * Args for the publish-skill operation.
+ *
+ * Reads the manifest from `.axm/extensions/`, builds a zip archive,
+ * computes the SRI integrity hash, and publishes to the target registry.
+ */
+export type PublishSkillOperationArgs = {
+    /** Extension identity in `@owner/name` format. */
+    readonly name: string;
+    /** Named source to publish to (e.g. "local"). */
+    readonly registryName: string;
+};
+/**
+ * Publish a managed extension to a registry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type PublishSkillOperation = Operation<"publish-skill", PublishSkillOperationArgs>;
+/**
+ * Publish-skill operation handler.
+ *
+ * 1. Read and validate `skill.json` manifest
+ * 2. Build zip archive of extension directory
+ * 3. Compute SRI integrity hash
+ * 4. Resolve target registry provider by source name
+ * 5. Publish version (idempotent: same integrity = no-op, different integrity = error)
+ */
+export declare const publishSkill: OperationHandler<PublishSkillOperation, FileSystem.FileSystem | Path.Path | Workspace>;
+//# sourceMappingURL=publish.d.ts.map

package/dist/src/unstable/skills/operations/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/skills/operations/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAUpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAMjE;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,SAAS,CAAC,eAAe,EAAE,yBAAyB,CAAC,CAAC;AAM1F;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,EAAE,gBAAgB,CACzC,qBAAqB,EACrB,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CAyI3C,CAAC"}

package/dist/src/unstable/skills/operations/publish.js

@@ -0,0 +1,135 @@
+/**
+ * Publish skill executor — reads a managed extension's manifest, builds a zip
+ * archive, computes the SRI integrity hash, and publishes to a target registry.
+ *
+ * Pipeline: validate manifest → build archive → compute integrity →
+ * resolve registry provider → publish version (idempotent).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import { REGISTRY_EXTENSIONS_DIR, parseFqn } from "../../extensions/index.js";
+import { SkillManifestSchema, MANIFEST_FILENAME } from "../manifest-schema.js";
+import { createRegistryClient } from "../../registry/index.js";
+import { buildZipArchive, computeIntegrity } from "../../utils/index.js";
+import { makeAppError } from "../../app-error/index.js";
+import { Workspace } from "../../workspace/service-interface.js";
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Publish-skill operation handler.
+ *
+ * 1. Read and validate `skill.json` manifest
+ * 2. Build zip archive of extension directory
+ * 3. Compute SRI integrity hash
+ * 4. Resolve target registry provider by source name
+ * 5. Publish version (idempotent: same integrity = no-op, different integrity = error)
+ */
+export const publishSkill = (op) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const base = ws.baseDir;
+    const fqn = yield* parseFqn(op.args.name);
+    // Locate the managed extension directory
+    const extensionDir = path.join(base, REGISTRY_EXTENSIONS_DIR, fqn.owner, "skills", fqn.name);
+    const extensionDirExists = yield* fs
+        .exists(extensionDir)
+        .pipe(Effect.orElseSucceed(() => false));
+    if (!extensionDirExists) {
+        return yield* makeAppError({
+            code: "PUBLISH_SKILL_NOT_FOUND",
+            what: `Managed extension not found: ${extensionDir}`,
+        });
+    }
+    // Read and validate manifest
+    const manifestPath = path.join(extensionDir, MANIFEST_FILENAME);
+    const manifestContent = yield* fs.readFileString(manifestPath).pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_SKILL_MANIFEST_READ_FAILED",
+        what: `Failed to read manifest: ${manifestPath}`,
+        cause: e,
+    })));
+    const manifestJson = yield* Effect.try({
+        try: () => {
+            const parsed = JSON.parse(manifestContent);
+            return parsed;
+        },
+        catch: (e) => makeAppError({
+            code: "PUBLISH_SKILL_MANIFEST_PARSE_FAILED",
+            what: `Invalid JSON in manifest: ${manifestPath}`,
+            cause: e,
+        }),
+    });
+    const manifest = yield* Schema.decodeUnknownEffect(SkillManifestSchema)(manifestJson).pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_SKILL_MANIFEST_SCHEMA_INVALID",
+        what: `Invalid manifest schema: ${manifestPath}`,
+        cause: e,
+    })));
+    // Build zip archive from extension directory (includes manifest + src/)
+    const archive = yield* buildZipArchive(extensionDir, "PUBLISH_SKILL_ARCHIVE_FAILED");
+    // Compute integrity
+    const integrity = yield* computeIntegrity(archive);
+    // Resolve target registry source
+    const registrySource = yield* ws.getConfiguredSourceByName(op.args.registryName).pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_SKILL_REGISTRY_LOOKUP_FAILED",
+        what: `Failed to lookup registry source "${op.args.registryName}"`,
+        cause: e,
+    })));
+    if (Option.isNone(registrySource)) {
+        return yield* makeAppError({
+            code: "PUBLISH_SKILL_REGISTRY_NOT_FOUND",
+            what: `Registry source "${op.args.registryName}" not found or not a registry source`,
+        });
+    }
+    const source = registrySource.value;
+    if (source.type !== "registry") {
+        return yield* makeAppError({
+            code: "PUBLISH_SKILL_REGISTRY_NOT_FOUND",
+            what: `Registry source "${op.args.registryName}" not found or not a registry source`,
+        });
+    }
+    const registryUrl = source.location.href;
+    const client = yield* createRegistryClient(registryUrl);
+    // Build version entry metadata
+    const versionEntry = {
+        version: manifest.version,
+        published: new Date().toISOString(),
+        integrity,
+        ...(manifest.compatiblePackages !== undefined && {
+            compatiblePackages: manifest.compatiblePackages,
+        }),
+    };
+    // Publish to registry (idempotent)
+    yield* client
+        .publishExtension({
+        owner: fqn.owner,
+        type: "skill",
+        name: fqn.name,
+        version: manifest.version,
+        archive,
+        metadata: versionEntry,
+    })
+        .pipe(Effect.mapError((e) => makeAppError({
+        code: "PUBLISH_SKILL_PUBLISH_FAILED",
+        what: `Failed to publish to registry "${op.args.registryName}"`,
+        details: [
+            `Registry source: ${op.args.registryName}`,
+            `Registry URL: ${registryUrl}`,
+            `Extension: ${op.args.name}@${manifest.version}`,
+            `Registry error: ${e.what} (${e.code})`,
+            ...e.details,
+        ],
+        ...(Option.isSome(e.howToFix) && { howToFix: e.howToFix.value }),
+        cause: e,
+    })));
+    return {
+        result: "success",
+        message: `Published ${op.args.name}@${manifest.version}`,
+    };
+});
+//# sourceMappingURL=publish.js.map

package/dist/src/unstable/skills/operations/publish.js.map

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

package/dist/src/unstable/skills/operations/rename.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Rename skill executor — renames files and updates settings/lockfile keys.
+ *
+ * Pipeline: read state → rename canonical dir → remove old symlinks →
+ * create new symlinks → rename settings/lockfile keys → sync lock agents.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import type { OperationHandler } from "../../workspace/apply-plan.js";
+import type { Operation } from "../../workspace/plan.js";
+import { Workspace } from "../../workspace/service-interface.js";
+/**
+ * Rename a skill (rename files and update settings/lockfile keys).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type RenameSkillOperation = Operation<"rename-skill", {
+    readonly oldName: string;
+    readonly newName: string;
+}>;
+/**
+ * Rename-skill operation handler.
+ *
+ * 1. Read configured agents, lock entry, settings entry (all by old name)
+ * 2. Rename canonical directory (old -> new)
+ * 3. Remove old agent symlinks
+ * 4. Create new agent symlinks
+ * 5. Rename settings/lockfile keys
+ * 6. Sync lock agents
+ */
+export declare const renameSkill: OperationHandler<RenameSkillOperation, FileSystem.FileSystem | Path.Path | Workspace>;
+//# sourceMappingURL=rename.d.ts.map

package/dist/src/unstable/skills/operations/rename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/skills/operations/rename.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAQpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAOjE;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,CAC1C,cAAc,EACd;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CACvD,CAAC;AAMF;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,EAAE,gBAAgB,CACxC,oBAAoB,EACpB,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CAgH3C,CAAC"}

package/dist/src/unstable/skills/operations/rename.js

@@ -0,0 +1,117 @@
+/**
+ * Rename skill executor — renames files and updates settings/lockfile keys.
+ *
+ * Pipeline: read state → rename canonical dir → remove old symlinks →
+ * create new symlinks → rename settings/lockfile keys → sync lock agents.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import matter from "gray-matter";
+import { getAgentById } from "../../agents/index.js";
+import { makeAppError } from "../../app-error/index.js";
+import { createSymlink } from "../../utils/index.js";
+import { copyExtensionDirectory, sanitizeName } from "../../extensions/utils.js";
+import { Workspace } from "../../workspace/service-interface.js";
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Rename-skill operation handler.
+ *
+ * 1. Read configured agents, lock entry, settings entry (all by old name)
+ * 2. Rename canonical directory (old -> new)
+ * 3. Remove old agent symlinks
+ * 4. Create new agent symlinks
+ * 5. Rename settings/lockfile keys
+ * 6. Sync lock agents
+ */
+export const renameSkill = (op) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const base = ws.baseDir;
+    // 1. Read workspace state
+    const configuredAgents = yield* ws.getConfiguredAgents();
+    const lockEntryOption = yield* ws.getLockedSkill(op.args.oldName).pipe(Effect.mapError((e) => makeAppError({
+        code: "RENAME_SKILL_LOCKFILE_READ_FAILED",
+        what: `Failed to read lockfile: ${e.what}`,
+        cause: e,
+    })));
+    if (Option.isNone(lockEntryOption)) {
+        return yield* makeAppError({
+            code: "RENAME_SKILL_NOT_FOUND",
+            what: `Lock entry for "${op.args.oldName}" not found in lockfile`,
+        });
+    }
+    const lockEntry = lockEntryOption.value;
+    const lockAgents = lockEntry.agents;
+    // 2. Compute paths for old and new names via centralized getSkillDir
+    // Derive source from lock entry — new name doesn't exist in lockfile yet
+    const pathSource = lockEntry.type === "registry"
+        ? { refType: "registry", owner: lockEntry.owner }
+        : lockEntry.type === "local"
+            ? { refType: "local" }
+            : { refType: "git-hosted" };
+    const oldPaths = yield* ws.getSkillDir(op.args.oldName, pathSource);
+    // Registry directories are tied to the immutable registry name — no rename needed
+    const isRegistry = lockEntry.type === "registry";
+    const newPaths = isRegistry ? oldPaths : yield* ws.getSkillDir(op.args.newName, pathSource);
+    if (!isRegistry) {
+        // Rename canonical directory — files before state
+        yield* fs.rename(oldPaths.canonicalPath, newPaths.canonicalPath).pipe(Effect.mapError((e) => makeAppError({
+            code: "RENAME_SKILL_DIR_FAILED",
+            what: `Failed to rename skill directory from "${op.args.oldName}" to "${op.args.newName}"`,
+            cause: e,
+        })));
+    }
+    // 2b. Update SKILL.md frontmatter name — best-effort
+    yield* updateSkillMdName(fs, path.join(newPaths.skillSrcPath, "SKILL.md"), op.args.newName).pipe(Effect.catch(() => Effect.void));
+    // 3. Remove old agent symlinks (concurrent)
+    const oldSanitized = sanitizeName(op.args.oldName);
+    const newSanitized = sanitizeName(op.args.newName);
+    const allAgents = [...new Set([...lockAgents, ...configuredAgents])];
+    yield* Effect.forEach(allAgents, (agentId) => {
+        const maybeAgent = getAgentById(agentId);
+        if (Option.isNone(maybeAgent))
+            return Effect.void;
+        const agent = maybeAgent.value;
+        const agentSkillPath = path.join(base, agent.skills.dir, oldSanitized);
+        return fs.remove(agentSkillPath, { recursive: true }).pipe(Effect.catch(() => Effect.void));
+    }, { concurrency: "unbounded" });
+    // 4. Create new agent symlinks (concurrent)
+    yield* Effect.forEach(configuredAgents, (agentId) => {
+        const maybeAgent = getAgentById(agentId);
+        if (Option.isNone(maybeAgent))
+            return Effect.void;
+        const agent = maybeAgent.value;
+        const agentSkillPath = path.join(base, agent.skills.dir, newSanitized);
+        return createSymlink({ target: newPaths.skillSrcPath, link: agentSkillPath }).pipe(Effect.catch(() => copyExtensionDirectory(newPaths.skillSrcPath, agentSkillPath).pipe(Effect.catch(() => Effect.void))));
+    }, { concurrency: "unbounded" });
+    // 5. Rename settings/lockfile keys — state after files
+    yield* ws.renameSkill(op.args.oldName, op.args.newName).pipe(Effect.catch(() => Effect.void));
+    // 6. Sync lock agents
+    yield* ws
+        .updateLockEntryAgents(op.args.newName, configuredAgents)
+        .pipe(Effect.catch(() => Effect.void));
+    return {
+        result: "success",
+        message: `Renamed ${op.args.oldName} to ${op.args.newName}`,
+    };
+});
+// -----------------------------------------------------------------------------
+// Internal
+// -----------------------------------------------------------------------------
+/** Update the `name` field in a SKILL.md's YAML frontmatter. */
+const updateSkillMdName = (fs, skillMdPath, newName) => Effect.gen(function* () {
+    const content = yield* fs.readFileString(skillMdPath);
+    const parsed = matter(content);
+    if (typeof parsed.data["name"] !== "string")
+        return;
+    parsed.data["name"] = newName;
+    yield* fs.writeFileString(skillMdPath, matter.stringify(parsed.content, parsed.data));
+});
+//# sourceMappingURL=rename.js.map

package/dist/src/unstable/skills/operations/rename.js.map

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

package/dist/src/unstable/skills/operations/uninstall.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Uninstall skill executor — orchestrates per-skill removal pipeline.
+ *
+ * Pipeline: sanitize name -> read lockfile -> remove agent symlinks (concurrent) ->
+ * remove canonical dir -> remove lockfile entry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import type { OperationHandler } from "../../workspace/apply-plan.js";
+import type { Operation } from "../../workspace/plan.js";
+import { Workspace } from "../../workspace/service-interface.js";
+/**
+ * Args for the uninstall-skill operation.
+ */
+export interface UninstallSkillOperationArgs {
+    readonly skillName: string;
+    /** Agent filter for partial uninstall. Empty = all agents. */
+    readonly agents: ReadonlyArray<string>;
+}
+/**
+ * Remove a skill from the workspace.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type UninstallSkillOperation = Operation<"uninstall-skill", UninstallSkillOperationArgs>;
+/**
+ * Uninstall-skill operation handler.
+ *
+ * Reads workspace paths from the Workspace service, then orchestrates:
+ * 1. Sanitize skill name for filesystem
+ * 2. Read lockfile to determine installed agents
+ * 3. Remove agent symlinks concurrently (skip missing)
+ * 4. Remove from all known canonical locations (full uninstall only)
+ * 5. Remove or update lockfile entry
+ */
+export declare const uninstallSkill: OperationHandler<UninstallSkillOperation, FileSystem.FileSystem | Path.Path | Workspace>;
+//# sourceMappingURL=uninstall.d.ts.map

package/dist/src/unstable/skills/operations/uninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/skills/operations/uninstall.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAKpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAUjE;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,CAAC,iBAAiB,EAAE,2BAA2B,CAAC,CAAC;AAMhG;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,EAAE,gBAAgB,CAC3C,uBAAuB,EACvB,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CA4H3C,CAAC"}