GitLab Stack Secrets Manager — Claude Code skill: install & use
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.
no license 295 installs ★ 93 updated 2025-10-20
npx skills add rknall/claude-skills --skill gitlab-stack-secrets-manager -a claude-codeWhat GitLab Stack Secrets Manager does
This skill stores secrets for a GitLab stack project as Docker secrets. Each value gets its own file under ./secrets; the directory holds 700 permissions, every file 600. In docker-compose.yml only the file reference stays, never the value. Secret-looking names in .env or in a service's environment block are treated as a problem to fix.
The agent runs in phases. First it inspects the project: does ./secrets exist, what is declared in compose, are there tokens or passwords in .env. Then it writes the files, wires them into the compose secrets block and checks .gitignore. Validation covers permissions with stat, staged files with git status --porcelain | grep secrets/, and history with git log --all --full-history -- ./secrets/. Output is a report with a pass or fail status.
A file left at 644 instead of 600 lands in that report as a warning, so permission drift shows up before containers start. Secrets in .env count as a critical finding, and the agent lists them at the top of the report.
What it helps with
- move passwords out of
.envinto Docker secrets - create a secret file at 600 with
./secretsat 700 - check whether secrets reached the git index or history
- spot passwords written into compose environment variables
- match service secret references against files in
./secrets
Example prompts for the agent
- Create a
db_passwordsecret in./secretsand attach it to theappservice indocker-compose.yml. - Validate the secrets setup in this project and show me the report.
- Find secrets in
.envand migrate them to Docker secrets.
How to install GitLab Stack Secrets Manager
1Skills CLI (Vercel)
npx skills add rknall/claude-skills --skill gitlab-stack-secrets-manager -a claude-code2Manually: put the files in place
~/.claude/skills/secrets-manager/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/secrets-manager/
1Skills CLI (Vercel)
npx skills add rknall/claude-skills --skill gitlab-stack-secrets-manager -a codex2Manually: put the files in place
.agents/skills/secrets-manager/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add rknall/claude-skills --skill gitlab-stack-secrets-manager -a cursor2Manually: put the files in place
.cursor/skills/secrets-manager/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install rknall/claude-skills secrets-manager2Manually: put the files in place
.github/skills/secrets-manager/SKILL.md1Skills CLI (Vercel)
npx skills add rknall/claude-skills --skill gitlab-stack-secrets-manager -a gemini-cli2Platform CLI
gemini skills install https://github.com/rknall/claude-skills --path secrets-managerManually: put the files in place
.devin/skills/secrets-manager/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add rknall/claude-skills --skill gitlab-stack-secrets-manager -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 GitLab Stack Secrets Manager
How to install GitLab Stack Secrets Manager in Claude Code?
Run npx skills add rknall/claude-skills --skill gitlab-stack-secrets-manager -a claude-code. The skill lands in ~/.claude/skills/secrets-manager/SKILL.md.
What does GitLab Stack Secrets Manager do?
It splits project secrets into individual files in ./secrets, attaches them through Docker secrets, and verifies no values remain in .env or compose environment variables.
What counts as a critical issue for this skill?
Secrets in .env and passwords under a service's environment key. Wrong permissions on a secret file appear as a separate warning.