Skop - Skill Manager for AI Coding Agents

SKill On claude Plugin marketplace

Skop is a CLI tool designed to manage skills for various AI coding agents, including Codex, Opencode, and Antigravity. It allows you to easily install and update skills defined in a Claude Plugin Marketplace.

Features

• Multi-Agent Support: Install skills for Codex (.codex/skills), Opencode (.opencode/skills), and Antigravity (.agent/skills).
• Marketplace Integration: Consumes marketplace.json compatible with the Claude Plugin Marketplace specification.
• Smart Updates: Automatically checks versioning to update existing skills or install new ones.
• Flexible Sources: Supports skills hosted in the marketplace repository (relative paths) or external repositories (GitHub, Git URLs).

Installation

Ensure you have Rust and Cargo installed.

cargo install skop

Usage

Add a Marketplace

To add skills from a marketplace, Skop prompts you to select the targets and skills interactively:

skop add <OWNER/REPO>

• OWNER/REPO: The GitHub repository containing the marketplace.json file (e.g., owner/my-marketplace).
• Options:
  • --dry-run: Print what would be installed without writing files.
  • --verbose: Enable verbose logging.
  • --max-depth <N>: Maximum recursion depth when resolving nested marketplaces (default: 1).

For non-interactive installs of a single skill:

skop add <SKILL>@<OWNER/REPO> --target <codex|opencode|antigravity|all>

Remove Skills (Interactive)

skop remove

• Lists installed skills across all supported agent directories as <skill name> (<agent>).
• Use arrow keys to move, space to toggle selection.
• Press Enter, then confirm with y to remove.
• Select all to toggle every skill at once.

List Skills

skop list

• Prints installed skills as <skill name> (<target>).

Help

skop --help
skop add --help
skop remove --help
skop list --help

Quick reference:

# Interactive marketplace install
skop add <OWNER/REPO>

# Non-interactive single skill install
skop add <SKILL>@<OWNER/REPO> --target <codex|opencode|antigravity|all>

# Skip target UI while keeping interactive skill selection
skop add <OWNER/REPO> --target <codex|opencode|antigravity|all>

Examples

Install skills with interactive target/skill selection:

skop add my-org/coding-skills

Marketplace Format

Skop expects the remote repository to contain a .claude-plugin/marketplace.json file following the Claude Plugin Marketplace schema.

Example marketplace.json:

{
  "name": "my-skills",
  "owner": {
    "name": "My Team"
  },
  "plugins": [
    {
      "name": "lint-checker",
      "source": "./skills/lint-checker",
      "version": "1.0.0",
      "description": "A skill to run linters"
    },
    {
      "name": "external-tool",
      "source": {
        "source": "github",
        "repo": "another-owner/tool-repo"
      },
      "version": "2.1.0"
    }
  ]
}

How it works

1. Fetch: Skop retrieves the marketplace.json from the specified GitHub repository.
2. Resolve: For each plugin, it determines the source repository.
   • If the source is a relative path (e.g., ./skills/foo), it defaults to cloning the marketplace repository itself.
   • Override: If a plugin entry has a repository field, it will use that URL as the base for relative path sources.
   • If the source is an explicit object (GitHub/URL), it uses that definition.
   • If metadata.pluginRoot is set in the marketplace, relative paths (without ./) are resolved against it.
3. Check: It compares the version in marketplace.json with the locally stored metadata.
4. Install/Update: If the plugin is new or has a higher version, Skop clones the repository (shallow clone), discovers skill folders (directories containing SKILL.md), and copies them into the agent's skill directory. It stores install metadata in .skop/<plugin>.json.
   • Skill discovery prefers skills or agents paths in the plugin entry when provided, otherwise it falls back to the conventional skills/ layout.
   • Dry-run mode prints detected skills, marketplace presence, and recursion steps without writing files.
   • Interactive mode lets you choose which targets and skills to install.

License

MIT