skillfoxx
Ставит скиллы, MCP-серверы и CLI-инструменты из каталога SkillFoxx в ваших агентов одной командой.
npx skillfoxx add mcp/vv-mcp-server
Нужен Node.js 18.18 или новее.
Команды
Параметры: --agent claude-code,cursor (или all), --project, --global, -y/--yes, --force, --dry-run, --json, --allow-telemetry, --lang ru|en.
Агенты
Claude Code, Cursor, VS Code, Codex, Gemini CLI, Devin, Cline, Zoo Code, OpenCode, Zed, Goose, Amp, Hermes Agent, SourceCraft, Coddy.
Hermes Agent: MCP-серверы пишутся в config.yaml в папке Hermes (~/.hermes, на Windows %LOCALAPPDATA%\hermes, либо HERMES_HOME; если выбран профиль через hermes profile use, то папка этого профиля), поэтому ставятся с --global. Скиллы для пользователя попадают в skills той же папки. Скиллы проекта лежат в .agents/skills, и Hermes загружает их только после hermes skills trust в корне проекта.
Скиллы ставятся одной копией в .agents/skills (в проекте) или ~/.agents/skills (для пользователя), в папки агентов идут ссылки. Codex и Zed читают пользовательские скиллы прямо из ~/.agents/skills, Coddy в проекте читает .coddy/skills, SourceCraft .codeassistant/skills и ~/.codeassistant/skills. Ссылки в ~/.codex/skills, которые поставили версии до 0.4, remove и update убирают.
Без --agent CLI берет агента, внутри которого запущен, иначе все найденные на машине.
Что проверяется до установки
- Рецепт подписан ключом SkillFoxx (Ed25519). Неподписанный, подделанный или просроченный рецепт не принимается. Ключи: https://skillfoxx.ru/.well-known/skillfoxx-recipe-keys.json
- Файлы скилла берутся с GitHub на зафиксированном коммите и сверяются по sha каждого файла и общему отпечатку.
- Запись с высоким риском ставится только после явного согласия. С
--yesпричины печатаются в stderr. - Запись с открытым инцидентом и снятая из каталога не ставятся.
- Рецепт, собранный автоматически и еще не проверенный вручную, помечается предупреждением.
- Если в README автор пишет, что инструмент отправляет ему телеметрию, план показывает, что уходит. Когда автор называет переменную, которая это отключает, CLI до подтверждения предлагает добавить ее в конфиг MCP-сервера (по умолчанию да, с
--yesтоже да). Оставить отправку:--allow-telemetry. Выбор запоминается в lock-файле,updateего повторяет.
Конфиги и секреты
- Конфиг агента правится по одному ключу: комментарии, отступы и чужие серверы остаются. Перед правкой делается резервная копия в
~/.skillfoxx/backups. - Ключ, который поставил не SkillFoxx или который изменили руками, без
--forceне заменяется. - В проекте секрет не пишется в файл никогда: пишется ссылка на переменную окружения, если агент ее понимает, иначе печатается инструкция и совет поставить с
--global. - Для пользователя значение секрета пишется в конфиг агента, как это делают сами агенты. В lock-файле значений нет.
doctorсверяет обязательные переменные записей с текущим окружением (только имена и статус, без значений; секреты в списке проблем идут первыми). На macOS приложение, открытое из Dock или Launchpad, не видит экспорт из~/.zshrc: послеaddдля таких переменных печатается подсказка проlaunchctl setenvили запуск агента из терминала, где переменная уже задана.
Lock-файлы
skillfoxx-lock.json в корне проекта (стоит коммитить) и ~/.skillfoxx/lock.json для пользователя: запись, хеш рецепта, коммит, агенты, пути, даты. Папку пользователя можно переопределить переменной SKILLFOXX_HOME.
Телеметрия
После add, remove и update уходит анонимное событие: запись, агент, событие, версия CLI, признак CI и случайный идентификатор установки из ~/.skillfoxx/config.json. Пути, переменные, имя пользователя не отправляются. Отключить: DO_NOT_TRACK=1, DISABLE_TELEMETRY=1 или SKILLFOXX_TELEMETRY=0.
Коды выхода
0 успех, 1 сбой, 2 doctor нашел проблемы, 3 запись снята или заблокирована, 4 автоматической установки нет, 5 нужен ответ на вопрос о риске, 64 ошибка аргументов.
Чего CLI не делает
Не ставит произвольные репозитории вне каталога, не хранит чужой код у SkillFoxx, не выполняет команды из README. Плагины Claude Code ставятся командами, которые CLI печатает: сам он их не запускает.
Лицензия MIT. Лицензии вшитых пакетов: dist/THIRD_PARTY_LICENSES.txt.
