Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add nextstage-brasil/skills --skill ns-gitlab-ci-generator -a claude-code
Open on GitHub

What 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.yml for 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-code

2Manually: put the files in place

~/.claude/skills/ns-gitlab-ci-generator/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ns-gitlab-ci-generator/

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

Similar skills

All skills for DevOps and infrastructure →

From the same set20

The whole set →
ns-gitlab-board-sync ns-gitlab-board-sync is a Claude Code skill that mirrors local planning and execution onto existing GitLab issues. It runs during implementation linked to issues or after a plan is synced from GitLab. CX Codex +1 899installs ns-harness A skill for Claude Code, Cursor and other platforms: reverse-engineers existing code and generates project rules for the agent. Triggered by /ns-harness prepare this repo or architecture-rules.md. CX Codex +1 249installs ns-spec-driven ns-spec-driven is a Claude Code skill that drives feature delivery through formal specifications. It triggers on medium or large tasks, multi-day work, or when resuming a version from docs/versions/. CX Codex +1 208installs ns-project-manager ns-project-manager is a Claude Code skill that turns meeting transcripts and briefs into project artifacts, forecasts, and reports. CX Codex +1 185installs ns-langgraph-agents ns-langgraph-agents — a skill for Claude Code, Codex, Cursor and other platforms that guides LangGraph.js agent-api development from initial bootstrap through graph-spec sync. CX Codex +1 171installs ns-execution-gitlab-issue ns-execution-gitlab-issue executes GitLab issues end-to-end with worktree isolation, automated status changes, atomic delivery, and merge requests. CX Codex +1 165installs ns-requirements-enricher ns-requirements-enricher turns one GitLab issue or a pasted scope into an implementation brief for a coding agent, grounded in the existing code, with blocking questions kept in chat. CX Codex +1 163installs ns-best-practices ns-best-practices runs security header audits, checks basic accessibility, and reviews UI against Web Interface Guidelines. Generates structured findings with file locations. CX Codex +1 154installs

Project sponsors

Companies that keep this analytics open