# GitLab Stack Config Generator

GitLab Stack Config Generator writes per-service configs for a GitLab stack into ./config, reads values from .env, and checks that secrets stay out of config files.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 303 installs · ★ 93 repo stars
- Author: rknall
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rknall/claude-skills/tree/HEAD/config-generator/SKILL.md
- Updated: 2025-10-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/gitlab-stack-config-generator

## What it does

It builds per-service configs for a GitLab stack project. Each service gets a folder under `./config` — nginx, PostgreSQL, Redis or your own — and the files sit flat inside it. Every value comes from `.env`; the config files carry no settings of their own.

The skill also lays down project meta files: `CLAUDE.md`, a `.gitignore` that keeps `./secrets` and `_temporary` out of git, and `.dockerignore`. It checks that paths named in configs exist and that `.env` matches `.env.example`. Docker settings go through the docker-validation skill, secret files through secrets-manager.

A password never lands in `nginx.conf`: secrets stay in `./secrets` and reach the container as Docker secrets, so a config only points at them. A project without the `./config` and `./secrets` layout has to be reshaped first.

## Requirements
- Works with: GitLab, PostgreSQL, Docker

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add rknall/claude-skills --skill gitlab-stack-config-generator -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/config-generator/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/config-generator/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add rknall/claude-skills --skill gitlab-stack-config-generator -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/config-generator/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add rknall/claude-skills --skill gitlab-stack-config-generator -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/config-generator/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install rknall/claude-skills config-generator
```

2. **Manually: put the files in place**
- File: `.github/skills/config-generator/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add rknall/claude-skills --skill gitlab-stack-config-generator -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/rknall/claude-skills --path config-generator
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/config-generator/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add rknall/claude-skills --skill gitlab-stack-config-generator -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/rknall/claude-skills/tree/HEAD/config-generator/SKILL.md

## When to use it
- scaffold nginx, PostgreSQL and Redis configs under `./config`
- keep stack variables in `.env` and mirror them in `.env.example`
- move passwords out of config files into Docker secrets
- add `CLAUDE.md`, `.gitignore` and `.dockerignore` to a new repo
- verify that paths inside configs point at real files

## Example prompts
- Generate nginx and PostgreSQL configs in `./config` and pull values from `.env`.
- Check the configs for secrets and sync `.env` with `.env.example`.
- Add `CLAUDE.md`, `.gitignore` and `.dockerignore` to this project.

## Similar
- [gitlab-ci-patterns](https://affpapa.org/en/nevibecode/skills/gitlab-ci-patterns.md) — skill · 13112 installs
- [gitlab-cicd-pipeline](https://affpapa.org/en/nevibecode/skills/gitlab-cicd-pipeline.md) — skill · 673 installs
- [docker-compose-production](https://affpapa.org/en/nevibecode/skills/docker-compose-production.md) — skill · 487 installs
- [infisical-self-host](https://affpapa.org/en/nevibecode/skills/infisical-self-host.md) — skill · 834 installs
- [glab-config](https://affpapa.org/en/nevibecode/skills/glab-config.md) — skill · 129 installs
- [crabtrap-llm-proxy](https://affpapa.org/en/nevibecode/skills/crabtrap-llm-proxy.md) — skill · 365 installs

From the same set: [rknall/claude-skills](https://affpapa.org/en/nevibecode/by/rknall/claude-skills.md) — 9 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
