Flownix
Начать
Разделы
На этой странице

Установка скиллов

Скиллы — это инструкции, по которым агент работает с продуктом. Четыре способа их поставить и один — держать в актуальном состоянии.

MCP даёт агенту доступ, скиллы — правила. Скилл — это Markdown-файл с инструкцией, которую агент читает и исполняет буквально: какой инструмент вызвать, в каком порядке, что записать в тикет. Без скиллов агент всё равно может создавать ноды, но будет делать это как придётся и терять контекст между сессиями.

Скиллы ставятся набором, а не по одному — они рассчитаны на то, что лежат все вместе и ссылаются друг на друга.

Куда они кладутся

Claude Code читает скиллы из ~/.claude/skills/<slug>/SKILL.md — один каталог на скилл, файл внутри всегда называется SKILL.md:

shell
~/.claude/skills/
├── flownix-basics/SKILL.md
├── flownix-init/SKILL.md
├── plan-feature/SKILL.md
├── execute-task/SKILL.md
└── ...

После установки Claude Code нужно перезапустить — список скиллов он читает на старте. Дальше они вызываются как слэш-команды: /flownix-init, /plan-feature, /execute-task.

Способ 1. Пакет npm

Ставит скиллы во все найденные на машине агенты — и, если дать токен, заодно настраивает MCP-сервер и хук репортера:

визард
npx @flownix/cli

Он спрашивает, куда ставить (Claude Code, Cursor, Codex, OpenCode, Windsurf, Gemini CLI, Copilot и другие — найденные отмечены заранее), глобально или в текущий проект. Токен на этом шаге не нужен: без него визард поставит скиллы и честно пропустит два оставшихся шага.

только скиллы, без вопросов
npx @flownix/cli skills --yes
что уже стоит на машине
npx @flownix/cli status

Скиллы он берёт с сервера, а копию из пакета ставит только когда сети нет — и говорит об этом. Каталоги переименованных скиллов (ai-flow-*) удаляются, чужие не трогаются.

Способ 2. Одной командой

Скиллы отдаёт публичный эндпоинт — токен для него не нужен:

установка всех скиллов
curl -s https://api.flow.shipoora.ru/api/skills | jq -r '.[] | @base64' |
  while read -r row; do
    slug=$(echo "$row" | base64 -d | jq -r .slug)
    mkdir -p ~/.claude/skills/"$slug"
    echo "$row" | base64 -d | jq -r .content > ~/.claude/skills/"$slug"/SKILL.md
  done
проверка
ls ~/.claude/skills | grep -c . && head -3 ~/.claude/skills/flownix-basics/SKILL.md

Нужен jq. На macOS — brew install jq, в Debian/Ubuntu — apt install jq.

Способ 3. Архивом из веб-интерфейса

Если командной строки под рукой нет: Настройки → Скиллы → Скачать все (.zip). Внутри архива — те же каталоги плюс README с описанием каждого скилла.

распаковка
unzip flownix-skills.zip -d /tmp/flownix-skills
cp -r /tmp/flownix-skills/* ~/.claude/skills/

На той же странице каждый скилл можно скачать по отдельности или скопировать его текст — это нужно, если ваш агент не Claude Code и читает инструкции из другого места.

Способ 4. Руками агента

Если агент уже подключён по MCP, он поставит скиллы себе сам — у него для этого есть инструменты list_skills и get_skill:

в сессии агента
поставь себе скиллы Flownix: list_skills, потом get_skill на каждый,
и разложи по ~/.claude/skills/<slug>/SKILL.md

Способ удобен тем, что не требует ничего, кроме уже настроенного доступа. Взамен он тратит контекст: содержимое всех скиллов проходит через сессию.

Обновление

Скиллы меняются вместе с продуктом. Сверить локальные копии с сервером — скилл sync-skills:

в сессии агента
/sync-skills

Он сравнивает MD5 файлов с серверными и скачивает только изменившиеся, а не всё подряд. Отдельно он удаляет скиллы, которые сервер объявил снятыми. Это не уборка ради порядка: переименованный скилл иначе останется лежать рядом со своей новой версией, и агент прочитает устаревшую инструкцию, ничем себя не выдав.

Отчёт выглядит так:

shell
Skill sync complete
  IN_SYNC   : execute-task, plan-feature                  (2)
  PULLED    : review-work, sync-skills                    (2)
  DELETED   : ai-flow-basics → flownix-basics             (1)
  LOCAL_ONLY: my-custom-skill                             (1)

LOCAL_ONLY — ваши собственные скиллы; их синхронизация не трогает.

Другие агенты

Скилл — это обычный Markdown с YAML-фронтматтером, без единой зависимости от Claude Code. Для другого агента путь тот же: скачать содержимое и подложить туда, откуда он читает инструкции, — или вставить текст нужного скилла в контекст руками.

Дальше