northflank — скилл для Claude Code: деплой и инфраструктура
Скилл учит агента работать с Northflank: деплоить сервисы и джобы, поднимать базы, вести релизы через API, CLI и JS-клиент.
npx skills add northflank/skills --skill northflank -a claude-codeЧто делает northflank
Скилл описывает примитивы платформы: проекты как пространства имён Kubernetes, сервисы, аддоны с базами, джобы по расписанию, группы секретов, тома и шаблоны IaC. Агент получает карту того, что и через какой интерфейс делать, и не путает сущности между собой.
Работать можно тремя путями. MCP-сервер даёт готовые инструменты вроде deploy_app и deploy_job; CLI опирается на вашу сессию northflank login; JS-клиент @northflank/js-client и REST — для кода, который вы оставите себе. Хостед-эндпоинт — https://mcp.northflank.com/mcp, авторизация через Authorization: Bearer <team API token>. Установка скилла сама по себе MCP не настраивает и доступа к аккаунту не даёт: подключение и токен придётся завести отдельно, в секретах клиента или переменных окружения, но не в чате и не в коммите.
Отдельный раздел — удаление. Скилл требует подтверждать каждую разрушительную операцию поимённо, и это не формальность: удаление аддона убивает данные базы, если свежего бэкапа нет. Агент спросит имя аддона и наличие бэкапа, прежде чем что-то трогать. Токены ворклоада, привязанные к окружению статикой, не обновляются сами — нужен клиент, который перечитывает смонтированный токен или повторяет запрос после отказа авторизации.
Какие задачи решает
- задеплоить сервис из Git или готового образа
- поднять managed-базу как аддон к проекту
- настроить джобу по расписанию
- разобраться, почему упал сервис или аддон
- вынести секреты в группу вместо переменных в репозитории
Примеры запросов агенту
- Задеплой сервис из моего репозитория в проект
my-project - Создай managed-базу и подключи её к сервису
- Почему падает джоба
cleanup? Собери логи и события
Как установить northflank
1Через Skills CLI (Vercel)
npx skills add northflank/skills --skill northflank -a claude-code2Вручную: положить файлы
~/.claude/skills/northflank/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/northflank/
1Через Skills CLI (Vercel)
npx skills add northflank/skills --skill northflank -a codex2Вручную: положить файлы
.agents/skills/northflank/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add northflank/skills --skill northflank -a cursor2Вручную: положить файлы
.cursor/skills/northflank/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install northflank/skills northflank2Вручную: положить файлы
.github/skills/northflank/SKILL.md1Через Skills CLI (Vercel)
npx skills add northflank/skills --skill northflank -a gemini-cli2Командой платформы
gemini skills install https://github.com/northflank/skills --path skills/northflankВручную: положить файлы
.devin/skills/northflank/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add northflank/skills --skill northflank -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о northflank
Как установить northflank в Claude Code?
Выполните npx skills add northflank/skills --skill northflank -a claude-code. Скилл окажется в ~/.claude/skills/northflank/SKILL.md.
Что делает скилл northflank?
Даёт агенту описание платформы и правила работы с ней: деплой сервисов и джобов, аддоны с базами, секреты, домены, шаблоны, превью-окружения, пайплайны и релизные процессы. Опирается на REST API, CLI northflank и клиент @northflank/js-client.
Нужен ли MCP-сервер для работы скилла?
Нет, но с ним удобнее: MCP даёт готовые инструменты деплоя прямо в агенте. Подключение настраивается отдельно, эндпоинт — https://mcp.northflank.com/mcp с заголовком Authorization: Bearer <team API token>.
