@bacnh85/agent-skills 0.1.1

package/dist/src/discovery.js

@@ -0,0 +1,161 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdtempSync, readdirSync, realpathSync, rmSync, statSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { validateSkill } from "./skill.js";
+const STANDARD_CONTAINERS = ["skills", ".agents/skills", ".claude/skills", ".codex/skills"];
+function normalizeRelativePath(value) {
+    const normalized = value.replaceAll("\\", "/").replace(/^\/+|\/+$/g, "");
+    if (!normalized || normalized.split("/").some((part) => part === ".." || part === ".")) {
+        throw new Error(`Unsafe source path: ${value}`);
+    }
+    return normalized;
+}
+export function parseSource(source, cwd = process.cwd()) {
+    const local = resolve(cwd, source);
+    if (source.startsWith(".") ||
+        source.startsWith("/") ||
+        source.startsWith("~") ||
+        /^[A-Za-z]:[\\/]/.test(source) ||
+        existsSync(local)) {
+        return { type: "local", normalized: realpathSync(local), localPath: realpathSync(local) };
+    }
+    const github = source.match(/^https?:\/\/github\.com\/([^/]+)\/([^/#]+?)(?:\.git)?(?:\/tree\/([^/]+)(?:\/(.+))?)?\/?$/);
+    if (github) {
+        const [, owner, repo, ref, path] = github;
+        return {
+            type: "git",
+            normalized: `https://github.com/${owner}/${repo}.git`,
+            cloneUrl: `https://github.com/${owner}/${repo}.git`,
+            ref,
+            directPath: path ? normalizeRelativePath(path) : undefined
+        };
+    }
+    const shorthand = source.match(/^([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)(?:#(.+))?$/);
+    if (shorthand) {
+        const [, owner, repo, ref] = shorthand;
+        return {
+            type: "git",
+            normalized: `https://github.com/${owner}/${repo.replace(/\.git$/, "")}.git`,
+            cloneUrl: `https://github.com/${owner}/${repo.replace(/\.git$/, "")}.git`,
+            ref
+        };
+    }
+    if (/^(?:git@|ssh:\/\/|git:\/\/|https?:\/\/|file:\/\/)/.test(source) ||
+        source.endsWith(".git")) {
+        const hash = source.lastIndexOf("#");
+        const cloneUrl = hash > source.indexOf("://") + 2 ? source.slice(0, hash) : source;
+        const ref = cloneUrl === source ? undefined : source.slice(hash + 1);
+        return { type: "git", normalized: cloneUrl, cloneUrl, ref };
+    }
+    throw new Error(`Unsupported source: ${source}`);
+}
+export function resolveSource(source, options = {}) {
+    const parsed = parseSource(source, options.cwd);
+    if (parsed.type === "local") {
+        return {
+            source: parsed.normalized,
+            sourceType: "local",
+            root: parsed.localPath,
+            cleanup() { }
+        };
+    }
+    const execute = options.execute ?? execFileSync;
+    const temporary = mkdtempSync(join(tmpdir(), "agent-skills-source-"));
+    const root = join(temporary, "repo");
+    try {
+        const args = ["clone", "--quiet", "--depth", "1"];
+        if (parsed.ref)
+            args.push("--branch", parsed.ref);
+        args.push(parsed.cloneUrl, root);
+        execute("git", args, { stdio: ["ignore", "ignore", "pipe"] });
+        const commit = String(execute("git", ["-C", root, "rev-parse", "HEAD"], {
+            encoding: "utf8"
+        })).trim();
+        const ref = parsed.ref ?? String(execute("git", ["-C", root, "symbolic-ref", "--short", "HEAD"], { encoding: "utf8" })).trim();
+        return {
+            source: parsed.normalized,
+            sourceType: "git",
+            root,
+            ref,
+            commit,
+            directPath: parsed.directPath,
+            cleanup: () => rmSync(temporary, { recursive: true, force: true })
+        };
+    }
+    catch (error) {
+        rmSync(temporary, { recursive: true, force: true });
+        throw error;
+    }
+}
+function isWithin(root, path) {
+    const rel = relative(root, path);
+    return rel === "" || (rel !== ".." && !rel.startsWith(`..${sep}`) && !isAbsolute(rel));
+}
+function assertTreeSafe(root, directory) {
+    for (const entry of readdirSync(directory, { withFileTypes: true })) {
+        const path = join(directory, entry.name);
+        if (entry.isSymbolicLink()) {
+            if (!isWithin(root, realpathSync(path))) {
+                throw new Error(`Unsafe symlink escapes source: ${path}`);
+            }
+        }
+        else if (entry.isDirectory()) {
+            assertTreeSafe(root, path);
+        }
+    }
+}
+function collectSkillDirectories(root) {
+    const found = [];
+    const visit = (directory) => {
+        if (existsSync(join(directory, "SKILL.md"))) {
+            found.push(directory);
+            return;
+        }
+        for (const entry of readdirSync(directory, { withFileTypes: true })) {
+            if (entry.isDirectory() && entry.name !== ".git" && entry.name !== "node_modules") {
+                visit(join(directory, entry.name));
+            }
+        }
+    };
+    visit(root);
+    return found;
+}
+export function discoverSkills(source) {
+    const root = realpathSync(source.root);
+    assertTreeSafe(root, root);
+    let directories;
+    if (source.directPath) {
+        const direct = resolve(root, source.directPath);
+        if (!isWithin(root, direct) || !existsSync(direct) || !statSync(direct).isDirectory()) {
+            throw new Error(`Skill path not found in source: ${source.directPath}`);
+        }
+        directories = existsSync(join(direct, "SKILL.md"))
+            ? [direct]
+            : collectSkillDirectories(direct);
+    }
+    else if (existsSync(join(root, "SKILL.md"))) {
+        directories = [root];
+    }
+    else {
+        directories = STANDARD_CONTAINERS.flatMap((container) => {
+            const path = join(root, container);
+            return existsSync(path) && statSync(path).isDirectory()
+                ? collectSkillDirectories(path)
+                : [];
+        });
+        if (!directories.length)
+            directories = collectSkillDirectories(root);
+    }
+    const unique = [...new Set(directories.map((path) => realpathSync(path)))];
+    return unique.map((absolutePath) => {
+        const name = basename(absolutePath);
+        validateSkill(absolutePath, name, root);
+        return {
+            name,
+            absolutePath,
+            relativePath: relative(root, absolutePath).split(sep).join("/") || "."
+        };
+    }).sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+}
+//# sourceMappingURL=discovery.js.map

package/dist/src/discovery.js.map

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

package/dist/src/installer.d.ts

@@ -0,0 +1,9 @@
+import type { DiscoveredSkill, OperationResult } from "./types.js";
+export declare function discoverInstalledSkills(target: string): DiscoveredSkill[];
+interface RemovalOperations {
+    rename(source: string, destination: string): void;
+    remove(path: string): void;
+}
+export declare function uninstallSkills(target: string, names: string[], operations?: RemovalOperations): OperationResult[];
+export declare function installSkills(target: string, skills: DiscoveredSkill[]): OperationResult[];
+export {};

package/dist/src/installer.js

@@ -0,0 +1,131 @@
+import { cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readdirSync, renameSync, rmSync } from "node:fs";
+import { dirname, join, resolve, sep } from "node:path";
+import { hashDirectory, validateSkill } from "./skill.js";
+function destinationFor(target, name) {
+    const destination = resolve(target, name);
+    const rel = destination.slice(resolve(target).length);
+    if (!(rel === "" || rel.startsWith(sep))) {
+        throw new Error(`Unsafe installation destination: ${name}`);
+    }
+    return destination;
+}
+function assertUniqueNames(skills) {
+    const seen = new Set();
+    for (const skill of skills) {
+        if (seen.has(skill.name)) {
+            throw new Error(`Duplicate skill name in source: ${skill.name}`);
+        }
+        seen.add(skill.name);
+    }
+}
+export function discoverInstalledSkills(target) {
+    if (!existsSync(target) || !lstatSync(target).isDirectory())
+        return [];
+    const skills = [];
+    for (const entry of readdirSync(target, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const absolutePath = join(target, entry.name);
+        try {
+            validateSkill(absolutePath, entry.name, absolutePath);
+            skills.push({ name: entry.name, absolutePath, relativePath: entry.name });
+        }
+        catch {
+            // Ignore unrelated and malformed directories in the install target.
+        }
+    }
+    return skills.sort((a, b) => a.name.localeCompare(b.name));
+}
+const defaultRemovalOperations = {
+    rename: renameSync,
+    remove: (path) => rmSync(path, { recursive: true, force: true })
+};
+export function uninstallSkills(target, names, operations = defaultRemovalOperations) {
+    const available = new Set(discoverInstalledSkills(target).map((skill) => skill.name));
+    const requested = [...new Set(names)];
+    const missing = requested.filter((name) => !available.has(name));
+    if (missing.length) {
+        throw new Error(`Installed skills not found: ${missing.join(", ")}`);
+    }
+    if (!requested.length)
+        return [];
+    const transaction = mkdtempSync(join(target, ".agent-skills-uninstall-"));
+    const moved = [];
+    try {
+        for (const [index, name] of requested.entries()) {
+            const source = destinationFor(target, name);
+            const backup = join(transaction, String(index));
+            operations.rename(source, backup);
+            moved.push({ source, backup });
+        }
+        operations.remove(transaction);
+        return requested.map((name) => ({
+            name,
+            action: "removed",
+            path: destinationFor(target, name)
+        }));
+    }
+    catch (error) {
+        for (const { source, backup } of moved.reverse()) {
+            if (existsSync(backup))
+                operations.rename(backup, source);
+        }
+        throw error;
+    }
+    finally {
+        if (existsSync(transaction)) {
+            rmSync(transaction, { recursive: true, force: true });
+        }
+    }
+}
+export function installSkills(target, skills) {
+    assertUniqueNames(skills);
+    mkdirSync(target, { recursive: true });
+    const stage = mkdtempSync(join(target, ".agent-skills-stage-"));
+    const transaction = mkdtempSync(join(target, ".agent-skills-transaction-"));
+    const staged = new Map();
+    const backups = [];
+    const installed = [];
+    const existed = new Set();
+    try {
+        for (const [index, skill] of skills.entries()) {
+            const path = join(stage, String(index));
+            cpSync(skill.absolutePath, path, { recursive: true, dereference: false });
+            validateSkill(path, skill.name, path);
+            hashDirectory(path);
+            staged.set(skill.name, path);
+        }
+        for (const [index, skill] of skills.entries()) {
+            const destination = destinationFor(target, skill.name);
+            mkdirSync(dirname(destination), { recursive: true });
+            if (existsSync(destination)) {
+                existed.add(skill.name);
+                const backup = join(transaction, String(index));
+                renameSync(destination, backup);
+                backups.push({ destination, backup });
+            }
+            renameSync(staged.get(skill.name), destination);
+            installed.push(destination);
+        }
+        return skills.map((skill) => ({
+            name: skill.name,
+            action: existed.has(skill.name) ? "updated" : "added",
+            path: destinationFor(target, skill.name)
+        }));
+    }
+    catch (error) {
+        for (const destination of installed.reverse()) {
+            rmSync(destination, { recursive: true, force: true });
+        }
+        for (const backup of backups.reverse()) {
+            if (existsSync(backup.backup))
+                renameSync(backup.backup, backup.destination);
+        }
+        throw error;
+    }
+    finally {
+        rmSync(stage, { recursive: true, force: true });
+        rmSync(transaction, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=installer.js.map

package/dist/src/installer.js.map

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

package/dist/src/manager.d.ts

@@ -0,0 +1,8 @@
+import type { DiscoveredSkill, OperationResult, ResolvedSource } from "./types.js";
+export declare function addSkills(options: {
+    repo: string;
+    source: ResolvedSource;
+    selected: DiscoveredSkill[];
+}): OperationResult[];
+export declare function removeSkills(repo: string, names: string[]): OperationResult[];
+export declare function updateSkills(repo: string, names?: string[], onProgress?: (name: string, index: number, total: number) => void): OperationResult[];

package/dist/src/manager.js

@@ -0,0 +1,229 @@
+import { cpSync, existsSync, mkdirSync, mkdtempSync, renameSync, rmSync } from "node:fs";
+import { dirname, join, resolve, sep } from "node:path";
+import { discoverSkills, resolveSource } from "./discovery.js";
+import { appendHistory, readRegistry, writeRegistry } from "./registry.js";
+import { hashDirectory, validateSkill } from "./skill.js";
+function destinationFor(repo, relativePath) {
+    const destination = resolve(repo, relativePath);
+    const rel = destination.slice(resolve(repo).length);
+    if (!(rel === "" || rel.startsWith(sep)))
+        throw new Error(`Unsafe destination: ${relativePath}`);
+    return destination;
+}
+function stageSkills(repo, source, selected) {
+    mkdirSync(repo, { recursive: true });
+    const root = mkdtempSync(join(repo, ".agent-skills-stage-"));
+    const staged = new Map();
+    const now = new Date().toISOString();
+    const entries = selected.map((skill, index) => {
+        const path = skill.relativePath === "." ? skill.name : skill.relativePath;
+        const target = join(root, String(index));
+        cpSync(skill.absolutePath, target, { recursive: true, dereference: false });
+        validateSkill(target, skill.name, target);
+        const hash = hashDirectory(target);
+        staged.set(skill.name, target);
+        return {
+            name: skill.name,
+            path,
+            source: source.source,
+            sourceType: source.sourceType,
+            sourcePath: skill.relativePath,
+            ref: source.ref,
+            commit: source.commit,
+            hash,
+            addedAt: now,
+            updatedAt: now,
+            updatable: true
+        };
+    });
+    return { root, entries, staged };
+}
+function assertUniqueNames(registry, selected, source) {
+    const seen = new Set();
+    for (const skill of selected) {
+        if (seen.has(skill.name))
+            throw new Error(`Duplicate skill name in source: ${skill.name}`);
+        seen.add(skill.name);
+        const previous = registry.skills[skill.name];
+        if (previous && previous.source !== source.source) {
+            throw new Error(`Skill name "${skill.name}" is already registered from ${previous.source}.`);
+        }
+    }
+}
+function commitStaged(repo, registry, entries, staged, action) {
+    const transaction = mkdtempSync(join(repo, ".agent-skills-transaction-"));
+    const backups = [];
+    const installed = [];
+    try {
+        for (const entry of entries) {
+            const destination = destinationFor(repo, entry.path);
+            mkdirSync(dirname(destination), { recursive: true });
+            if (existsSync(destination)) {
+                const backup = join(transaction, entry.name);
+                renameSync(destination, backup);
+                backups.push({ destination, backup });
+            }
+            renameSync(staged.get(entry.name), destination);
+            installed.push(destination);
+            registry.skills[entry.name] = entry;
+        }
+        writeRegistry(repo, registry);
+        const timestamp = new Date().toISOString();
+        for (const entry of entries) {
+            appendHistory(repo, {
+                timestamp,
+                action,
+                skill: entry.name,
+                path: entry.path,
+                source: entry.source,
+                ref: entry.ref,
+                commit: entry.commit,
+                hash: entry.hash
+            });
+        }
+        return entries.map((entry) => ({
+            name: entry.name,
+            action: action === "add" ? "added" : "updated",
+            path: entry.path,
+            hash: entry.hash
+        }));
+    }
+    catch (error) {
+        for (const destination of installed.reverse()) {
+            rmSync(destination, { recursive: true, force: true });
+        }
+        for (const backup of backups.reverse()) {
+            if (existsSync(backup.backup))
+                renameSync(backup.backup, backup.destination);
+        }
+        throw error;
+    }
+    finally {
+        rmSync(transaction, { recursive: true, force: true });
+    }
+}
+export function addSkills(options) {
+    const registry = readRegistry(options.repo);
+    assertUniqueNames(registry, options.selected, options.source);
+    const staged = stageSkills(options.repo, options.source, options.selected);
+    try {
+        const unchanged = [];
+        const changedEntries = staged.entries.filter((entry) => {
+            const previous = registry.skills[entry.name];
+            if (previous?.hash === entry.hash && previous.path === entry.path) {
+                unchanged.push({
+                    name: entry.name,
+                    action: "unchanged",
+                    path: entry.path,
+                    hash: entry.hash
+                });
+                return false;
+            }
+            if (previous)
+                entry.addedAt = previous.addedAt;
+            return true;
+        });
+        if (!changedEntries.length)
+            return unchanged;
+        return commitStaged(options.repo, registry, changedEntries, staged.staged, "add").concat(unchanged);
+    }
+    finally {
+        rmSync(staged.root, { recursive: true, force: true });
+    }
+}
+export function removeSkills(repo, names) {
+    const registry = readRegistry(repo);
+    const missing = names.filter((name) => !registry.skills[name]);
+    if (missing.length)
+        throw new Error(`Skills not found: ${missing.join(", ")}`);
+    const removed = [];
+    const transaction = mkdtempSync(join(repo, ".agent-skills-remove-"));
+    try {
+        for (const name of names) {
+            const entry = registry.skills[name];
+            const destination = destinationFor(repo, entry.path);
+            const backup = join(transaction, name);
+            if (existsSync(destination)) {
+                renameSync(destination, backup);
+                removed.push({ entry, backup, destination });
+            }
+            delete registry.skills[name];
+        }
+        writeRegistry(repo, registry);
+        const timestamp = new Date().toISOString();
+        for (const name of names)
+            appendHistory(repo, { timestamp, action: "remove", skill: name });
+        return names.map((name) => ({ name, action: "removed" }));
+    }
+    catch (error) {
+        for (const item of removed.reverse())
+            renameSync(item.backup, item.destination);
+        throw error;
+    }
+    finally {
+        rmSync(transaction, { recursive: true, force: true });
+    }
+}
+export function updateSkills(repo, names, onProgress) {
+    const registry = readRegistry(repo);
+    const selectedNames = names?.length ? names : Object.keys(registry.skills);
+    const missing = selectedNames.filter((name) => !registry.skills[name]);
+    if (missing.length)
+        throw new Error(`Skills not found: ${missing.join(", ")}`);
+    const results = [];
+    for (const [index, name] of selectedNames.entries()) {
+        onProgress?.(name, index + 1, selectedNames.length);
+        const previous = registry.skills[name];
+        if (!previous.updatable || !previous.sourcePath) {
+            results.push({
+                name,
+                action: "skipped",
+                message: "legacy entry must be re-added before updating"
+            });
+            continue;
+        }
+        let source;
+        try {
+            source = resolveSource(previous.sourceType === "git" && previous.ref
+                ? `${previous.source}#${previous.ref}`
+                : previous.source);
+            const discovered = discoverSkills(source);
+            const skill = discovered.find((candidate) => candidate.relativePath === previous.sourcePath);
+            if (!skill) {
+                results.push({ name, action: "skipped", message: "source path no longer exists" });
+                continue;
+            }
+            if (skill.name !== name) {
+                results.push({ name, action: "skipped", message: "source skill name changed" });
+                continue;
+            }
+            const hash = hashDirectory(skill.absolutePath);
+            if (hash === previous.hash) {
+                results.push({ name, action: "unchanged", path: previous.path, hash });
+                continue;
+            }
+            const staged = stageSkills(repo, source, [skill]);
+            try {
+                const entry = staged.entries[0];
+                entry.path = previous.path;
+                entry.addedAt = previous.addedAt;
+                results.push(...commitStaged(repo, registry, [entry], staged.staged, "update"));
+            }
+            finally {
+                rmSync(staged.root, { recursive: true, force: true });
+            }
+        }
+        catch (error) {
+            results.push({
+                name,
+                action: "skipped",
+                message: error instanceof Error ? error.message : String(error)
+            });
+        }
+        finally {
+            source?.cleanup();
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=manager.js.map

package/dist/src/manager.js.map

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

package/dist/src/registry.d.ts

@@ -0,0 +1,5 @@
+import type { Registry } from "./types.js";
+export declare function readRegistry(repo: string): Registry;
+export declare function writeAtomic(path: string, content: string): void;
+export declare function writeRegistry(repo: string, registry: Registry): void;
+export declare function appendHistory(repo: string, event: Record<string, unknown>): void;

package/dist/src/registry.js

@@ -0,0 +1,46 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+export function readRegistry(repo) {
+    const path = join(repo, "skill-registry.json");
+    if (!existsSync(path))
+        return { version: 2, skills: {} };
+    const raw = JSON.parse(readFileSync(path, "utf8"));
+    if (raw.version === 2)
+        return raw;
+    const skills = {};
+    for (const [key, value] of Object.entries(raw.skills ?? {})) {
+        const legacy = value;
+        const name = legacy.name ?? key;
+        const path = legacy.category ? `skills/${legacy.category}/${name}` : `skills/${name}`;
+        const sourceType = legacy.sourceType === "local" ? "local" : "git";
+        const updatable = Boolean(legacy.source &&
+            legacy.hash &&
+            (sourceType === "local" || legacy.sourcePath));
+        skills[name] = {
+            name,
+            path,
+            source: legacy.source ?? "unknown",
+            sourceType,
+            sourcePath: legacy.sourcePath?.replace(/\/SKILL\.md$/, ""),
+            hash: legacy.hash ?? "",
+            addedAt: legacy.firstPromotedAt ?? legacy.updatedAt ?? "",
+            updatedAt: legacy.updatedAt ?? legacy.firstPromotedAt ?? "",
+            updatable
+        };
+    }
+    return { version: 2, skills };
+}
+export function writeAtomic(path, content) {
+    mkdirSync(dirname(path), { recursive: true });
+    const temporary = `${path}.${process.pid}.tmp`;
+    writeFileSync(temporary, content);
+    renameSync(temporary, path);
+}
+export function writeRegistry(repo, registry) {
+    writeAtomic(join(repo, "skill-registry.json"), `${JSON.stringify(registry, null, 2)}\n`);
+}
+export function appendHistory(repo, event) {
+    mkdirSync(repo, { recursive: true });
+    appendFileSync(join(repo, "skill-history.jsonl"), `${JSON.stringify({ version: 2, ...event })}\n`);
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/registry.js.map

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

package/dist/src/skill.d.ts

@@ -0,0 +1,2 @@
+export declare function validateSkill(source: string, expectedName: string, sourceRoot?: string): string;
+export declare function hashDirectory(root: string): string;