git-workflow

Enforce trunk-based git workflows across branches, commits, pushes, and PRs.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/michael-conrad/.opencode --skill git-workflow-michael-conrad
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: git-workflow
Source: https://github.com/michael-conrad/.opencode/tree/main/skills/git-workflow
Command: npx skills add https://github.com/michael-conrad/.opencode --skill git-workflow-michael-conrad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enforces a disciplined, trunk-based git workflow across branch creation, commits, pushes, PRs, and conflict resolution to prevent unsafe practices on protected branches and ensure auditable, standards-compliant history.

Core Features & Use Cases

  • Enforces squash-only-at-PR creation and prevents commits to main or $DEFAULT_BRANCH.
  • Handles conflict-resolution dispatch, PR state verification, cleanup, and provenance tracking as part of the full workflow.
  • Submodule-aware discipline ensures pointer updates, correct branching, and isolated sub-agent routing for submodule changes.

Quick Start

Tell me to run the git-workflow to enforce a branch/PR discipline on your feature branch.

Frequently Asked Questions about git-workflow

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

FAQPage Schema
How do I enforce trunk-based git workflows across feature branches?▼

Trunk-based git workflows are enforced by preventing direct commits to protected branches, automating squash-on-PR creation, and dispatching conflict resolution. This ensures guarded, auditable changes throughout branch creation, commits, pushes, and PRs.

What is the best way to prevent commits to main or protected branches?▼

Preventing commits to main branches is achieved by enforcing branch creation rules and squash-only merges at PR time. This maintains an auditable, standards-compliant history for your repository.

How do I handle git submodules during a pull request workflow?▼

Git submodule pull request handling requires submodule-aware discipline to ensure pointer updates, correct branching, and isolated sub-agent routing. This isolates submodule changes within the broader workflow.

Can I automate conflict resolution and PR state verification for git branches?▼

Conflict resolution and PR state verification can be automated through dedicated dispatch and state checks. This handles cleanup and provenance tracking, ensuring auditable state verification for protected branches.

Does trunk-based branching work with release flows and provenance tracking?▼

Trunk-based branching applies to both feature and release flows while maintaining provenance tracking. This ensures all changes are auditable and compliant with your automation requirements.