overskill 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jacob Chase-Lubitz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,261 @@
+# Overskill
+
+A CLI for managing skills across repositories.
+
+## Why Overskill over AI Agent Plugins?
+
+Tools like Claude Code offer built-in plugin systems for distributing skills. Overskill takes a different approach — skills live in your repo as plain files — and this comes with meaningful advantages:
+
+- **Agent-agnostic**: Overskill skills work with Claude Code, Cursor, Codex, Windsurf, and any agent that can read markdown. Plugins lock you into a single tool.
+- **Transparent and auditable**: Skills are visible files in your project. You can read, diff, and review them like any other code. Plugin skills are buried in global cache directories.
+- **Version-locked per repo**: `.skills.lock` pins exact versions and hashes to each commit, giving you reproducible builds. Plugins are installed globally or per-user with no per-repo lockfile.
+- **Team-friendly**: `skill sync` works like `npm install` — clone the repo, run one command, and everyone has the same skills at the same versions. Plugins require each developer to install them separately.
+- **Full control over activation**: You decide how and when skills are loaded via `CLAUDE.md`, `.cursor/rules`, or `AGENTS.md`. Plugin activation is controlled by the agent vendor.
+- **Works offline**: Once synced, skills are local files with no runtime dependency on external services.
+- **No vendor dependency**: Your skills aren't tied to a plugin API that could change or be deprecated. They're markdown files — the most durable format there is.
+
+## Requirements
+
+- Node.js >= 18
+
+## Setup
+
+### CLI
+
+1. Install dependencies and build:
+
+```bash
+cd cli
+npm install
+npm run build
+```
+
+2. Run the CLI:
+
+
+```bash
+node dist/index.js --help
+```
+
+Optional: link the CLI for a global `skill` command:
+
+```bash
+npm link
+skill --help
+```
+
+## CLI Quick Start
+
+### Local-Only Workflow (No Cloud)
+
+1. Initialize a local-only project:
+
+```bash
+skill init
+```
+
+2. Create a new skill:
+
+```bash
+skill new my-skill
+```
+
+3. Add skills from local cache:
+
+```bash
+skill add my-skill
+```
+
+4. Import skills from other tools (Claude, Cursor, Codex):
+
+```bash
+skill import
+```
+
+### Cloud Workflow (Coming Soon)
+
+1. Configure the API URL:
+
+```bash
+skill config api_url https://your-domain.example/api
+```
+
+2. Initialize with cloud registry:
+
+```bash
+skill init --cloud --registry your-registry
+```
+
+3. Log in:
+
+```bash
+skill login
+```
+
+4. Add and sync skills:
+
+```bash
+skill add my-skill
+skill sync
+```
+
+## Commands
+
+### Configuration
+
+- `skill config <key> [value]` - Get or set config (`api_url`, `editor`, `install_path`)
+- `skill config show` - Show all config
+- `skill config logout` - Clear authentication tokens
+
+### Project Setup
+
+- `skill init [options]` - Initialize `.skills.yaml` in current directory. Also configures AI agent integration files (see [AI Agent Integration](#ai-agent-integration)).
+  - `--cloud` - Include a cloud registry source
+  - `-u, --url <url>` - API URL for cloud registry (requires `--cloud`)
+  - `-r, --registry <slug>` - Cloud registry slug (requires `--cloud`)
+  - `-p, --path <path>` - Custom install path (default: `.skills`)
+
+### Authentication
+
+- `skill login [--manual]` - Authenticate with cloud registry (browser flow or manual code entry)
+
+### Skill Creation & Management
+
+- `skill new <slug> [options]` - Create a new skill in local registry
+  - `-n, --name <name>` - Display name
+  - `-d, --description <desc>` - Description
+  - `-t, --tags <tags>` - Comma-separated tags
+  - `-c, --compat <compat>` - Compatibility list (e.g., `claude,gpt4`)
+  - `-v, --version <version>` - Initial version (default: `1.0.0`)
+  - `-m, --metadata <key=value>` - Custom frontmatter metadata (repeatable)
+  - `--content <file>` - Read content from file instead of editor
+  - `--blank` - Open editor with blank content (frontmatter only)
+  - `--no-editor` - Skip editor, create with template
+  - `--no-add` - Skip adding to current project
+  - `--no-sync` - Skip automatic sync
+
+- `skill publish <slug> [options]` - Publish a new version of existing skill
+  - `-v, --version <version>` - Explicit version number
+  - `--patch` - Bump patch version (1.0.0 → 1.0.1)
+  - `--minor` - Bump minor version (1.0.0 → 1.1.0)
+  - `--major` - Bump major version (1.0.0 → 2.0.0)
+  - `-m, --message <message>` - Changelog message
+  - `--content <file>` - Read content from file
+  - `--no-editor` - Skip editor, use current content
+
+- `skill import [path] [options]` - Import skills from other AI tools
+  - `[path]` - Custom path to scan (optional)
+  - `-f, --force` - Overwrite existing skills
+  - `--add` - Add imported skills to `.skills.yaml`
+  - `--sync` - Run sync after importing (requires `--add`)
+  - `--dry-run` - Preview without making changes
+  - `-y, --yes` - Import all without prompting
+
+### Project Operations
+
+- `skill add [slugs...] [options]` - Add skills to project
+  - Interactive mode if no slugs provided (checkbox selection)
+  - `-v, --version <constraint>` - Version constraint (e.g., `>=1.0.0`, `^2.0.0`)
+  - `--no-sync` - Skip automatic sync after adding
+
+- `skill remove <slugs...>` - Remove skills from project
+
+- `skill sync [options]` - Sync configured skills to install directory. Also updates AI agent integration files (see [AI Agent Integration](#ai-agent-integration)).
+  - `-f, --force` - Force re-install even if unchanged
+
+- `skill update [slug] [--check]` - Update to latest versions
+
+### Discovery & Information
+
+- `skill list [options]` - List available skills
+  - `--installed` - Show only installed skills in current project
+  - `--local` - Show only local registry skills
+
+- `skill search <query> [options]` - Search for skills
+  - `-t, --tags <tags>` - Filter by tags
+  - `-c, --compat <compat>` - Filter by compatibility
+
+- `skill info <slug> [options]` - Show detailed skill information
+  - `-v, --version <version>` - Show info for specific version
+
+### Editing & Validation
+
+- `skill edit <slug>` - Edit a local skill using configured editor
+
+- `skill diff <slug>` - Show differences between local and registry versions
+
+- `skill validate [slug]` - Validate skill files (validates all if no slug provided)
+
+## Project Files
+
+- `.skills.yaml` - Project config (sources, install path, skills list)
+- `.skills.lock` - Version lock file (like package-lock.json)
+- `.skills/` - Installed skills directory (default, configurable)
+- `SKILLS_INDEX.md` - Generated index of installed skills for AI discovery
+
+## AI Agent Integration
+
+When you run `skill init` or `skill sync`, Overskill automatically configures your project so that AI coding agents discover and use your installed skills. It updates the following files:
+
+- **`CLAUDE.md`** — Claude Code reads this file automatically. Overskill adds a managed section that points Claude to `SKILLS_INDEX.md`.
+- **`AGENTS.md`** — Read by Codex and other agents. Same managed section as `CLAUDE.md`.
+- **`.cursor/rules/overskill.mdc`** — Cursor rule with `alwaysApply: true` that tells Cursor to read the skills index.
+
+The `CLAUDE.md` and `AGENTS.md` sections are wrapped in `<!-- overskill-start -->` / `<!-- overskill-end -->` comment markers so they can be updated idempotently without affecting the rest of the file. The Cursor rule is a standalone file that gets overwritten on each sync.
+
+
+## Local Registry
+
+Skills are cached locally in `~/.local/share/overskill/cache/` (Linux/macOS) or equivalent on Windows. The local registry supports:
+
+- Creating skills with `skill new`
+- Publishing versions with `skill publish`
+- Importing from other tools with `skill import`
+- Version resolution with semver constraints
+
+# Coming for Cloud
+
+### Commands for Cloud
+
+- `skill login [--manual]` - Authenticate with cloud registry (browser flow or manual code entry)
+
+- `skill config api_url <url>` - Set the API URL for the cloud registry
+
+- `skill config registry <slug>` - Set the registry slug for the cloud registry
+
+- `skill config install_path <path>` - Set the install path for the cloud registry
+
+### Publishing & Sharing
+
+- `skill push [slug] [--create ...]` - Publish changes to cloud registry
+
+- `skill bundle [slugs...] [options]` - Bundle skills into single markdown file
+  - `[slugs...]` - Specific skills to bundle (bundles all if omitted)
+  - `-o, --output <path>` - Output file path (default: `skills-bundle.md`)
+
+- `skill delete <skill>` - Delete skill from registry
+  - Local: `skill delete <slug>`
+  - Remote: `skill delete <registry>/<slug>`
+
+### Registry Management
+
+- `skill registry <subcommand>` - Manage registries and invitations
+  - See `skill registry --help` for subcommands
+
+
+
+## Development
+
+- CLI dev mode:
+
+```bash
+cd cli
+npm run dev
+```
+
+- Typecheck:
+
+```bash
+cd cli
+npm run typecheck
+```

package/dist/commands/add.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const addCommand: Command;
+//# sourceMappingURL=add.d.ts.map

package/dist/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,eAAO,MAAM,UAAU,SAsInB,CAAC"}

package/dist/commands/add.js

@@ -0,0 +1,121 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { checkbox } from '@inquirer/prompts';
+import * as config from '../lib/config.js';
+import * as localRegistry from '../lib/local-registry/index.js';
+export const addCommand = new Command('add')
+    .description('Add one or more skills to the project')
+    .argument('[slugs...]', 'Skill slugs to add')
+    .option('-v, --version <constraint>', 'Version constraint (e.g., ">=1.0.0", "^2.0.0")')
+    .option('--no-sync', 'Skip automatic sync after adding')
+    .action(async (slugs, options) => {
+    try {
+        // Check if initialized
+        if (!config.configExists()) {
+            console.log(chalk.red('Error: Not in a skills project.'));
+            console.log(`Run ${chalk.cyan('skills init')} first.`);
+            process.exit(1);
+        }
+        const skillsConfig = config.readConfig();
+        // If no slugs provided, show interactive selection
+        if (!slugs || slugs.length === 0) {
+            const allSkills = localRegistry.listSkills();
+            if (allSkills.length === 0) {
+                console.log(chalk.yellow('No skills available in local cache.'));
+                console.log('');
+                console.log('To add skills, either:');
+                console.log(`  ${chalk.cyan('skills new <slug>')}           Create a new skill`);
+                console.log(`  ${chalk.cyan('skills cache import <path>')}   Import from a file`);
+                return;
+            }
+            // Filter out already added skills
+            const availableSkills = allSkills.filter((skill) => !skillsConfig.skills.find((s) => s.slug === skill.slug));
+            if (availableSkills.length === 0) {
+                console.log(chalk.yellow('All available skills are already added to this project.'));
+                return;
+            }
+            // Show interactive checkbox prompt
+            const selected = await checkbox({
+                message: 'Select skills to add (use spacebar to select, enter to confirm):',
+                choices: availableSkills.map((skill) => ({
+                    name: `${chalk.green(skill.slug)} - ${skill.meta.description || 'No description'}`,
+                    value: skill.slug,
+                })),
+            });
+            if (selected.length === 0) {
+                console.log(chalk.yellow('No skills selected.'));
+                return;
+            }
+            slugs = selected;
+        }
+        const addedSkills = [];
+        for (const slug of slugs) {
+            const spinner = ora(`Adding ${slug}...`).start();
+            try {
+                // Check if skill exists in local registry
+                if (!localRegistry.skillExists(slug)) {
+                    spinner.fail(`Skill '${slug}' not found in local cache.`);
+                    console.log('');
+                    console.log('To add this skill, either:');
+                    console.log(`  ${chalk.cyan(`skills new ${slug}`)}           Create it locally`);
+                    console.log(`  ${chalk.cyan(`skills cache import <path>`)}   Import from a file`);
+                    continue;
+                }
+                // Get skill info from local registry
+                const skillInfo = localRegistry.getSkillInfo(slug);
+                if (!skillInfo) {
+                    spinner.fail(`Could not read skill '${slug}' from cache.`);
+                    continue;
+                }
+                // Check if already added
+                const existing = skillsConfig.skills.find((s) => s.slug === slug);
+                if (existing) {
+                    spinner.warn(`${slug} already added to project`);
+                    continue;
+                }
+                // Resolve version if constraint provided
+                let resolvedVersion = null;
+                if (options.version) {
+                    resolvedVersion = localRegistry.resolveVersion(slug, options.version);
+                    if (!resolvedVersion) {
+                        const availableVersions = localRegistry.getVersionStrings(slug);
+                        spinner.fail(`No cached version of '${slug}' satisfies '${options.version}'.`);
+                        console.log(`  Available versions: ${availableVersions.join(', ')}`);
+                        continue;
+                    }
+                }
+                else {
+                    resolvedVersion = localRegistry.getLatestVersion(slug);
+                }
+                // Add to config
+                const entry = {
+                    slug,
+                };
+                if (options.version) {
+                    entry.version = options.version;
+                }
+                config.addSkill(entry);
+                addedSkills.push(slug);
+                const displayVersion = resolvedVersion || localRegistry.getLatestVersion(slug);
+                spinner.succeed(`Added ${chalk.cyan(slug)} (v${displayVersion})`);
+            }
+            catch (error) {
+                spinner.fail(error instanceof Error ? error.message : String(error));
+            }
+        }
+        // Sync if skills were added
+        if (addedSkills.length > 0 && options.sync !== false) {
+            console.log('');
+            console.log('Running sync...');
+            // Import sync command and run it
+            const { syncCommand } = await import('./sync.js');
+            await syncCommand.parseAsync(['node', 'skills', 'sync']);
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

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

package/dist/commands/bundle.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const bundleCommand: Command;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/commands/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/commands/bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,eAAO,MAAM,aAAa,SA8DtB,CAAC"}

package/dist/commands/bundle.js

@@ -0,0 +1,58 @@
+import { Command } from 'commander';
+import * as nodefs from 'fs';
+import * as path from 'path';
+import chalk from 'chalk';
+import * as config from '../lib/config.js';
+import * as fs from '../lib/fs.js';
+import * as lockfile from '../lib/lockfile.js';
+export const bundleCommand = new Command('bundle')
+    .description('Bundle all or selected skills into a single markdown file')
+    .argument('[slugs...]', 'Skill slugs to bundle (optional, bundles all if not provided)')
+    .option('-o, --output <path>', 'Output file path', 'skills-bundle.md')
+    .action(async (slugs, options) => {
+    try {
+        // Check if initialized
+        if (!config.configExists()) {
+            console.log(chalk.red('Error: Not in a skills project.'));
+            console.log(`Run ${chalk.cyan('skills init')} first.`);
+            process.exit(1);
+        }
+        const skillsToBundle = slugs.length > 0 ? slugs : fs.listLocalSkills();
+        if (skillsToBundle.length === 0) {
+            console.log(chalk.yellow('No skills to bundle.'));
+            return;
+        }
+        const lock = lockfile.readLockfile();
+        const bundleLines = [];
+        for (const slug of skillsToBundle) {
+            const content = fs.readSkillContent(slug);
+            if (!content) {
+                console.log(chalk.yellow(`Skipping ${slug}: not found locally`));
+                continue;
+            }
+            const locked = lock?.skills.find((s) => s.slug === slug);
+            const registry = locked?.registry || 'unknown';
+            const version = locked?.version || 'unknown';
+            // Add separator and skill content
+            bundleLines.push(`<!-- === SKILL: ${slug} (${registry} v${version}) === -->`);
+            bundleLines.push('');
+            bundleLines.push(content.trim());
+            bundleLines.push('');
+            bundleLines.push('');
+        }
+        // Write bundle file
+        const projectRoot = config.findProjectRoot() || process.cwd();
+        const outputPath = path.isAbsolute(options.output)
+            ? options.output
+            : path.join(projectRoot, options.output);
+        const bundleContent = bundleLines.join('\n');
+        nodefs.writeFileSync(outputPath, bundleContent, 'utf-8');
+        const sizeKb = (Buffer.byteLength(bundleContent, 'utf-8') / 1024).toFixed(1);
+        console.log(chalk.green(`Bundled ${skillsToBundle.length} skills into ${chalk.cyan(options.output)} (${sizeKb} KB)`));
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=bundle.js.map

package/dist/commands/bundle.js.map

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

package/dist/commands/config.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const configCommand: Command;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,aAAa,SA4EtB,CAAC"}

package/dist/commands/config.js

@@ -0,0 +1,109 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import * as auth from "../lib/auth.js";
+export const configCommand = new Command("config")
+    .description("Get or set CLI configuration")
+    .argument("<key>", "Configuration key (api_url, web_app_url, editor, install_path)")
+    .argument("[value]", "Value to set (omit to get current value)")
+    .action(async (key, value) => {
+    try {
+        const validKeys = [
+            "api_url",
+            // "api_key",
+            "web_app_url",
+            "editor",
+            "install_path",
+        ];
+        if (!validKeys.includes(key)) {
+            console.log(chalk.red(`Error: Invalid config key '${key}'`));
+            console.log(`Valid keys: ${validKeys.join(", ")}`);
+            process.exit(1);
+        }
+        if (value === undefined) {
+            // Get value
+            let currentValue;
+            switch (key) {
+                case "api_url":
+                    currentValue = auth.getApiUrl();
+                    break;
+                // case 'api_key':
+                //   currentValue = auth.getApiKey();
+                //   break;
+                case "web_app_url":
+                    currentValue = auth.getWebAppUrl();
+                    break;
+                case "editor":
+                    currentValue = auth.getEditor();
+                    break;
+                case "install_path":
+                    currentValue = auth.getDefaultInstallPath();
+                    break;
+            }
+            if (currentValue) {
+                console.log(currentValue);
+            }
+            else {
+                console.log(chalk.gray("(not set)"));
+            }
+        }
+        else {
+            // Set value
+            switch (key) {
+                case "api_url":
+                    auth.setApiUrl(value);
+                    break;
+                case "web_app_url":
+                    auth.setWebAppUrl(value);
+                    break;
+                case "editor":
+                    auth.setEditor(value);
+                    break;
+                case "install_path":
+                    auth.setDefaultInstallPath(value);
+                    break;
+            }
+            console.log(chalk.green(`Set ${key} = ${value}`));
+        }
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+// Add subcommand to show all config
+configCommand
+    .command("show")
+    .description("Show all configuration")
+    .action(() => {
+    const allConfig = auth.getAll();
+    console.log(chalk.bold("CLI Configuration:"));
+    console.log(`  Config file: ${chalk.gray(auth.getConfigPath())}`);
+    console.log("");
+    if (allConfig.api_url) {
+        console.log(`  api_url:      ${allConfig.api_url}`);
+    }
+    if (allConfig.web_app_url) {
+        console.log(`  web_app_url:  ${allConfig.web_app_url}`);
+    }
+    if (allConfig.editor) {
+        console.log(`  editor:       ${allConfig.editor}`);
+    }
+    if (allConfig.install_path) {
+        console.log(`  install_path: ${allConfig.install_path}`);
+    }
+    if (allConfig.access_token) {
+        console.log(`  logged_in:    ${chalk.green("yes")}`);
+    }
+    else {
+        console.log(`  logged_in:    ${chalk.gray("no")}`);
+    }
+});
+// Add logout subcommand
+configCommand
+    .command("logout")
+    .description("Clear authentication tokens")
+    .action(() => {
+    auth.clearTokens();
+    console.log(chalk.green("Logged out successfully."));
+});
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

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

package/dist/commands/delete.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const deleteCommand: Command;
+//# sourceMappingURL=delete.d.ts.map

package/dist/commands/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../src/commands/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,aAAa,SA2DtB,CAAC"}