graph-of-skills: Instructions file for Claude Code

Graph of Skills — Claude Code Integration

GoS ships with a built-in MCP server that gives Claude Code direct access to the skill graph — search, retrieve, explore, and manage skills without leaving the conversation.

Setup

Prerequisites

1. Install dependencies:

   uv sync
   

2. Configure API keys — copy .env.example to .env and fill in your embedding provider (OpenAI, Gemini, or Azure):

   cp .env.example .env
   # Edit .env: set OPENAI_API_KEY or GEMINI_API_KEY
   

3. Get a workspace — build from source for the current typed-directed constructor. Downloaded *_v1 workspaces are legacy reproduction artifacts and are rejected because their undirected edges cannot be repaired safely:

   # Option A: Download prebuilt workspaces
   ./scripts/download_data.sh --workspace
   
   # Option B: Build locally (needs embedding API)
   ./scripts/download_data.sh --skillsets
   uv run gos index data/skillsets/skills_200 \
     --workspace data/gos_workspace/skills_200_v1 --clear
   

Auto-Discovery (Recommended)

The .mcp.json at the project root auto-registers the MCP server. Open the project directory in Claude Code — the graph-of-skills server is immediately available, no extra steps.

Verify with:

claude mcp list

You should see graph-of-skills in the output.

Manual Registration

If auto-discovery doesn't work (e.g. you're working from a different directory), register manually:

# Basic registration
claude mcp add graph-of-skills -- uv run --directory /path/to/graph-of-skills gos-claude

# With an explicit workspace
claude mcp add graph-of-skills -- uv run --directory /path/to/graph-of-skills gos-claude \
  --workspace /path/to/graph-of-skills/data/gos_workspace/skills_200_v1

Switching Workspaces

The default workspace is set in .mcp.json. To use a different skill library size, edit the --workspace argument:

// .mcp.json
{
  "mcpServers": {
    "graph-of-skills": {
      "command": "uv",
      "args": ["run", "--directory", ".", "gos-claude",
               "--workspace", "data/gos_workspace/skills_2000_v1"]
    }
  }
}