Agent Skill Loader 🧠

Agent Skill Loader — это сервер протокола Model Context Protocol (MCP), который служит мостом между вашей статической библиотекой навыков Claude Code и динамическими AI-агентами (такими как Claude Desktop, Cursor или любой другой MCP-клиент).

Он предоставляет навыки как в виде MCP-промптов (команды с косой чертой, не требующие вызова инструментов), так и в виде MCP-инструментов (для программного использования). Навыки автоматически обнаруживаются в настроенных директориях и остаются активными — добавьте новый SKILL.md, и клиент получит уведомление автоматически.

🚀 Функции

• MCP-промпты: Навыки отображаются как команды с косой чертой в клиентах. Для их внедрения не требуется вызов инструментов.

• Живые обновления: Уведомление listChanged срабатывает при добавлении или удалении навыков (через файловый наблюдатель).

• Обнаружение: list_skills — сканирует настроенные директории навыков с опциональным фильтром поиска.

• Динамическое обучение: read_skill — извлекает содержимое SKILL.md.

• Постоянство: install_skill — копирует навык в ваш проект на постоянной основе.

• Конфигурация: manage_search_paths — добавление/удаление директорий навыков во время выполнения.

• Устранение неполадок: debug_info — диагностика конфигурации и проблем с путями.

🛠️ Установка

Предварительные требования

• Node.js >= 18

Вариант А: Установка из npm (рекомендуется)

npm install -g agent-skill-loader

Затем зарегистрируйте в .mcp.json:

"agent-skill-loader": {
  "command": "agent-skill-loader"
}

Вариант Б: Сборка из исходного кода

git clone https://github.com/back1ply/agent-skill-loader.git
cd agent-skill-loader
npm install
npm run build

Затем зарегистрируйте в .mcp.json:

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

📂 Конфигурация

Сервер автоматически определяет рабочую область и собирает пути к навыкам из:

1. По умолчанию: %USERPROFILE%\.claude\plugins\cache (стандартное расположение)

2. Динамическая конфигурация: skill-paths.json (находится в корне проекта)

Переменные окружения

Управление динамическими путями

Вам не нужно вручную редактировать файлы конфигурации. Используйте инструмент для управления путями во время выполнения:

• Добавить: manage_search_paths(operation="add", path="F:\\My\\Deep\\Skills")

• Удалить: manage_search_paths(operation="remove", path="...")

• Список: manage_search_paths(operation="list") создает/обновляет skill-paths.json.

🤖 Использование

MCP-промпты (команды с косой чертой)

Если ваш клиент поддерживает MCP-промпты (Claude Desktop, Cursor и т.д.), навыки автоматически появятся как команды с косой чертой. Выберите навык из меню команд, чтобы внедрить его содержимое напрямую — вызовы инструментов не требуются.

Инструменты

Агент имеет доступ к пяти инструментам:

• list_skills(query?): Возвращает JSON-список доступных навыков. Опциональный query фильтрует по подстроке имени/описания (без учета регистра).

• read_skill(skill_name): Возвращает инструкции в формате markdown для навыка.

• install_skill(skill_name, target_path?): Копирует папку навыка в .agent/skills/<name>. В целях безопасности target_path должен находиться внутри текущей рабочей области.

• manage_search_paths(operation, path?): Добавление, удаление или перечисление путей поиска навыков.

• debug_info(): Возвращает диагностическую информацию (пути, статус, предупреждения).

Пример промпта агента

"Мне нужно написать меру DAX, но я не уверен в лучших практиках."

Агент автоматически вызовет list_skills, найдет writing-dax-measures, вызовет read_skill и ответит, используя экспертные знания. Или пользователь может вызвать навык напрямую как команду с косой чертой.

🔧 Устранение неполадок

Если навыки не обнаруживаются, используйте debug_info(), чтобы увидеть:

• search_paths: Какие директории сканируются

• path_status: Существует ли каждый путь и доступен ли он для чтения

• warnings: Любые ошибки, возникшие во время сканирования (отказ в доступе, пустые файлы и т.д.)

Пример вывода:

{
  "workspace_root": "C:/projects/agent-skill-loader",
  "search_paths": {
    "base": ["C:/Users/pc/.claude/plugins/cache"],
    "dynamic": ["F:/My/Skills"],
    "effective": ["C:/Users/pc/.claude/plugins/cache", "F:/My/Skills"]
  },
  "path_status": [
    { "path": "C:/Users/pc/.claude/plugins/cache", "exists": true, "readable": true },
    { "path": "F:/My/Skills", "exists": false, "readable": false }
  ],
  "skills_found": 12,
  "warnings": [
    { "path": "F:/My/Skills", "reason": "Directory does not exist" }
  ]
}

📦 Структура проекта

• src/index.ts: Основная логика сервера (инструменты + промпты + наблюдатель).

• src/utils.ts: Сканирование навыков, извлечение описаний, помощники промптов, debounce.

• build/: Скомпилированный JavaScript.

• package.json: Зависимости (@modelcontextprotocol/sdk, chokidar, zod).

🤝 Участие в разработке

Чтобы добавить новые навыки, добавьте папку с файлом SKILL.md в одну из отслеживаемых директорий. Сервер автоматически подхватит их и отправит уведомление listChanged — перезапуск не требуется.