git-crypt

Create and manage git-crypt encrypted repository worktrees with key propagation.

75|17|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/smith-horn/skillsmith --skill git-crypt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-crypt
Source: https://github.com/smith-horn/skillsmith/tree/main/.claude/skills/git-crypt
Command: npx skills add https://github.com/smith-horn/skillsmith --skill git-crypt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill automates the safe creation and management of Git worktrees in git-crypt protected repositories, addressing key propagation and lock/unlock challenges.

Core Features & Use Cases

  • Create worktrees for git-crypt repos with automatic key propagation and lock handling.
  • Automatically bypass or re-enable the smudge filter during worktree setup.
  • Centralized key management guidance and compatible workflows for main repos and derived work trees.
  • Troubleshooting guidance for common git-crypt worktree issues (unlock, key copying, status checks).

Quick Start

Create a new worktree that supports git-crypt, unlock the worktree with a key, and verify that encryption is active and syncing with the main repo.

Frequently Asked Questions about git-crypt

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a git worktree for a git-crypt encrypted repository?

This skill automates git-crypt worktree creation by propagating the required symmetric key to the new path and running the unlock command, handling lock states and key copying automatically.

Why does my git-crypt worktree show encrypted files instead of plaintext?

Git-crypt worktrees display encrypted files when the smudge filter is misconfigured or the repository remains locked. You must unlock the worktree using a valid key file to decrypt and view the plaintext content.

Do I need to install git-crypt before using this worktree automation?

Yes, this automation requires git-crypt to be installed and unlocked, a valid key file available, and a repository configured with git-crypt and a .gitattributes file before executing any worktree workflows.

What is the best way to manage git-crypt keys across multiple worktrees?

Centralized key management is the best way to manage git-crypt keys across worktrees. This skill provides guidance on copying and propagating keys from the main repository to derived work trees to maintain sync.

Can I bypass the git-crypt smudge filter during worktree setup?

Yes, you can automatically bypass or re-enable the git-crypt smudge filter during worktree setup. This skill handles the smudge filter configuration automatically to ensure proper decryption and syncing.