Skip to main content
skill CX Codex

GitLab Stack Validator — Claude Code skill: pre-deploy stack audit

GitLab Stack Validator audits a GitLab stack project before deployment: directory layout, secrets, .env sync and Docker config. Reports problems; fixing them is on you.

no license 297 installs ★ 93 updated 2025-10-20

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add rknall/claude-skills --skill gitlab-stack-validator -a claude-code
Open on GitHub

What GitLab Stack Validator does

Runs a pre-deploy audit of a GitLab stack project. The layout comes first: ./config, ./secrets and ./_temporary have to be there, access to ./secrets should be locked down, and nothing in the tree should belong to root. It also reads .gitignore to confirm that secrets, temp files and .env stay out of git.

Then .env gets compared with .env.example. A missing template file or a variable present on one side only goes into the report. Docker config is handed to the docker-validation skill: secrets declared at the top level, services pulling them through the secrets: key, volumes pointing at the right folders, no version: field in docker-compose.yml. Credentials written straight into a compose file, .env or a shell script are marked critical.

Detection and reporting are all this skill does. Remediation sits with stack-creator and secrets-manager, so on a project without them you apply the fixes yourself. Custom rules live in .stack-validator.yml, and the report comes out as text or JSON.

What it helps with

  • audit a stack layout before the first deploy
  • catch credentials left in .env or compose files
  • compare .env with .env.example and list mismatches
  • find root-owned files in the project tree
  • confirm .gitignore keeps secrets out of the repo

Example prompts for the agent

  • Validate this GitLab stack before I deploy it and give me a text report
  • Check .env against .env.example and list the variables that are missing
  • Audit docker-compose.yml for secret handling and volume mounts

How to install GitLab Stack Validator

1Skills CLI (Vercel)

npx skills add rknall/claude-skills --skill gitlab-stack-validator -a claude-code

2Manually: put the files in place

~/.claude/skills/stack-validator/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/stack-validator/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about GitLab Stack Validator

How do I install GitLab Stack Validator in Claude Code?

Run npx skills add rknall/claude-skills --skill stack-validator -a claude-code. The skill ends up at ~/.claude/skills/stack-validator/SKILL.md.

What does GitLab Stack Validator check?

Directory structure, file ownership, .gitignore entries, .env versus .env.example, and how Docker secrets are wired into docker-compose.yml.

Does it fix the issues it finds?

No. It reports them only; the changes are made by hand or through stack-creator and secrets-manager.

Similar skills

All skills for DevOps and infrastructure →

From the same set9

SVG Logo Designer SVG Logo Designer generates SVG logos from a brand description: several concepts, layouts and colour versions. Handy when a project needs a logo or an icon right now. CX Codex +1 9,200installs Python Backend Architecture Review Python Backend Architecture Review — a skill that reviews Python backend architecture: patterns, database, API, security, scalability. Useful when the design doc exists and you want the weak spots found before release. CX Codex +1 528installs Web Design Builder Web Design Builder turns a spec or a plain description into HTML5/CSS/JS, then checks accessibility and behaviour through Playwright MCP. CX Codex +1 432installs Docker Configuration Validator Docker Configuration Validator validates Dockerfiles and Docker Compose files for security, syntax and modern requirements. Useful before shipping to production. CX Codex +1 352installs Newt Blueprint Generator Newt Blueprint Generator is a skill for creating and validating Pangolin Newt configurations in YAML or Docker Labels. It covers proxy and client resources, access rules, and Docker Compose setups. CX Codex +1 303installs 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. CX Codex +1 303installs GitLab Stack Secrets Manager GitLab Stack Secrets Manager keeps GitLab stack passwords and keys in ./secrets via Docker secrets, then checks permissions and hunts leaks in .env, compose files and git history. CX Codex +1 295installs GitLab Stack Creator GitLab Stack Creator scaffolds a new Docker stack project: folders, git settings, validation hooks and docs. Use it when you start a stack in the GitLab stack layout. CX Codex +1 294installs

More in the catalog

Project sponsors

Companies that keep this analytics open