OpenSkills — Дайте вашим агентам навыки

English | 中文

Рантайм, совместимый с Claude Skills, с двойным сандбоксингом: нативное выполнение (macOS seatbelt + Linux Landlock) для Python и shell-скриптов (основной режим), плюс экспериментальный WASM-сандбокс для кросс-платформенной безопасности. OpenSkills реализует спецификацию Claude Code Agent Skills, предоставляя безопасный и гибкий рантайм для выполнения скиллов в любом агентном фреймворке.

Философия

OpenSkills синтаксически на 100% совместим с Claude Skills: любой скилл, следующий формату Claude Skills (SKILL.md с YAML frontmatter), будет работать с OpenSkills. Уникальность OpenSkills — в подходе двойного сандбоксинга:

• Нативный сандбокс (основной) для Python и shell-скриптов через изоляцию на уровне ОС (macOS seatbelt + Linux Landlock) — готов к продакшену, полностью поддерживается
• WASM/WASI-сандбокс (экспериментальный) для кросс-платформенной безопасности и согласованности — доступен для ранних пользователей

Основная модель выполнения: нативные Python и shell-скрипты через изоляцию на уровне ОС (macOS seatbelt и Linux Landlock). Это рекомендуемый, готовый к продакшену подход, работающий со всей экосистемой Python и нативными инструментами.

Экспериментальная поддержка WASM: WASM-сандбокс доступен для разработчиков, желающих исследовать детерминированное кросс-платформенное выполнение, но не является обязательным для использования OpenSkills. Большинство скиллов отлично работают с нативными скриптами.

OpenSkills может быть интегрирован в любой агентный фреймворк (LangChain, Vercel AI SDK, собственные фреймворки), предоставляя агентам доступ к Claude-совместимым скиллам.

Основные принципы проектирования

1. 100% синтаксическая совместимость: OpenSkills читает и выполняет скиллы в том же формате SKILL.md, что и Claude Skills. Скиллы можно использовать в Claude Code и OpenSkills без изменений.

2. Архитектура двойного сандбокса: OpenSkills сочетает нативный сандбокс на уровне ОС (основной) с экспериментальным WASM/WASI 0.3:

   • Нативный сандбокс (основной): выполнение Python и shell-скриптов с изоляцией на уровне ОС (macOS seatbelt + Linux Landlock) — готов к продакшену, полная поддержка экосистемы
   • WASM/WASI (экспериментальный): кросс-платформенная безопасность, разрешения на основе возможностей, безопасность памяти, детерминированное выполнение — доступен для ранних пользователей
   • Автоматическое определение: рантайм автоматически выбирает подходящий сандбокс в зависимости от типа скилла
   • Приоритет нативного выполнения: большинство скиллов используют нативные скрипты; WASM опционален для специфических сценариев

3. Нативные скрипты в приоритете: OpenSkills отдаёт предпочтение нативному выполнению Python и shell-скриптов, обеспечивающему полный доступ к экосистеме Python и нативным инструментам. Компиляция в WASM доступна как экспериментальная опция для случаев, требующих кросс-платформенного детерминизма.

Целевые сценарии использования

OpenSkills предназначен для любого агентного фреймворка, которому нужны Claude-совместимые скиллы:

• Интеграция с агентными фреймворками: работает с LangChain, Vercel AI SDK, собственными фреймворками или любой системой, которой нужны инструментоподобные возможности
• Корпоративные агенты: внутренние скиллы, разработанные доверенными разработчиками
• Нативные скрипты: основная модель выполнения с использованием Python и shell-скриптов с изоляцией на уровне ОС
• Кросс-платформенный нативный режим: macOS seatbelt + Linux Landlock (оба готовы к продакшену)
• Экспериментальный WASM: опциональное WASM-выполнение для специфических сценариев, требующих детерминизма
• Безопасность и аудитируемость: оба метода сандбоксинга обеспечивают строгую изоляцию и журналирование аудита

Рекомендуемый подход: используйте нативные Python и shell-скрипты для большинства скиллов. WASM доступен для экспериментальных сценариев, но не является обязательным.

Ограничения

Текущие ограничения

1. Область применения нативных скриптов:

   • Нативные Python и shell-скрипты поддерживаются на macOS (seatbelt) и Linux (Landlock) — оба готовы к продакшену
   • На других платформах следует использовать экспериментальное WASM-выполнение

2. Поддержка WASM (экспериментальная):

   • WASM-сандбокс является экспериментальным и не является основным методом выполнения
   • Требуется процесс сборки: JavaScript/TypeScript-скиллы должны быть скомпилированы в WASM-компоненты перед выполнением
   • Ограниченная поддержка нативных библиотек: нативные Python-пакеты, shell-инструменты и т.д. не работают в WASM
   • Требуется совместимость с WASI: код должен использовать WASI API, а не нативные API ОС

Рекомендация: используйте нативные Python и shell-скрипты для продакшен-скиллов. WASM доступен для экспериментальных сценариев, но не является обязательным.

Дорожная карта

OpenSkills будет развиваться, устраняя ограничения при сохранении приоритета нативного выполнения:

1. Улучшение нативного сандбоксинга: продолжение совершенствования покрытия политик Linux Landlock и macOS seatbelt, а также диагностики.

2. Улучшения WASM (экспериментальные): продолжение разработки поддержки WASM для специфических сценариев, требующих детерминизма и кросс-платформенной согласованности.

3. Улучшенный инструментарий: более качественные инструменты разработки и шаблоны как для нативных скриптов, так и для компиляции в WASM.

Возможности

• ✅ 100% совместимость с Claude Skills: полная поддержка формата SKILL.md
• 🔒 Архитектура двойного сандбокса: нативный (macOS seatbelt + Linux Landlock) + экспериментальный WASM/WASI 0.3
• 🧰 Поддержка нативных скриптов: выполнение Python и shell-скриптов с изоляцией на уровне ОС на macOS и Linux
• 🤖 Любой агентный фреймворк: интеграция с LangChain, Vercel AI SDK или собственными фреймворками
• 🚀 Готовые инструменты: готовые к использованию определения инструментов для TS/Python (~200 строк меньше кода)
• 📊 Прогрессивное раскрытие: эффективная многоуровневая загрузка (метаданные → инструкции → ресурсы)
• 🔌 Мультиязыковые биндинги: ядро на Rust с биндингами для TypeScript и Python
• 🛡️ Безопасность на основе возможностей: детализированные разрешения через нативный сандбокс ОС (и WASI для экспериментального WASM)
• 🏗️ Инструмент сборки: openskills build для компиляции TS/JS в WASM-компоненты (экспериментально)
• 🌐 Кросс-платформенный нативный режим: macOS seatbelt + Linux Landlock (оба готовы к продакшену)
• 📁 Управление рабочим пространством