commit

Stage, review, and commit one exact atomic Git change with explicit human approval.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It prevents sloppy, unreviewed Git commits by enforcing an exact-candidate workflow: each atomic change is staged deliberately, scanned for credentials and privacy leaks, verified against test gates, and committed only after explicit human approval of an immutable receipt. ## Core Features & Use Cases - Atomic candidate receipts: Records the prepared index as an immutable SHA-256-addressed receipt via commit-candidate, capturing tree, parent, branch, message, and scan state before any commit happens. - Credential and privacy scanning: Screens staged paths, diffs, and blobs for secrets, machine identifiers, and session metadata, requiring manual inspection of any unscanned objects. - Verified commit execution: commit-apply validates the receipt digest, index, identities, and hooks before committing through an isolated index, never amending or resetting on failure. - Receipt lifecycle management: Supports showing, rejecting, and closing out receipts with dry-run previews, local-only completion, and resumable close-out staging. - Use Case: After finishing a feature, ask the agent to prepare a commit; it stages only intended hunks, runs gates, presents a commit card with the conventional-commit message, and commits only after you select approval. ## Quick Start Ask the agent to prepare and commit the current atomic change, then review the presented commit card and select Commit and resume to authorize it.

Frequently Asked Questions about commit

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

FAQPage Schema
How do I commit only part of my Git working tree safely?

Stage only intended hunks with git apply --cached on a reviewed patch, then record the prepared index with commit-candidate in record-only mode. The skill refuses partially staged mixed files when using --stage and never allows git add -A or git add .

How does the commit approval workflow work?

The agent presents one commit card at a time showing the candidate reference, changes, full message, gate results, and scan disposition, followed by a Commit and resume or Commit and pause selector. Only selecting a Commit option authorizes that single candidate; free text counts as a question or rejection.

Does it scan commits for credentials or secrets?

Yes, staged paths, diffs, and blobs are screened through a payload scanner for credential patterns, plus a privacy screen for machine identifiers, local paths, and session metadata. Unscanned objects are inventoried and require manual inspection before approval.

What commit message format does it enforce?

It uses conventional commits: type(scope): subject with types like feat, fix, docs, refactor, style, test, and chore. Subjects are imperative, lowercase, and 50 characters max, with a Co-Authored-By trailer resolved from the active model at commit time.

What happens if commit-apply fails or finds a mismatch?

On any refusal or mismatch it reports the outcome and stops; it never amends, resets, switches branches, or bypasses hooks to repair the state. The original index and worktree are never restored or overwritten, leaving resolution to the human.

When should receipts be closed out or deleted?

Receipts are kept through dependent approval, publication, CI, or recovery, then closed by exact ID using commit-candidate --close with a dry-run preview first. Ready candidates, ambiguous records, and other worktrees' records are always preserved rather than swept.