# agent-skill-loader MCP server

> Dynamically loads Claude Code skills into AI agents as MCP prompts and tools through automatic directory scanning.

- Repository: https://github.com/back1ply/agent-skill-loader
- Page: https://hostedmcp.org/servers/back1ply/agent-skill-loader
- Transport: stdio
- Stars: 15
- License: MIT
- Latest version: 1.2.1

## Install

### Claude Code

```sh
claude mcp add agent-skill-loader -- npx -y agent-skill-loader
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "agent-skill-loader": {
      "command": "npx",
      "args": [
        "-y",
        "agent-skill-loader"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "agent-skill-loader": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "agent-skill-loader"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"agent-skill-loader","type":"stdio","command":"npx","args":["-y","agent-skill-loader"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "agent-skill-loader": {
      "command": "npx",
      "args": [
        "-y",
        "agent-skill-loader"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add agent-skill-loader -- npx -y agent-skill-loader
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.agent-skill-loader]
command = "npx"
args = ["-y", "agent-skill-loader"]
```

### Gemini CLI

```sh
gemini mcp add -s user agent-skill-loader npx -- -y agent-skill-loader
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "agent-skill-loader": {
      "command": "npx",
      "args": [
        "-y",
        "agent-skill-loader"
      ]
    }
  }
}
```

## Tools (5)

- `list_skills`: Returns a JSON list of all available skills with their names, descriptions, and source directories. Use this to discover what skills are available before reading or installing them. (read-only)
- `read_skill`: Fetches and returns the full SKILL.md content for a specific skill. The content includes instructions and context that can be used to learn the skill's capabilities. (read-only)
- `install_skill`: Copies an entire skill directory (including SKILL.md and any supporting files) to the target workspace. By default, installs to .agent/skills/<skill_name> in the current working directory.
- `manage_search_paths`: Add, remove, or list dynamic skill search paths without restarting the server. Persists to skill-paths.json in the workspace root.
- `debug_info`: Returns diagnostic information about server configuration, search paths, and any warnings from the last scan. Use this when skills aren't being found or to verify configuration. (read-only)

## FAQ

### How do I add new skills to the server?

You can add a new skill by placing a folder containing a SKILL.md file into one of the configured skill directories.

### Can I manage skill directories without editing configuration files manually?

Yes, you can use the manage_search_paths tool to add, remove, or list skill directories at runtime.
