agent-skill-loader

# Agent Skill Loader 🧠

[![npm version](https://img.shields.io/npm/v/agent-skill-loader)](https://www.npmjs.com/package/agent-skill-loader)
[![MCP Registry](https://img.shields.io/badge/MCP-Registry-green)](https://registry.modelcontextprotocol.io)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.4-blue)](https://www.typescriptlang.org/)
[![MCP](https://img.shields.io/badge/MCP-Compatible-purple)](https://modelcontextprotocol.io)

**Agent Skill Loader** is a Model Context Protocol (MCP) server that acts as a bridge between your static Claude Code Skills library and dynamic AI agents (like Antigravity, Claude Desktop, or Cursor).

It allows agents to "learn" skills on demand without requiring you to manually copy files into every project.

## 🚀 Features

*   **Discovery**: `list_skills` - Scans your configured skill directories.
*   **Dynamic Learning**: `read_skill` - Fetches the `SKILL.md` content for the agent to read.
*   **Persistence**: `install_skill` - Copies the skill permanently to your project if needed.
*   **Configuration**: `manage_search_paths` - Add/remove skill directories at runtime.
*   **Troubleshooting**: `debug_info` - Diagnose configuration and path issues.

## 🛠️ Setup

### Prerequisites
- Node.js >= 18

### Option A: Install from npm (Recommended)
```bash
npm install -g agent-skill-loader
```

Then register in `.mcp.json`:
```json
"agent-skill-loader": {
  "command": "agent-skill-loader"
}
```

### Option B: Build from Source
```bash
git clone https://github.com/back1ply/agent-skill-loader.git
cd agent-skill-loader
npm install
npm run build
```

Then register in `.mcp.json`:
```json
"agent-skill-loader": {
  "command": "node",
  "args": ["<path-to-repo>/build/index.js"]
}
```

## 📂 Configuration

The server automatically detects