SkillUse

 ▗▄▄▖▗▖ ▗▖▗▄▄▄▖▗▖   ▗▖   ▗▖ ▗▖ ▗▄▄▖▗▄▄▄▖
▐▌   ▐▌▗▞▘  █  ▐▌   ▐▌   ▐▌ ▐▌▐▌   ▐▌
 ▝▀▚▖▐▛▚▖   █  ▐▌   ▐▌   ▐▌ ▐▌ ▝▀▚▖▐▛▀▀▘
▗▄▄▞▘▐▌ ▐▌▗▄█▄▖▐▙▄▄▖▐▙▄▄▖▝▚▄▞▘▗▄▄▞▘▐▙▄▄▖

A Skills Registry for AI Agents.

SkillUse is a registry for AI agent skills based on GitHub. Discover, install, and publish skills across your teams and coding agents like Claude Code, Cursor, Windsurf, and more.

How It Works

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│            GitHub Repositories (Skill Registries)               │
│   ┌──────────────┐  ┌──────────────┐  ┌──────────────┐          │
│   │ Public Repo  │  │ Company Repo │  │ Personal Repo│          │
│   │ (community)  │  │  (private)   │  │  (private)   │          │
│   └──────┬───────┘  └──────┬───────┘  └──────┬───────┘          │
│          │                 │                 │                  │
│          └─────────────────┼─────────────────┘                  │
│                            ▼                                    │
│                     ┌────────────┐                              │
│                     │  skilluse  │                              │
│                     └─────┬──────┘                              │
│                           │                                     │
│          ┌────────────────┼────────────────┐                    │
│          ▼                ▼                ▼                    │
│   ~/.claude/skills  ~/.cursor/skills  ~/.codex/skills           │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Why Use SkillUse?

For Individuals:

• Reuse your best prompts and workflows across projects
• Share expertise with the community
• Switch between AI agents without rebuilding your skill library

For Teams:

• Standardize workflows and best practices across the organization
• Onboard new members faster with institutional knowledge encoded in skills
• Keep private skills internal while consuming public community skills

Key Features

• Multi-Agent: One CLI for all AI agents, automatic path detection
• Read + Write: Not just install—create and publish your own skills
• GitHub-Based: Use any GitHub repo as a skill registry—public or private

Installation

# npm (recommended)
npm install -g skilluse

# or shell script (macOS/Linux)
curl -fsSL https://skilluse.dev/install.sh | bash

Quick Start

# 1. Add a skill repository
skilluse repo add owner/skill-repo

# 2. Install a skill
skilluse install code-review

Authentication

| Repository Type | Login Required | |-----------------|----------------| | Public repo | No | | Private repo | Yes |

For private repositories:

skilluse login
skilluse repo add mycompany/private-skills

Commands

Status & Auth

skilluse              # Show status
skilluse login        # Authenticate with GitHub
skilluse logout       # Clear credentials

Repository Management

skilluse repo list                 # List repositories
skilluse repo add <owner/repo>     # Add repository
skilluse repo use <owner/repo>     # Set default
skilluse repo skills               # List all skills in current repo
skilluse repo remove <owner/repo>  # Remove repository

Skill Management

skilluse install <skill-name>               # Install from configured repo
skilluse install <github-url>               # Install from GitHub URL
skilluse install <skill-name> -g            # Install globally
skilluse uninstall <skill-name>             # Remove skill
skilluse upgrade [skill-name]               # Upgrade to latest
skilluse list                               # List installed
skilluse list --outdated                    # Check for updates
skilluse publish <skill-name>               # Publish skill to repo

Example with GitHub URL:

skilluse install https://github.com/owner/repo/tree/main/skills/code-review

Multi-Agent Support

skilluse agent                 # Select agent interactively
skilluse agent <name>          # Switch to agent

Supported: claude, cursor, windsurf, codex, copilot, cline, roo, aider, continue

Installation Paths

| Scope | Path | |-------|------| | Local | ./.claude/skills/<skill-name>/ | | Global | ~/.claude/skills/<skill-name>/ |

Security

• Credentials: JSON file with restricted permissions (0600)
• Location: ~/Library/Application Support/skilluse/ (macOS)
• Auth: GitHub App OAuth device flow

Learn More

• Documentation
• Blog
• Skill Format Specification

License

MIT