git-commit

Write git commit messages to a file and commit with git -F.

1|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/bneb/perqed --skill git-commit-bneb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-commit
Source: https://github.com/bneb/perqed/tree/main/.agents/skills/git-commit
Command: npx skills add https://github.com/bneb/perqed --skill git-commit-bneb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers avoid shell escaping issues when making git commits in zsh by guiding safe messaging practices and a reliable workflow.

Core Features & Use Cases

  • Safe commit messaging: instructs to write the message to a file and commit from the file to avoid -m escaping issues.
  • Supports conventional commit types and clear formatting to improve history readability.
  • Use Case: When composing long messages with special characters or multi-line content, ensures safe and reproducible commits.

Quick Start

Write the commit message to a file and commit using the file.

Frequently Asked Questions about git-commit

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

FAQPage Schema
How do I commit multi-line git messages in zsh without escaping issues?

To commit multi-line git messages in zsh without escaping issues, write the message text to a temporary file and use the git -F option to read the commit message directly from that file.

Why does git commit -m break with special characters in my shell?

Git commit -m breaks with special characters because shells like zsh apply escaping rules to the string, which mangles multi-line content or symbols before git receives the message.

What is the best way to format conventional commits safely in zsh?

The best way to format conventional commits safely in zsh is writing the formatted message to a file and committing from the file, ensuring the commit history remains readable and reproducible.

Do I need any extra dependencies to commit from a file in git?

Committing from a file in git requires no extra dependencies, utilizing the native git -F option or equivalent to read the message directly from a written file instead of using shell flags.

Can I use heredoc for git commit messages in zsh?

Using heredoc for git commit messages in zsh often causes escaping issues, making a write-to-file approach combined with the git -F option a more reliable workflow for multi-line content.