Проблема фрагментации и решение OpenSkills
Экосистема AI-кодинга сталкивается с проблемой разрозненных форматов инструкций для агентов. Anthropic внедрила систему Agent Skills для Claude Code, позволяющую динамически подгружать специализированные инструменты (например, работу с PDF или Git) через файл SKILL.md. Однако эта система была закрыта для других инструментов. Проект OpenSkills (репозиторий numman-ali/openskills) решает эту проблему, предоставляя универсальный загрузчик, который генерирует совместимый XML-формат <available_skills> для любого агента, способного читать файл AGENTS.md.
Техническая реализация и совместимость
OpenSkills не эмулирует Claude Code, а выступает в роли «универсального установщика». Он парсит репозитории навыков (например, anthropics/skills с GitHub) и преобразует их в формат, понятный целевому агенту. Ключевая особенность — progressive disclosure (прогрессивное раскрытие): навыки загружаются только по запросу, что сохраняет контекстное окно модели чистым и эффективным.
Система поддерживает установку как локально (в папку проекта), так и глобально, а также работает с приватными Git-репозиториями. Для настройки совместимости с несколькими агентами в одном проекте предусмотрен флаг --universal, направляющий навыки в папку ./.agent/skills/, чтобы избежать конфликтов с плагином Claude.
Сравнение подходов: Claude Code vs OpenSkills
Ниже приведена таблица, демонстрирующая, как OpenSkills сохраняет совместимость с оригинальной спецификацией Anthropic, адаптируя её под сторонние инструменты.
| Аспект | Claude Code (Оригинал) | OpenSkills (Универсальный) |
|---|---|---|
| Формат промпта | XML блок <available_skills> |
Тот же XML, генерируемый в AGENTS.md |
| Хранение навыков | .claude/skills/ |
.claude/skills/ (по умолчанию) или ./.agent/skills/ |
| Механизм вызова | Встроенный инструмент Skill("name") |
Вызов через CLI: npx openskills read <name> |
| Маркетплейс | Anthropic Marketplace | GitHub (репозитории, например, anthropics/skills) |
| Требования к среде | Только Claude Code | Node.js 20.6+, Git, любой агент с поддержкой AGENTS.md |
Ключевые возможности и команды
Управление навыками осуществляется через единую CLI-утилиту. Основные сценарии использования включают:
- Установка:
npx openskills install anthropics/skillsдля загрузки набора от Anthropic илиnpx openskills install ./local-pathдля локальных разработок. - Синхронизация: Команда
npx openskills syncобновляет файлAGENTS.md, добавляя актуальный список доступных навыков в секциюSKILLS_TABLE_START/SKILLS_TABLE_END. - Чтение: Агенты используют
npx openskills read <skill-name>для получения инструкций и ресурсов навыка на лету. - Обновление: Поддержка
npx openskills updateпозволяет обновлять навыки, установленные из Git-репозиториев, без полной переустановки.
Почему это важно для разработчиков
OpenSkills отделяет концепцию «навыков» (статичные инструкции и ресурсы) от «MCP-инструментов» (динамические API). Это позволяет создавать богатые, документированные наборы инструкций для AI-агентов, которые работают в Cursor, Windsurf, Aider и Codex одинаково эффективно. Проект использует лицензию Apache 2.0 и требует только Node.js 20.6+, что делает его легковесным и безопасным дополнением к рабочему процессу разработки.
Источник: Github ↗