ooai-skills

Multi-agent skills registry: ingest, cache, and distribute SKILL.md skills across Claude Code, Deep Agents, Codex, Cursor, Copilot, Gemini, Windsurf, and more.

Features

• 90+ curated repos across 18 categories — official vendor skills, community mega-packs, cursor rules, MCP servers
• Direct install from GitHub — ooai-skills install anthropics/skills (no MinIO needed)
• MinIO/S3 registry — ingest, cache, and pull with SHA256 deduplication
• Multi-target output — writes to ~/.agents/skills/ AND ~/.claude/skills/ by default
• Handles everything — skills, commands, agents, rules (routes to correct directories automatically)
• MCP server — exposes skill browsing as MCP tools for any compatible agent
• Full scaffold — ooai-skills init creates dirs for Claude Code, Deep Agents, Codex, Gemini, Cursor, and Copilot
• Comprehensive linting — validates name format, description length, token budget, unknown frontmatter keys
• Selective pull — by name (--name deploy) or category (--category "Cursor rules")

Architecture

GitHub repos (90+ curated)
       │
       ├──── ooai-skills install ──── Direct to local (no MinIO)
       │
       └──── ooai-skills ingest ──── MinIO/S3 registry
                                         │
                                    ooai-skills pull
                                         │
                          ┌──────────────┼──────────────┐
                          ▼              ▼              ▼
                   ~/.agents/skills  ~/.claude/skills  (extra targets)
                   (Deep Agents,     (Claude Code)
                    Codex)

Quick Start (no MinIO)

# Install
pip install -e .

# Scaffold project structure
ooai-skills init .

# Install skills from GitHub
ooai-skills install anthropics/skills
ooai-skills install vercel-labs/agent-skills
ooai-skills install PatrickJS/awesome-cursorrules --what rules

# Check what's installed
ooai-skills status

# Search
ooai-skills local find deploy

Quick Start (with MinIO)

cp .env.example .env      # Edit MinIO credentials
./scripts/bootstrap_minio.sh

# Ingest curated repos
./scripts/ingest_curated_zips.sh "Core general skill catalogs"

# Pull to local
ooai-skills pull --all

# Search the remote registry
ooai-skills remote search kubernetes

CLI Reference

Setup & Scaffold

Install (direct from GitHub)

Registry (MinIO)

Browse

MCP Server

ooai-skills mcp-serve   # Start stdio MCP server

Or configure in .mcp.json:

{
  "mcpServers": {
    "ooai-skills": {
      "command": "python",
      "args": ["-m", "ooai_skills.mcp_server"]
    }
  }
}

Exposes tools: list_skills, find_skills, get_skill_info, read_skill.

Curated Catalog

90+ repos across 18 categories:

Browse the full catalog: ooai-skills curated list

Supported Agents

Configuration

Environment variables (or .env file):

Testing

pdm install
pdm run pytest -v          # Run all tests
pdm run ruff check src/    # Lint

Documentation

• Command Reference
• End-to-End Guide
• Concepts
• MinIO Setup
• Research Notes — ecosystem knowledge base

License

MIT