Repolode
musoyangrigor

musoyangrigor/gitx-skill

An agent skill that turns AI-generated working-tree changes into clean Conventional Commits, branches, safe pulls and pushes, and GitHub PRs.

Stars
97
Forks
6
Open issues
0
Last commit
5 days ago

What is it?

GitX is a portable Git workflow skill for AI coding agents such as Codex, Claude Code and Cursor. It splits working-tree changes into logical Conventional Commits, so a messy batch of AI-generated edits can become a readable commit history instead of one large commit.

Beyond committing, GitX covers branch creation with inferred prefixes like feat/ or fix/, project checks before commits, safe pull and push, and opening GitHub pull requests and issues. It also includes secret scanning, conflict resolution for merges and rebases, repository status and history views, and a commit plan preview that changes nothing.

Behavior can be tuned per repository with an optional .gitx.json file that sets the PR base branch, branch prefixes, commit scopes and check commands. The skill is installed with the Skills CLI and follows the Agent Skills SKILL.md format.

Key features

  • 01Splits working-tree changes into logical Conventional Commits.
  • 02Creates branches with inferred prefixes such as feat/ or fix/.
  • 03Runs configured project checks before committing.
  • 04Opens GitHub pull requests and issues with generated titles and bodies.
  • 05Scans changes and history for exposed secrets and sensitive files.
  • 06Previews commit groups and messages without changing anything.

Use cases

  • Cleaning up a large batch of AI-generated edits into reviewable commits.
  • Shipping a feature in one step: branch, check, commit, push and open a PR.
  • Sharing team commit conventions through a committed .gitx.json file.
  • Checking a repository for leaked secrets before pushing.

Quick start

  1. 1

    Install the skill with the Skills CLI

    npx skills add musoyangrigor/gitx-skill --skill gitx
  2. 2

    Start a new agent session after installation

  3. 3

    Invoke the skill to inspect changes and create a smart commit

    $gitx

Things to know

  • Requires a supported AI agent that reads Agent Skills format, and Python 3 with Git for its test suite.
  • Creating GitHub pull requests and issues depends on GitHub, so other hosts are not covered by the README.

Topics

FAQ

What is gitx-skill?
An agent skill that turns AI-generated working-tree changes into clean Conventional Commits, branches, safe pulls and pushes, and GitHub PRs. GitX is a portable Git workflow skill for AI coding agents such as Codex, Claude Code and Cursor. It splits working-tree changes into logical Conventional Commits, so a messy batch of AI-generated edits can become a readable commit history instead of one large commit.
Is gitx-skill free to use? What license does it have?
gitx-skill is open source under the MIT license. Check the license terms before using it in commercial products.
Is gitx-skill still maintained?
Actively maintained. The last commit to gitx-skill was on Oct 15, 2026.
What can I use gitx-skill for?
Cleaning up a large batch of AI-generated edits into reviewable commits. Shipping a feature in one step: branch, check, commit, push and open a PR. Sharing team commit conventions through a committed .gitx.json file. Checking a repository for leaked secrets before pushing.
How do I install gitx-skill?
Install the skill with the Skills CLI: npx skills add musoyangrigor/gitx-skill --skill gitx Start a new agent session after installation Invoke the skill to inspect changes and create a smart commit: $gitx
Where can I get gitx-skill?
The source code and installation instructions are on GitHub: https://github.com/musoyangrigor/gitx-skill

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects