git-signing-troubleshoot
Installation
SKILL.md
Git signing troubleshoot
Use this skill when local Git signing is the blocker and the job is to diagnose the trusted signing path safely, especially for 1Password-backed SSH signing, without bypassing GPG or SSH signing requirements.
Use this skill when
- A commit, tag, or push is blocked by a GPG or SSH signing failure.
- Git is configured for SSH signing and the error mentions
op-ssh-sign,failed to fill whole buffer, or another 1Password signing failure. op whoamisays the account is not signed in, but the 1Password app is open and the real question is whether signed Git operations still work.- You need to confirm the configured signing format or program path without swapping to an alternate signing route.
- The safest useful outcome is either a successful signed Git operation or a precise blocker that the user must clear in their trusted signing setup.
Do not use this skill when
- Signing already works and the real task is how to merge, push, or clean up the branch.
- The main blocker is PR creation, PR review, or remote checks rather than local signing.
- The push is blocked by secret scanning, not signing.
- The request is to bypass signing with
--no-gpg-sign, config overrides, or alternate credentials.