Stof — плагин

Плагин и скилл учат агента писать документы Stof: JSON с функциями, типами и тестами, которые выполняются в песочнице.

  • 64 ★ репозитория
  • Последний коммит
  • Apache-2.0
Плагин

Минимальный доступ

Почему такой уровень

  • Скилл содержит только инструкции, а песочница документа закрывает файлы и сеть, пока приложение их не включит.
Все причины и проверки

dev-formata-io/stof

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add plugins/stof

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Минимальный доступИнструмент ничего не запускает и не ходит в сеть.

  • Скилл содержит только инструкции, а песочница документа закрывает файлы и сеть, пока приложение их не включит.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Stof — среда выполнения данных: любой JSON уже считается документом Stof, а сверху добавляются функции, типы, единицы измерения вроде `5km` и `2GB`, схемы, импорты и тесты. Документ выполняется внутри вашего процесса в песочнице и видит только себя и функции, которые зарегистрировало приложение. Файловая система, сеть и окружение по умолчанию выключены, а у каждого вызова есть лимит времени и памяти. Скилл `stof` из репозитория обучает агента языку: как писать, читать и отлаживать файлы `.stof`, как проверять конфигурацию схемой `#[schema]`, задавать типы `#[type]` и функции `#[test]`, как вызывать `stof run` и `stof test` и как встраивать документы в Rust, TypeScript и Python. Справочники по библиотекам лежат в `references/libs/`. Плагин для Claude ставит этот скилл, а пакет npm несет ту же копию в `node_modules/@formata/stof/skill/stof`.

Для кого. Разработчикам, которые просят модель писать правила, фильтры и расчеты для приложения и хотят выполнять результат безопасно, внутри процесса.

Подходит, если

  • Клиент или модель присылает правила расчета цен, и их надо проверить и выполнить без развертывания.
  • Конфигурация должна проверять сама себя схемой и тестами рядом с данными.
  • В репозитории лежат файлы `.stof`, и агенту нужно уметь читать и править их.
  • Исходный YAML или TOML нужно превратить в документ с функциями и единицами измерения.
  • Одну логику надо выполнять одинаково в браузере, на сервере и в воркере.

Не подходит, если

  • Пишется основной код приложения, тяжелые вычисления или долгие службы: для них автор советует свой основной язык.
  • Нужна изоляция уровня контейнера или полная гарантия безопасности без собственной проверки хоста.
  • Проект не использует Rust, JavaScript, TypeScript или Python: готовых привязок к другим языкам нет.

Пример запроса к агенту

Сделай из этого JSON-конфига документ Stof с проверкой порта схемой и тестом, затем запусти `stof test`.

Ограничения

Скилл учит языку Stof и пользы вне проектов с ним не дает. Устанавливаемые части зависят от языка: `npm i @formata/stof` для JavaScript и TypeScript, `cargo add stof` для Rust, `pip install stof` для Python и `cargo install stof-cli` для командной строки. Консольная утилита `stof` включает доступ к файлам и сети, потому что запускает ваши файлы, а библиотека по умолчанию его закрывает. Пределы вызова по умолчанию составляют 2 минуты и 256 МБ. Сетевой доступ никогда не достает до localhost и частной сети без явного списка хостов.

Как отключить. Удалите плагин `stof` в Claude Code или каталог скилла из папки скиллов агента. Пакеты Stof в проекте убираются обычными командами менеджера пакетов.

Частые вопросы

Как научить агента Stof?

Дайте ему `content/SKILL.md` с кратким руководством по языку и справочники из `content/stof.zip`. Пакет npm несет ту же копию в `node_modules/@formata/stof/skill/stof`, а в репозитории есть плагин для Claude.

Безопасно ли выполнять документ, написанный моделью?

Для этого Stof и создан: документ видит только себя и функции, которые вы зарегистрировали. Файловая система, окружение, импорт файлов и сеть выключены по умолчанию, а у вызова есть лимиты времени в 2 минуты и памяти в 256 МБ.

Как установить среду выполнения?

`npm i @formata/stof` для JavaScript и TypeScript, `cargo add stof` для Rust, `pip install stof` для Python и `cargo install stof-cli` для команд `stof run` и `stof test`.

Нужно ли заменять JSON, YAML или TOML?

Нет. Stof импортирует и экспортирует эти форматы, так что логику можно добавить к уже существующим данным. Любой JSON уже служит корректным документом Stof.

Чем это лучше кода на Python в контейнере?

Контейнер требует инфраструктуры и времени запуска, а проверять приходится программу. Stof выполняется внутри процесса, стартует мгновенно, доступа по умолчанию не имеет, и любое изменение выглядит как правка документа.

Обсуждение

Вопросов и отзывов пока нет.

Плагины

Плагин из восьми скиллов для Claude Code и Codex ведет задачу в долгом проекте: границы, проверка доказательствами и память проекта

ПлагинРасширенный доступ1,1 тыс.Звезды репозитория

omnistack-agent ставит четыре скилла для Claude Code, Copilot, Cursor и Codex: отладка, ревью кода, безопасность и общая инженерия

СкиллМинимальный доступ68Звезды репозитория

Зеркало набора pstack Лорен Тан из Cursor: больше 50 скиллов, режим poteto-mode с 23 сценариями работы и 24 принципа для строгой работы агента с кодом

СкиллШирокий доступ4,1 тыс.Звезды репозитория

Каталог из 46 версионных скиллов для код-ревью, релизов, CI и лендингов: ставится плагином lstack или по одному через npx.

ПлагинРасширенный доступ145Звезды репозитория

claudefiles ставит личный набор Claude Code на новую машину: скиллы, команды, хуки и настройки из одного манифеста.

ПлагинШирокий доступ120Звезды репозитория

Площадка Anthropic DevRel: три плагина-мода для Claude Code, хуки, примеры CLAUDE.md и скиллы с разбором, как все сделано.

ПлагинРасширенный доступ369Звезды репозитория

Коротко о README

Авторы называют Stof JSON-ом, который выполняется. Движок лежит в основе Limitr, где цены каждого клиента хранятся документами Stof и считаются на каждом вызове.

Бейдж для README

Сообщить о проблеме