Getting Started

What is SkillRepo?

SkillRepo is a registry for AI agent skills built on the open agent-skills standard. It provides a single source of truth where teams can publish, version, and manage the skills that power their AI coding assistants.

Your IDE connects directly to the registry API so agents always receive the latest version of every skill -- no manual syncing, no stale files on disk.

Creating an Account

Head to Sign up and create an account with your email or sign in with GitHub. The free tier includes 5 private skills and 1,000 MCP calls per day -- plenty for getting started.

Generating an Access Key

After signing in, navigate to Settings → Access Keys in the dashboard. Click Create Key, give it a descriptive name (e.g. “cursor-work-laptop”), and copy the generated key.

You can have multiple keys active at the same time, one per machine or environment, and revoke individual keys without affecting others.

Connecting Your IDE

SkillRepo exposes an MCP (Model Context Protocol) server that any compatible IDE can connect to over HTTP. No local process or CLI needed — just a URL and your access key.

claude mcp add --transport http skillrepo \
  https://skillrepo.dev/api/mcp \
  --header "Authorization: Bearer sk_live_your_access_key_here"

{
  "mcpServers": {
    "skillrepo": {
      "url": "https://skillrepo.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_access_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "skillrepo": {
      "serverUrl": "https://skillrepo.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_access_key_here"
      }
    }
  }
}

The skillrepo CLI

Prefer the terminal? The skillrepo CLI automates everything on this page in a single command, and adds seven commands for managing your library from the shell: init, update, get, add, remove, list, and search.

npx skillrepo init

# Pull the latest versions of every skill in your library
skillrepo update

# Add a skill to your library and pull it locally
skillrepo add @alice/pdf-tools

# See what's in your library
skillrepo list

# Search the public registry
skillrepo search "kubernetes"

# Fetch a single skill without modifying your library
skillrepo get @alice/pdf-tools

# Remove a skill from your library
skillrepo remove @alice/pdf-tools

SKILLREPO_ACCESS_KEY=sk_live_... \
npx skillrepo init --yes --ide claude

Browsing and Discovering Skills

There are two ways to find skills:

// Your agent calls these MCP tools:
get_skill({ owner: "acme", name: "code-review" })        // Metadata
get_skill_content({ owner: "acme", name: "code-review" }) // Full instructions
get_skill_file({ owner: "acme", name: "code-review", path: "references/guide.md" })

Understanding Skill Structure

Every skill is defined by a SKILL.md file that combines YAML frontmatter with markdown instructions. Here is a minimal example:

---
name: code-review
description: >
  Review code for bugs, security issues,
  and best practices.
version: 1.0.0
license: MIT
compatibility:
  - cursor
  - claude-code
  - jetbrains-ai
metadata:
  category: development
  tags:
    - code-quality
    - review
allowed-tools:
  - Read
  - Grep
  - Glob
---

# Code Review

You are an expert code reviewer. When activated,
review the provided code for:

1. **Bugs** - logic errors, off-by-one, null refs
2. **Security** - injection, auth issues, secrets
3. **Best practices** - naming, structure, DRY

Provide clear, actionable feedback with code
examples for each finding.