Skills Manager CLI

A CLI for AI agents to organize, access, and share skills — from any device, with any agent.

Skills Manager gives your AI agents a single, unified way to find and use every skill — whether it's one you've built yourself or one published in a git repository. Build your own registry, back it with Google Drive, GitHub, or local storage, and every skill becomes instantly searchable and installable across all your agents and devices. When you improve a skill, a single command pushes your changes back to the backend — no manual syncing, no copy-pasting between machines.

No more scattered files. No more per-agent setup. One CLI to manage your skills, one index to search them, and one cache to keep them in sync — wherever you work. Skills Manager even ships with its own skill, so your agent already knows how to use it — just ask.

Why Skills Manager?

• Unified skill library — one searchable index across all your skills, wherever they're stored
• Cross-agent — install any skill into Claude, Cursor, Windsurf, Copilot, Gemini, and more
• Backend-agnostic — store in Google Drive, GitHub, Dropbox, AWS S3, or local filesystem
• Sync across devices — skills follow you, not your machine
• No duplication — cached once locally, symlinked into each agent's directory
• Seamless updates — edit a skill locally and push changes back to your backend with a single command
• Agent-native — ships with a built-in skill that teaches your agent how to use Skills Manager, so you never need to memorize commands

Supported Agents

claude · codex · cursor · windsurf · copilot · gemini · roo · openclaw · agents

Quick Start

1. Install

npm install -g @skillsmanager/cli

2. Install the skillsmanager skill (lets your agent drive Skills Manager)

sm install

This installs the bundled skillsmanager skill into all detected agents so your AI assistant can manage skills on your behalf.

3. Connect a remote backend (optional)

Skills Manager supports Google Drive and GitHub as remote backends.

Google Drive:

1. Go to Google Cloud Console and create a project
2. Enable the Google Drive API for that project
3. Create OAuth 2.0 credentials (Desktop app type)
4. Download credentials.json and save it to ~/.skillsmanager/credentials.json

sm setup google   # walks you through OAuth
sm refresh        # discovers collections in your Drive

GitHub:

sm setup github   # checks gh CLI and authenticates
sm refresh        # discovers collections in your repos

Commands

| Command | Description | |---|---| | sm status | Show login status and identity for each backend | | sm install | Install the skillsmanager skill to all agents | | sm uninstall | Remove the skillsmanager skill from agent directories | | sm list | List all available skills | | sm search <query> | Search skills by name or description | | sm install <name> --agent <agent> | Download and install a skill for an agent | | sm uninstall <name> --agent <agent> | Remove a skill's symlink (cache untouched) | | sm add <path> | Upload a local skill to a collection | | sm add --remote-path <path> --name <n> --description <d> | Register a remote skill path (no upload) | | sm update <path> | Push local changes back to remote storage | | sm refresh | Re-discover collections from remote | | sm skill delete <name> | Delete a skill from a collection | | sm collection create [name] --backend github --repo <owner/repo> | Create a collection in a GitHub repo | | sm collection create [name] --skills-repo <owner/repo> | Create a collection with skills in a separate GitHub repo | | sm registry create | Create a new local registry | | sm registry list | Show all registries and their collections | | sm registry discover | Search a backend for registries owned by the current user | | sm registry add-collection <name> | Add a collection reference to the registry | | sm registry remove-collection <name> | Remove a collection reference from the registry | | sm registry push --backend gdrive | Push local registry to Google Drive | | sm registry push --backend github --repo <owner/repo> | Push local registry to GitHub | | sm setup google | One-time Google Drive setup | | sm setup github | One-time GitHub setup (checks gh CLI and authenticates) | | sm logout google | Clear Google OAuth session | | sm logout github | Log out of GitHub |

Local Development

git clone https://github.com/talktoajayprakash/skillsmanager.git
cd skillsmanager
npm install
npm run build       # compiles TypeScript to dist/
npm link            # makes `sm` available globally from source

Run tests:

npm test

To run without installing globally:

node dist/index.js <command>

How it works

Skills Manager organizes skills in a three-layer hierarchy — registry → collections → skills — where each layer can live on a different storage backend:

graph TD
    R["<b>Registry</b><br/>SKILLS_REGISTRY.yaml"] --> CA["<b>Collection A</b><br/><i>local</i>"]
    R --> CB["<b>Collection B</b><br/><i>gdrive</i>"]
    R --> CC["<b>Collection C</b><br/><i>github</i>"]

    CA --> S1["code-review<br/>SKILL.md"]
    CA --> S2["write-tests<br/>SKILL.md"]
    CB --> S3["summarize-pr<br/>SKILL.md"]
    CC --> S4["lint-fix<br/>SKILL.md"]

    style R fill:#4a90d9,color:#fff,stroke:#357abd
    style CA fill:#6ab04c,color:#fff,stroke:#4e8a38
    style CB fill:#6ab04c,color:#fff,stroke:#4e8a38
    style CC fill:#6ab04c,color:#fff,stroke:#4e8a38
    style S1 fill:#f6e58d,stroke:#d4b702
    style S2 fill:#f6e58d,stroke:#d4b702
    style S3 fill:#f6e58d,stroke:#d4b702
    style S4 fill:#f6e58d,stroke:#d4b702

When a skill is installed, it is downloaded once to a local cache and symlinked into each agent's skills directory — one copy on disk, many agents:

graph TD
    B["<b>Storage Backend</b><br/>local / gdrive / github"] -->|download| C["<b>Local Cache</b><br/>~/.skillsmanager/cache/&lt;uuid&gt;/skill/"]
    C -->|symlink| A1["~/.claude/skills/skill"]
    C -->|symlink| A2["~/.cursor/skills/skill"]
    C -->|symlink| A3["~/.gemini/skills/skill"]

    style B fill:#4a90d9,color:#fff,stroke:#357abd
    style C fill:#6ab04c,color:#fff,stroke:#4e8a38
    style A1 fill:#f6e58d,stroke:#d4b702
    style A2 fill:#f6e58d,stroke:#d4b702
    style A3 fill:#f6e58d,stroke:#d4b702

Registry format

Skills are indexed by a SKILLS_REGISTRY.yaml file inside any collection folder (local, Google Drive, or GitHub repo):

name: my-skills
owner: [email protected]
skills:
  - name: code-review
    path: code-review/
    description: Reviews code for bugs, style, and security issues

Each skill is a directory with a SKILL.md file:

---
name: code-review
description: Reviews code for bugs, style, and security issues
---

... skill instructions ...

Skills Manager auto-discovers any SKILLS_REGISTRY.yaml across all configured backends on refresh.

Contributing

See CONTRIBUTING.md — PRs welcome.

Security

See SECURITY.md for how to report vulnerabilities.

License

Apache 2.0