secrets-with-git-crypt
Manages encryption and decryption of repository secrets (such as .env or *.tfvars) using git-crypt, keeping credentials secure with parallel encrypted files. Use when managing secrets, setting up git-crypt, or encrypting/decrypting environment files.
How do I install this agent skill?
npx skills add https://github.com/derailed-dash/dazbo-agent-skills --skill secrets-with-git-cryptIs this agent skill safe to install?
- Gen Agent Trust Hubwarn
This skill provides a workflow and automation script for managing repository secrets using git-crypt. The included helper script uses elevated privileges (sudo) to install dependencies, which is a potential security concern if executed in an unmonitored environment. Additionally, the skill's primary function involves handling sensitive files like environment variables and configuration secrets.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
Secrets Management with Git-Crypt
This skill provides a secure, structured workflow for managing repository secrets (e.g. .env, *.tfvars, sec.json, settings.json) using git-crypt. It guides the agent to ensure sensitive credentials are never checked in as plaintext, instead maintaining parallel encrypted .enc versions checked into Git.
Table of Contents
Triggers
This skill MUST trigger whenever:
- The user mentions
git-crypt,encryption,decryption, orsecrets management. - The user requests to store sensitive files (like
.env,*.tfvars,settings.json, keyfiles) in the repository. - The user attempts to commit or push files that should be encrypted (e.g.
.env,*.tfvars,sec.json) to the repository. - Cloning an existing repository that contains
.encfiles (e.g..env.enc,terraform.tfvars.enc,settings.json.enc), indicating it was previously protected bygit-crypt. - Initialising a new repository and setting up local/remote secret configurations.
- Changing or adding secrets credentials that need to be committed securely.
Prerequisites
- Host Environment: Unix-like operating system (e.g. Linux, WSL, macOS).
- Git: A Git repository must be initialised in the current project.
- git-crypt: The
git-cryptcommand-line utility must be installed.- If missing, the helper script can attempt installation via
sudo apt-get install git-crypton Debian/Ubuntu systems.
- If missing, the helper script can attempt installation via
- Helper Script: Locate the bundled
git-crypt-helper.shscript (already executable; runchmod +xif needed):- Global Antigravity path:
~/.gemini/config/skills/secrets-with-git-crypt/scripts/git-crypt-helper.sh - Project-local path:
.agents/skills/secrets-with-git-crypt/scripts/git-crypt-helper.sh(or./skills/secrets-with-git-crypt/scripts/git-crypt-helper.shinsidedazbo-agent-skills)
- Global Antigravity path:
Secrets Setup and Sync Workflow
Copy this checklist and track your progress:
Secrets Management Progress:
- [ ] Step 1: Verify git-crypt installation and helper path
- [ ] Step 2: Initialise or unlock the repository
- [ ] Step 3: Configure tracking and gitignore rules
- [ ] Step 4: Perform file synchronisation
- [ ] Step 5: Verify environment security
Step 1: Pre-implementation safety & binary verification
Before attempting any encryption, decryption, or secret sync operations:
-
Verify Git Work Tree:
- Confirm the working directory is inside a Git repository (
git rev-parse --is-inside-work-tree). If not in a Git repository, halt execution and prompt the user to rungit initfirst.
- Confirm the working directory is inside a Git repository (
-
Verify
git-cryptBinary, Helper Script & Pre-Edit Sync State (MANDATORY BEFORE EDITING):- Use the installed helper script (
~/.gemini/config/skills/secrets-with-git-crypt/scripts/git-crypt-helper.sh, or.agents/skills/secrets-with-git-crypt/scripts/git-crypt-helper.shwhen project-local). - CRITICAL PRE-EDIT RULE: Before modifying any local plaintext secret file (e.g.
.env,mcp_config.json,*.tfvars), you MUST runstatus(andsync-from-encif.encis newer) first:
Why this matters: Ifbash ~/.gemini/config/skills/secrets-with-git-crypt/scripts/git-crypt-helper.sh status<file>.encwas updated upstream (e.g. viagit pull) while the local git-ignored<file>is still an older copy, editing the stale<file>first updates itsmtimeto "now" and causessync-to-encto reintroduce deleted lines back into<file>.enc. Always reconcile<file>from<file>.enc(sync-from-enc) before applying edits. - If
git-cryptis missing, offer to install it via:bash ~/.gemini/config/skills/secrets-with-git-crypt/scripts/git-crypt-helper.sh install
- Use the installed helper script (
Step 2: Unlock with an existing shared key (preferred) or initialise a new key
- CRITICAL KEY REUSE RULE: Always check whether the user already has a shared
git-cryptsymmetric key (e.g.~/localdev/git-crypt-key,../git-crypt-key, or$GIT_CRYPT_KEY_PATH) before ever runninginit, even on a brand-new repository!git-crypt unlock <key_path>works on both cloned repositories and brand-new repositories (once.gitattributesis committed on a clean working tree) to bind the repository to your existing shared key without generating a new key.- If a shared key exists (or if
unlockis run without arguments when../git-crypt-keyor~/localdev/git-crypt-keyis present), run:bash ~/.gemini/config/skills/secrets-with-git-crypt/scripts/git-crypt-helper.sh unlock ~/localdev/git-crypt-key
- Only if no shared key exists AND the user explicitly wants to mint a brand-new key:
Decide where the secure key will be stored outside of the repository (e.g.
~/secure-keys/my-project.key) and run:
(Note:bash ~/.gemini/config/skills/secrets-with-git-crypt/scripts/git-crypt-helper.sh init ~/secure-keys/my-project.keyinitwill refuse to generate a new key if an existing shared key is detected at../git-crypt-keyor~/localdev/git-crypt-keyunless--forceis passed.) Ensure the key is NEVER committed to Git.
Step 3: Configure tracking and gitignore rules
Verify that .gitattributes in the root of the project contains the filter declaration:
*.enc filter=git-crypt diff=git-crypt
All unencrypted files (e.g. .env, settings.json, variables.tfvars) MUST be explicitly added to .gitignore. Running the helper script sync commands automatically appends them, but you must double-check that they are not tracked as plaintext in Git.
Step 4: Perform file synchronisation
-
Sync to encrypted versions (before committing changes): Copy unencrypted local files to their parallel
.encversions:- For a specific file:
bash ~/.gemini/config/skills/secrets-with-git-crypt/scripts/git-crypt-helper.sh sync-to-enc .env - For all known
.encfiles in the repository:bash ~/.gemini/config/skills/secrets-with-git-crypt/scripts/git-crypt-helper.sh sync-to-enc
- For a specific file:
-
Sync from encrypted versions (after unlocking a cloned repository): Restore all unencrypted plaintext files from the unlocked
.encversions:bash ~/.gemini/config/skills/secrets-with-git-crypt/scripts/git-crypt-helper.sh sync-from-enc
Step 5: Verify environment security
Perform the steps in the Verification Loop before concluding your turn to make sure no plaintext secrets have been staged or committed.
Command Reference
The helper script supports the following commands:
| Command | Arguments | Description |
|---|---|---|
install | None | Installs git-crypt on Debian/Ubuntu/WSL platforms. |
init | [--force] <key_path> | Runs git-crypt init, sets up .gitattributes, and exports key (blocks if a shared key already exists unless --force). |
unlock | [key_path] | Unlocks the repository (new or cloned) using the specified key file or auto-detected shared key (../git-crypt-key / ~/localdev/git-crypt-key). |
sync-to-enc | [--force] [file] | Syncs unencrypted file(s) to their .enc copies (refuses if .enc is newer unless --force); prints git diff --stat HEAD and ensures .gitignore inclusion. |
sync-from-enc | [--force] [file] | Syncs/restores .enc copies back to unencrypted files (refuses if plaintext is newer unless --force). |
status | None | Evaluates installation, git-crypt initialisation, and file sync states. |
Verification Loop
Before concluding the secrets setup or modifications, the agent MUST execute the following verification steps:
1. Execute Status Check
Run the helper status command:
bash ~/.gemini/config/skills/secrets-with-git-crypt/scripts/git-crypt-helper.sh status
Ensure all parallel secret files report [OK]. If any say DO NOT MATCH, run the appropriate sync-to-enc or sync-from-enc command.
2. Verify gitignore Integrity
Confirm the unencrypted plain files are NOT tracked by Git. Run:
git ls-files --error-unmatch .env 2>/dev/null
- If the command returns output (file is tracked): IMMEDIATELY run
git rm --cached <file>to remove it from staging while keeping it locally on disk.
3. Verify .gitattributes Structure
Verify that .gitattributes has:
*.enc filter=git-crypt diff=git-crypt
This ensures git-crypt transparently manages all .enc files under Git.
4. Git Crypt Status Check
Verify that git-crypt matches the filter correctly on staged/committed .enc files:
git-crypt status
The output must show that the .enc files are encrypted.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/derailed-dash/dazbo-agent-skills/secrets-with-git-crypt">View secrets-with-git-crypt on skillZs</a>