workflow-commit

Verifies issue evidence gates and delegates Git commit mechanics to the git-commit skill.

Updated Dec 18, 2025
One-click install
npx skills add https://github.com/l0lxl0lw/dotfiles --skill workflow-commit-l0lxl0lw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-commit
Source: https://github.com/l0lxl0lw/dotfiles/tree/main/opencode/skills/workflow/workflow-commit
Command: npx skills add https://github.com/l0lxl0lw/dotfiles --skill workflow-commit-l0lxl0lw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Committing reviewed work often loses the link between the code change and its issue, review, and verification evidence, or prematurely marks unreviewed work as ready. This Skill enforces a compact evidence handoff and readiness gate before any commit is created. ## Core Features & Use Cases - Evidence Gate Enforcement: Runs handoff.py gate with plan and review URLs to confirm v2 review/check evidence, a current contract, and no partial staging before committing. - Delegated Git Mechanics: Hands all staging, diff inspection, and commit creation to the existing git-commit skill, avoiding duplicated Git logic. - Honest Readiness Reporting: Distinguishes reviewed commits from explicitly requested WIP commits, reporting failed gates as not review-ready instead of silently passing. - Use Case: After a review pass on issue #42, run the /commit workflow to verify the gate with the plan and review URLs, commit only the intended files, and receive the commit SHA plus issue/review links. ## Quick Start Run the /commit workflow for issue 42 with its plan and review URLs to verify the evidence gate and create the commit.

Frequently Asked Questions about workflow-commit

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

FAQPage Schema
How do I commit code with issue and review evidence attached?

Run the /commit workflow with the issue number so it loads the handoff packet and runs the gate with your plan and review URLs. Once the gate passes, the git-commit skill stages the intended files and creates the commit, returning the SHA and links.

What does the commit readiness gate check before committing?

The gate requires applicable v2 review and check evidence, a current contract, and no partial staging. Missing local evidence requires real re-verification rather than a fabricated receipt.

Can I make a WIP commit before the review pass finishes?

Yes, an explicitly requested earlier or WIP commit is honored, but outstanding findings are preserved and the result is reported as not review-ready. It is never silently promoted to a passing state.

Does the commit workflow also push or open a pull request?

No, a local commit is not a push, PR, merge, or Done status. GitHub PR publication, merge, and cleanup continue to use the existing separate Git skills.

What happens if code changed after the review was completed?

The workflow names the delta and recommends a fresh review when code changed. It does not re-run verified tests or re-read ticket research when neither code nor assumptions changed.