@bacnh85/agent-skills 0.1.1

package/README.md

@@ -0,0 +1,229 @@
+# Agent Skills
+
+`agent-skills` manages a curated repository of AI agent skills and installs
+those skills into project or user directories.
+
+## Requirements
+
+- Node.js 20 or later
+- Git for adding or updating skills from remote repositories
+
+## Install the CLI
+
+Install the CLI globally from GitHub:
+
+```bash
+npm install -g @bacnh85/agent-skills
+```
+
+Verify the installed CLI:
+
+```bash
+agent-skills --help
+```
+
+You can also install it into a project and run it with `npx`:
+
+```bash
+npm install @bacnh85/agent-skills
+npx agent-skills --help
+```
+
+Pin a branch, tag, or commit by adding a `#ref` suffix:
+
+```bash
+npm install -g bacnh85/agent-skills#main
+npm install bacnh85/agent-skills#main
+```
+
+SSH/Git installs also work on development machines with GitHub SSH keys:
+
+```bash
+npm install -g git+ssh://git@github.com/bacnh85/agent-skills.git
+```
+
+Set `AGENT_SKILLS_REPO` to the local checkout that contains the curated
+`skills/` directory and its registry:
+
+```bash
+export AGENT_SKILLS_REPO=/absolute/path/to/agent-skills
+```
+
+PowerShell on Windows:
+
+```powershell
+$env:AGENT_SKILLS_REPO = "C:\path\to\agent-skills"
+```
+
+To persist it for future PowerShell sessions:
+
+```powershell
+[Environment]::SetEnvironmentVariable("AGENT_SKILLS_REPO", "C:\path\to\agent-skills", "User")
+```
+
+When the variable is not set, `agent-skills` uses the current working
+directory as the repository.
+
+## Install Skills for Agents
+
+Run this command from a project directory to select skills interactively:
+
+```bash
+agent-skills install
+```
+
+Selected skills are installed in:
+
+```text
+<current-directory>/.agents/skills/
+```
+
+Install every skill without a prompt:
+
+```bash
+agent-skills install --all
+```
+
+Install selected skills for the current user:
+
+```bash
+agent-skills install -g
+```
+
+Install every skill for the current user:
+
+```bash
+agent-skills install -g --all
+```
+
+Global skills are installed in:
+
+```text
+~/.agents/skills/
+```
+
+Installing a selected skill replaces its existing directory with the
+repository version. Skills in the destination that were not selected are left
+untouched.
+
+Interactive selection requires a terminal. Use `--all` in scripts, CI, and
+other non-interactive environments.
+
+## Uninstall Skills for Agents
+
+Remove named skills from the current project:
+
+```bash
+agent-skills uninstall demo notes
+```
+
+Run without names to select installed project skills interactively:
+
+```bash
+agent-skills uninstall
+```
+
+Remove every installed project skill:
+
+```bash
+agent-skills uninstall --all
+```
+
+Use `-g` with named, interactive, or `--all` forms to remove skills from
+`~/.agents/skills/`:
+
+```bash
+agent-skills uninstall demo -g
+agent-skills uninstall -g
+agent-skills uninstall --all -g
+```
+
+Only valid immediate skill directories are candidates. Uninstall leaves the
+`.agents/skills` directory and all unselected or unrelated entries intact.
+
+## Manage the Curated Repository
+
+The following commands read and update the repository selected by
+`AGENT_SKILLS_REPO`, or the current directory when it is unset.
+
+### Add
+
+Add skills from GitHub shorthand, a GitHub tree URL, any Git URL, or a local
+path:
+
+```bash
+agent-skills add vercel-labs/skills
+agent-skills add https://github.com/acme/skills/tree/main/skills/demo
+agent-skills add ssh://git@github.com/acme/skills.git
+agent-skills add ./my-local-skills
+```
+
+A direct skill source or a source containing one skill is selected
+automatically. Sources containing multiple skills open an interactive
+multiselect. Non-interactive callers must use a direct skill URL or path.
+
+### List
+
+List skills registered in the curated repository:
+
+```bash
+agent-skills list
+```
+
+### Remove
+
+Remove named skills:
+
+```bash
+agent-skills remove demo another-skill
+```
+
+Run without names to select skills interactively:
+
+```bash
+agent-skills remove
+```
+
+### Update
+
+Update named skills from their recorded sources:
+
+```bash
+agent-skills update demo another-skill
+```
+
+Run without names to update every registered skill:
+
+```bash
+agent-skills update
+```
+
+Git skills track the branch or ref recorded when added. Local skills are
+copied again from their original absolute path.
+
+## Command Reference
+
+```text
+agent-skills add <source>
+agent-skills remove [skills...]
+agent-skills list
+agent-skills update [skills...]
+agent-skills install [-g] [--all]
+agent-skills uninstall [skills...] [-g]
+agent-skills uninstall --all [-g]
+```
+
+## Repository Metadata
+
+`skill-registry.json` records each curated skill's repository-relative
+destination, source, source-relative path, tracked ref and commit, content
+hash, and timestamps. `skill-history.jsonl` contains append-only `add`,
+`update`, and `remove` events.
+
+These metadata files belong to the curated repository. The `install` command
+copies only skill directories and does not create registry or history files in
+`.agents/skills`.
+
+Version 1 registries are migrated in memory and written as version 2 on the
+next mutation. Legacy entries without enough source provenance remain listable
+and removable, but must be re-added before they can be updated.

package/dist/src/cli.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import type { RegistryEntry } from "./types.js";
+export interface Args {
+    command?: "add" | "remove" | "list" | "update" | "install" | "uninstall";
+    values: string[];
+    all?: boolean;
+    global?: boolean;
+}
+export declare function usage(): string;
+export declare function parseArgs(argv: string[]): Args;
+export declare function isCliEntrypoint(moduleUrl: string, argvPath?: string): boolean;
+export declare function formatRegistryList(entries: RegistryEntry[]): string;

package/dist/src/cli.js

@@ -0,0 +1,224 @@
+#!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import pc from "picocolors";
+import { resolveInstallTarget, resolveTargetRepo } from "./config.js";
+import { discoverSkills, resolveSource } from "./discovery.js";
+import { discoverInstalledSkills, installSkills, uninstallSkills } from "./installer.js";
+import { addSkills, removeSkills, updateSkills } from "./manager.js";
+import { readRegistry } from "./registry.js";
+import { formatOperationResult, runOperation, selectDiscoveredSkills, selectInstalledSkills, selectRegistrySkills } from "./ui.js";
+export function usage() {
+    return `Usage:
+  agent-skills add <source>
+  agent-skills remove [skills...]
+  agent-skills list
+  agent-skills update [skills...]
+  agent-skills install [-g] [--all]
+  agent-skills uninstall [skills...] [-g]
+  agent-skills uninstall --all [-g]`;
+}
+export function parseArgs(argv) {
+    if (!argv.length)
+        return { values: [] };
+    if (argv[0] === "--help" || argv[0] === "-h")
+        return { values: [] };
+    const command = argv[0];
+    if (!["add", "remove", "list", "update", "install", "uninstall"].includes(command)) {
+        throw new Error(`Unknown command: ${command}`);
+    }
+    const values = argv.slice(1);
+    if (command === "install") {
+        const allowed = new Set(["-g", "--all"]);
+        const option = values.find((value) => value.startsWith("-") && !allowed.has(value));
+        if (option)
+            throw new Error(`Unknown option: ${option}`);
+        const positional = values.find((value) => !value.startsWith("-"));
+        if (positional)
+            throw new Error("agent-skills install does not accept arguments.");
+        return {
+            command: "install",
+            values: [],
+            all: values.includes("--all"),
+            global: values.includes("-g")
+        };
+    }
+    if (command === "uninstall") {
+        const allowed = new Set(["-g", "--all"]);
+        const option = values.find((value) => value.startsWith("-") && !allowed.has(value));
+        if (option)
+            throw new Error(`Unknown option: ${option}`);
+        const names = values.filter((value) => !value.startsWith("-"));
+        const all = values.includes("--all");
+        if (all && names.length) {
+            throw new Error("agent-skills uninstall does not accept names with --all.");
+        }
+        return {
+            command: "uninstall",
+            values: names,
+            all,
+            global: values.includes("-g")
+        };
+    }
+    const option = values.find((value) => value.startsWith("-"));
+    if (option)
+        throw new Error(`Unknown option: ${option}`);
+    if (command === "add" && values.length !== 1) {
+        throw new Error("Usage: agent-skills add <source>");
+    }
+    if (command === "list" && values.length) {
+        throw new Error("agent-skills list does not accept arguments.");
+    }
+    return { command: command, values };
+}
+export function isCliEntrypoint(moduleUrl, argvPath) {
+    if (!argvPath)
+        return false;
+    try {
+        return realpathSync(fileURLToPath(moduleUrl)) === realpathSync(argvPath);
+    }
+    catch {
+        return false;
+    }
+}
+export function formatRegistryList(entries) {
+    if (!entries.length)
+        return pc.dim("No project skills found.");
+    const rows = [...entries]
+        .sort((a, b) => a.name.localeCompare(b.name))
+        .map((entry) => ({
+        name: entry.name,
+        path: entry.path,
+        source: entry.source || "-",
+        ref: entry.ref || "-",
+        commit: entry.commit?.slice(0, 12) || "-",
+        updatedAt: entry.updatedAt || "-"
+    }));
+    const width = (values) => Math.max(...values.map((value) => value.length));
+    const widths = {
+        name: width(rows.map((row) => row.name)),
+        path: width(rows.map((row) => row.path)),
+        source: width(rows.map((row) => row.source)),
+        ref: width(rows.map((row) => row.ref)),
+        commit: width(rows.map((row) => row.commit))
+    };
+    const lines = rows.map((row) => [
+        pc.cyan(row.name.padEnd(widths.name)),
+        pc.dim(row.path.padEnd(widths.path)),
+        `${pc.dim("Source:")} ${row.source.padEnd(widths.source)}`,
+        `${pc.dim("Ref:")} ${row.ref.padEnd(widths.ref)}`,
+        `${pc.dim("Commit:")} ${row.commit.padEnd(widths.commit)}`,
+        `${pc.dim("Updated:")} ${row.updatedAt}`
+    ].join("  "));
+    return [pc.bold("Project Skills"), "", ...lines, ""].join("\n");
+}
+function printResults(results) {
+    for (const result of results) {
+        console.log(formatOperationResult(result));
+    }
+}
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (!args.command) {
+        console.log(usage());
+        return;
+    }
+    const interactive = Boolean(process.stdout.isTTY);
+    if (args.command === "install") {
+        const repo = resolveTargetRepo();
+        const source = resolveSource(join(repo, "skills"));
+        try {
+            const discovered = discoverSkills(source);
+            if (!discovered.length)
+                throw new Error("No skills found in repository.");
+            let selected = discovered;
+            if (!args.all) {
+                if (!process.stdin.isTTY) {
+                    throw new Error("Interactive skill selection requires a TTY. Use --all for unattended installation.");
+                }
+                selected = await selectDiscoveredSkills(discovered, "install");
+                if (!selected.length)
+                    return;
+            }
+            const target = resolveInstallTarget({ global: args.global });
+            const count = selected.length;
+            printResults(runOperation(`Installing ${count} skill${count === 1 ? "" : "s"}...`, `Installed ${count} skill${count === 1 ? "" : "s"}`, interactive, () => installSkills(target, selected)));
+        }
+        finally {
+            source.cleanup();
+        }
+        return;
+    }
+    if (args.command === "uninstall") {
+        const target = resolveInstallTarget({ global: args.global });
+        const installed = discoverInstalledSkills(target);
+        if (!installed.length)
+            throw new Error(`No installed skills found in ${target}.`);
+        let names = args.all ? installed.map((skill) => skill.name) : args.values;
+        if (!args.all && !names.length) {
+            if (!process.stdin.isTTY) {
+                throw new Error("Interactive skill selection requires a TTY. Specify skills or use --all.");
+            }
+            names = await selectInstalledSkills(installed);
+            if (!names.length)
+                return;
+        }
+        const count = names.length;
+        printResults(runOperation(`Uninstalling ${count} skill${count === 1 ? "" : "s"}...`, `Uninstalled ${count} skill${count === 1 ? "" : "s"}`, interactive, () => uninstallSkills(target, names)));
+        return;
+    }
+    const repo = resolveTargetRepo();
+    if (args.command === "list") {
+        console.log(formatRegistryList(Object.values(readRegistry(repo).skills)));
+        return;
+    }
+    if (args.command === "remove") {
+        let names = args.values;
+        if (!names.length) {
+            if (!process.stdin.isTTY) {
+                throw new Error("No skills specified and interactive selection is unavailable.");
+            }
+            names = await selectRegistrySkills(Object.values(readRegistry(repo).skills));
+            if (!names.length)
+                return;
+        }
+        const count = names.length;
+        printResults(runOperation(`Removing ${count} skill${count === 1 ? "" : "s"}...`, `Removed ${count} skill${count === 1 ? "" : "s"}`, interactive, () => removeSkills(repo, names)));
+        return;
+    }
+    if (args.command === "update") {
+        const count = args.values.length || Object.keys(readRegistry(repo).skills).length;
+        printResults(runOperation(`Updating ${count} skill${count === 1 ? "" : "s"}...`, `Checked ${count} skill${count === 1 ? "" : "s"}`, interactive, (progress) => updateSkills(repo, args.values, (name, index, total) => {
+            progress.message(`Updating ${name} (${index}/${total})...`);
+        })));
+        return;
+    }
+    const source = resolveSource(args.values[0]);
+    try {
+        const discovered = discoverSkills(source);
+        if (!discovered.length)
+            throw new Error("No skills found in source.");
+        let selected = discovered;
+        if (discovered.length > 1) {
+            if (!process.stdin.isTTY) {
+                throw new Error(`Source contains ${discovered.length} skills; interactive selection requires a TTY. Use a direct skill URL or path.`);
+            }
+            selected = await selectDiscoveredSkills(discovered);
+            if (!selected.length)
+                return;
+        }
+        const count = selected.length;
+        printResults(runOperation(`Adding ${count} skill${count === 1 ? "" : "s"}...`, `Added ${count} skill${count === 1 ? "" : "s"}`, interactive, () => addSkills({ repo, source, selected })));
+    }
+    finally {
+        source.cleanup();
+    }
+}
+if (isCliEntrypoint(import.meta.url, process.argv[1])) {
+    main().catch((error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/config.d.ts

@@ -0,0 +1,9 @@
+export declare function resolveTargetRepo(options?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}): string;
+export declare function resolveInstallTarget(options?: {
+    cwd?: string;
+    home?: string;
+    global?: boolean;
+}): string;

package/dist/src/config.js

@@ -0,0 +1,14 @@
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+export function resolveTargetRepo(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const configured = (options.env ?? process.env).AGENT_SKILLS_REPO;
+    return resolve(cwd, configured || ".");
+}
+export function resolveInstallTarget(options = {}) {
+    const root = options.global
+        ? options.home ?? homedir()
+        : options.cwd ?? process.cwd();
+    return join(root, ".agents", "skills");
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,UAAU,iBAAiB,CAAC,UAG9B,EAAE;IACJ,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAC;IAClE,OAAO,OAAO,CAAC,GAAG,EAAE,UAAU,IAAI,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAIjC,EAAE;IACJ,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM;QACzB,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,EAAE;QAC3B,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACjC,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC"}

package/dist/src/discovery.d.ts

@@ -0,0 +1,16 @@
+import { execFileSync } from "node:child_process";
+import type { DiscoveredSkill, ResolvedSource } from "./types.js";
+export interface ParsedSource {
+    type: "git" | "local";
+    normalized: string;
+    cloneUrl?: string;
+    ref?: string;
+    directPath?: string;
+    localPath?: string;
+}
+export declare function parseSource(source: string, cwd?: string): ParsedSource;
+export declare function resolveSource(source: string, options?: {
+    cwd?: string;
+    execute?: typeof execFileSync;
+}): ResolvedSource;
+export declare function discoverSkills(source: ResolvedSource): DiscoveredSkill[];