Skip to content
Back to search

gitx-skill

GitX is a portable AI-agent skill for creating clean Git commits, tagged branches, and safe pushes across Codex, Claude Code, Cursor, and other skills-compatible agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/musoyangrigor--gitx-skill/badge.svg)](/listings/musoyangrigor--gitx-skill)

HTML

<a href="/listings/musoyangrigor--gitx-skill"><img src="/api/listings/musoyangrigor--gitx-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

The Skills CLI configures the skill for the selected supported AI agent. Start a new agent session after installation.

A bare `$gitx` invocation immediately inspects the repository and runs Smart commit. GitX shows its command list only when you ask for help.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 90 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # GitX
  2. Turn messy AI-generated changes into clean, safe Git history.
  3. GitX is a portable Git workflow skill for AI coding agents that turns working-tree changes into logical Conventional Commits and handles branches, project checks, safe pull and push workflows, GitHub pull requests and issues, secret scanning, merge and rebase conflict resolution, repository status and history, and commit planning across Agent Skills-compatible tools.
  4. ## Install
  5. ```bash
  6. npx skills add musoyangrigor/gitx-skill --skill gitx
  7. ```
  8. The Skills CLI configures the skill for the selected supported AI agent. Start a new agent session after installation.
  9. A bare `$gitx` invocation immediately inspects the repository and runs Smart commit. GitX shows its command list only when you ask for help.
  10. ## Commands
  11. | Command | Description |
  12. | --- | --- |
  13. | `$gitx` | Inspect changes and create a smart commit. |
  14. | `$gitx setup` | Preview and save project preferences in `.gitx.json`. |
  15. | `$gitx body` | Create a smart commit with a useful commit body. |
  16. | `$gitx branch` | Create and switch to a branch with an inferred prefix, such as `feat/` or `fix/`. |
  17. | `$gitx branch fix/token-refresh` | Create and switch to the named branch. |
  18. | `$gitx branch check` | Create an inferred branch, run checks, then commit. |
  19. | `$gitx pull` | Safely pull updates for the current branch. |
  20. | `$gitx push` | Push the current branch to `origin`; create its upstream if needed. |
  21. | `$gitx pr` | Create a GitHub pull request into the configured base or `origin`'s default branch with a generated title and body. |
  22. | `$gitx pr develop` | Create a GitHub pull request from the current branch into `develop`. |
  23. | `$gitx ship` | Create a feature branch if needed, run checks, commit, push, and open a PR into the configured or default base branch. |
  24. | `$gitx ship dev` | Run the ship workflow and open a PR targeting `dev`. |
  25. | `$gitx issue Login fails after token expiry` | Create a GitHub issue with a generated title and body. |
  26. | `$gitx issue 123` | Read GitHub issue `#123` and implement the requested fix in the current working tree. |
  27. | `$gitx resolve` | Resolve an in-progress merge or rebase conflict. |
  28. | `$gitx check` | Run relevant checks, then create a smart commit. |
  29. | `$gitx status` | Show repository status without changing anything. |
  30. | `$gitx doctor` | Diagnose common Git problems and suggest next steps without changing anything. |
  31. | `$gitx doctor push rejected` | Focus diagnosis on a specific problem or supplied error. |
  32. | `$gitx tree` | Show a compact Git history tree, branch, sync, PR, and working-tree information. |
  33. | `$gitx scan` | Scan changes and Git history for exposed secrets and sensitive files; summarize the project’s security state, findings, positives, recommended actions, and a secret-exposure rating without modifying anything. |
  34. | `$gitx plan` | Preview commit groups and messages without changing anything. |
  35. | `$gitx type fix` | Create a smart commit with the `fix` type. |
  36. | `$gitx scope auth` | Create a smart commit with the `auth` scope. |
  37. | `$gitx files README.md package.json` | Commit only the specified files. |
  38. | `$gitx amend` | Ask before amending the most recent commit. |
  39. If GitX finds several logical commit groups, it asks whether to create the real number of commits or one commit.
  40. For `gitx issue`, only a number such as `123` or `#123` tells GitX to implement an existing issue. Any other text creates a new GitHub issue, including descriptions that use words such as “fix” or “update.”
  41. Issue descriptions target GitHub even in repositories with a local tracker. Missing prerequisites or creation failures are reported without substituting a local issue file.
  42. ## Usage
  43. Invoke GitX through your AI agent's skill interface, then use the same command words. For example: `gitx plan`, `gitx check`, or `gitx branch fix/token-refresh`.
  44. GitX follows the portable `SKILL.md` Agent Skills format.
  45. ## Project preferences
  46. Run `$gitx setup` to inspect local conventions, preview the proposed configuration, and save `.gitx.json` at the repository root. Setup preserves existing choices, omits uncertain defaults, and does not run checks or commit the file. Commit it when you want to share the preferences with your team.
  47. Example configuration:
  48. ```json
  49. {
  50. "prBase": "dev",
  51. "branchPrefix": ["feat/", "fix/", "chore/", "docs/", "refactor/", "test/"],
  52. "commitScopes": ["auth", "api", "ui", "docs"],
  53. "checks": ["npm run lint", "npm test"],
  54. "draftPR": false
  55. }
  56. ```
  57. Every field is optional. With this example, `$gitx ship` and `$gitx pr` target `dev`, while `$gitx ship main` explicitly targets `main`. Generated branches choose a prefix from `branchPrefix` based on the work, such as `fix/` for a bug fix or `chore/` for maintenance. Use a string such as `"branchPrefix": "feat/"` to force one prefix, or omit the field for unrestricted inference. If no listed prefix fits or the choice is ambiguous, GitX asks before creating the branch. Inferred commit scopes use the listed vocabulary. Check workflows run the configured commands in order, and new PRs are ready for review unless a draft is explicitly requested.
  58. Explicit requests override saved preferences, and preferences override inferred defaults. Required repository rules still apply. Without `.gitx.json`, GitX works as before. See [project preferences](gitx/references/preferences.md) for setup behavior and validation, and the [JSON Schema](gitx/references/gitx.schema.json) for field types.
  59. ## Workflow references
  60. Detailed behavior: [pull requests](gitx/references/pull-requests.md), [GitHub issues](gitx/references/github-issues.md), [secret scanning](gitx/references/secret-scanning.md), [shipping](gitx/references/ship.md), [diagnosis](gitx/references/doctor.md), and [splitting edits within one file](gitx/references/same-file-splitting.md).
  61. ## Development
  62. Run the disposable Git examples with Python 3 and Git installed:
  63. ```bash
  64. python3 -m unittest discover -s tests -v
  65. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.