ns-gitlab-ci-generator — скилл для Claude Code: установка
Скилл ns-gitlab-ci-generator генерирует и настраивает пайплайн .gitlab-ci.yml для SaaS-монорепозиториев со структурой бэкенда и фронтенда.
Apache-2.0 200 установок обновлён 2026-10-24
npx skills add nextstage-brasil/skills --skill ns-gitlab-ci-generator -a claude-codeЧто делает ns-gitlab-ci-generator
Скилл разворачивает базовый файл пайплайна из шаблона references/templates/gitlab-ci.template.yml и адаптирует его под кодовую базу. При инициализации он считывает docker-compose.yml, а также файлы правил из каталога .nextstage-harness/rules/, если они присутствуют в проекте. Конфигурация собирается строго под ветки develop, homolog и main.
В процессе генерации инструмент подтягивает команды тестов из package.json или composer.json, выбирает ключ кэша под yarn.lock либо package-lock.json, сверяет образ PHP с Dockerfile бэкенда и настраивает пути к папкам сквозных тестов вроде testes-cypress или frontend/cypress.
Скилл не рассчитан на изолированные репозитории сред выполнения агентов без разделения на бэкенд и фронтенд. Создание облачной инфраструктуры за рамками заложенного шаблона им тоже не поддерживается.
Какие задачи решает
- Сгенерировать
.gitlab-ci.ymlдля монорепозитория с бэкендом и фронтендом - Связать E2E-тесты на Cypress с нужными ветками деплоя
- Подобрать параметры кэширования под lock-файлы проекта
- Зафиксировать имена переменных окружения GitLab CI без сохранения секретов
Примеры запросов агенту
- Настрой .gitlab-ci.yml для нашего SaaS-проекта с ветками develop, homolog и main
- Адаптируй пайплайн GitLab CI под тесты в папке frontend/cypress и проверку бэкенда
Как установить ns-gitlab-ci-generator
1Через Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-gitlab-ci-generator -a claude-code2Вручную: положить файлы
~/.claude/skills/ns-gitlab-ci-generator/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ns-gitlab-ci-generator/
1Через Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-gitlab-ci-generator -a codex2Вручную: положить файлы
.agents/skills/ns-gitlab-ci-generator/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-gitlab-ci-generator -a cursor2Вручную: положить файлы
.cursor/skills/ns-gitlab-ci-generator/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install nextstage-brasil/skills skills/ns-gitlab-ci-generator2Вручную: положить файлы
.github/skills/ns-gitlab-ci-generator/SKILL.md1Через Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-gitlab-ci-generator -a gemini-cli2Командой платформы
gemini skills install https://github.com/nextstage-brasil/skills --path skills/ns-gitlab-ci-generatorВручную: положить файлы
.devin/skills/ns-gitlab-ci-generator/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-gitlab-ci-generator -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о ns-gitlab-ci-generator
Как установить ns-gitlab-ci-generator в Claude Code?
Выполните команду npx skills add nextstage-brasil/skills --skill ns-gitlab-ci-generator -a claude-code в терминале проекта.
Что делает ns-gitlab-ci-generator?
Создаёт готовый сценарий сборки, тестирования и поэтапного деплоя в .gitlab-ci.yml, опираясь на структуру каталогов и пакетные менеджеры проекта.
Подходит ли скилл для проектов только с кодом ИИ-агентов?
Нет, репозитории классов agent_runtime без явной связки бэкенда и фронтенда выходят за рамки сценариев этого скилла.
Исходный текст
SKILL.md · Apache-2.0
--- name: ns-gitlab-ci-generator description: (NS) Generate and adapt .gitlab-ci.yml for SaaS products with backend and frontend — test, build, E2E gate, deploy by branch. Use when the user asks for GitLab CI, pipeline setup, or CI/CD bootstrap for a monorepo product. Uses references/templates/gitlab-ci.template.yml as baseline. Out of scope for pure agent-runtime repos without backend+frontend layout. license: Apache-2.0 metadata: author: nextstage-brasil version: "1.0" --- # GitLab CI Generator Produce `.gitlab-ci.yml` for backend + frontend SaaS layouts. ## Session boot Load `.nextstage-harness/rules/infra-rules.mdc`, `backend-tests-rules.mdc`, `e2e-tests-rules.mdc` when present. Read `docker-compose.yml`. ## When to use - Create or adjust `.gitlab-ci.yml` - `product_class` saas or intelligent_saas (backend + frontend required) - Branch-based test/build/deploy ## Out of scope - `agent_runtime`-only pipelines - Cloud provisioning beyond template contract ## Inputs - Target branches (minimum: develop, homolog, main) - E2E folder name (`testes-cypress`, `tests-e2e`, or `frontend/cypress`) ## Workflow ### A — Copy baseline Copy `references/templates/gitlab-ci.template.yml` to `.gitlab-ci.yml` Paths are repo-relative (`backend/`, `frontend/`). ### B — Mandatory adaptations | Item | Action | | --------------- | ---------------------------------------------------------------------- | | E2E folder | Match product folder in `changes:` and job `cd` | | PHP image | Align to backend Dockerfile | | Test commands | Match `composer.json` / `package.json` | | Lockfile | `yarn.lock` vs `package-lock.json` in cache key | | Deploy branches | Adjust regex if not main/homolog/develop | | E2E disabled | Remove e2e jobs from deploy `needs` or document `RUN_REMOTE_E2E=false` | Do not copy another product's CI file — use this template only. ### C — GitLab CI variables Document in optional `docs/context/ci-cd-notes.md`: - `ENV_BACKEND`, `ENV_FRONTEND`, test DB vars, `RUN_REMOTE_E2E`, GCP keys — names only, no secret values ### D — Validate Lint YAML; confirm jobs match repo layout. ## References | File | When | | --------------------------------------------- | ----------------- | | `references/templates/gitlab-ci.template.yml` | Baseline pipeline | ## Related skills - `ns-e2e-tests` — E2E folder conventions - `ns-spec-driven` `references/e2e-test-task-generator.md` — planning E2E scope
© nextstage-brasil · Apache-2.0 · nextstage-brasil/skills