ns-gitlab-ci-generator — Claude Code skill: how to install
ns-gitlab-ci-generator is a Claude Code skill that generates and configures .gitlab-ci.yml pipelines for SaaS monorepos with frontend and backend layouts.
Apache-2.0 200 installs updated 2026-10-24
npx skills add nextstage-brasil/skills --skill ns-gitlab-ci-generator -a claude-codeWhat ns-gitlab-ci-generator does
This skill copies references/templates/gitlab-ci.template.yml into .gitlab-ci.yml and customizes each job to fit your repository. At boot, it checks docker-compose.yml alongside rules in .nextstage-harness/rules/ when available. Build, test, and release jobs align with develop, homolog, and main target branches.
Customization inspects your stack directly. The skill synchronizes the PHP runtime image with the backend Dockerfile, matches commands against composer.json or package.json, adjusts cache keys for yarn.lock or package-lock.json, and updates directories for Cypress suites.
Repositories strictly serving agent runtimes without coupled backend and frontend folders are not supported. Provisioning cloud infrastructure outside the baseline template contract also falls outside its boundaries.
What it helps with
- Generate
.gitlab-ci.ymlfor dual-tier SaaS monorepos - Align CI cache keys with npm or yarn lockfiles
- Configure branch gates for development, staging, and production
- Map custom Cypress directory paths to CI test jobs
Example prompts for the agent
- Generate a .gitlab-ci.yml pipeline for our SaaS repo targeting develop, homolog, and main
- Adjust GitLab CI test and deploy jobs to reflect our backend Dockerfile and tests-e2e folder
How to install ns-gitlab-ci-generator
1Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-gitlab-ci-generator -a claude-code2Manually: put the files in place
~/.claude/skills/ns-gitlab-ci-generator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ns-gitlab-ci-generator/
1Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-gitlab-ci-generator -a codex2Manually: put the files in place
.agents/skills/ns-gitlab-ci-generator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-gitlab-ci-generator -a cursor2Manually: put the files in place
.cursor/skills/ns-gitlab-ci-generator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install nextstage-brasil/skills skills/ns-gitlab-ci-generator2Manually: put the files in place
.github/skills/ns-gitlab-ci-generator/SKILL.md1Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-gitlab-ci-generator -a gemini-cli2Platform CLI
gemini skills install https://github.com/nextstage-brasil/skills --path skills/ns-gitlab-ci-generatorManually: put the files in place
.devin/skills/ns-gitlab-ci-generator/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add nextstage-brasil/skills --skill ns-gitlab-ci-generator -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ns-gitlab-ci-generator
How to install ns-gitlab-ci-generator in Claude Code?
Run npx skills add nextstage-brasil/skills --skill ns-gitlab-ci-generator -a claude-code in your terminal.
What does ns-gitlab-ci-generator do?
It sets up complete GitLab CI pipelines for SaaS apps, configuring test gates, caching, and branch-triggered deployments.
Can I use this for standalone agent runtimes?
No, the skill requires a combined backend and frontend layout and ignores pure agent_runtime projects.
Source text
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