Skip to content
Skills Library
Programming · Automation

codex-git-autopilot

/codex-git-autopilot

Use when committing or pushing completed work; automates gate-aware conventional commits with optional signing and CI/CD checks.

Licence
MIT
Last repository change
23.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 23.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/auto_commit.py

What it does and when to use it

Use when committing or pushing completed work; automates gate-aware conventional commits with optional signing and CI/CD checks.

Original author description

Use when committing or pushing completed work; automates gate-aware conventional commits with optional signing and CI/CD checks.

How it works

  1. TL;DR
  2. Activation
  3. Pipeline
  4. Quick Commands
  5. Safety Guarantees
  6. GPG Setup (One-Time)
  7. Integration
Original SKILL.md headings · 79 lines, 286 words
SKILL.md preview
---
name: codex-git-autopilot
description: Use when committing or pushing completed work; automates gate-aware conventional commits with optional signing and CI/CD checks.
load_priority: on-demand
---

## TL;DR
Collect files → stage → run pre-commit gate → generate conventional commit → GPG sign → push. Never commits on gate failure, never force pushes.

# Git Autopilot

## Activation

1. Activate when the user needs automated commit/push with safety gates.
2. Activate on explicit `$codex-git-autopilot` or `$auto-commit`.

Automates the commit-push cycle with production-grade safety.

## Pipeline

1. **Collect** - Only task-related files (explicit `--files` list)
2. **Stage** - `git add` specified files
3. **Gate** - Run `pre_commit_check.py` (lint, secret scan, debug check, tests)
4. **Message** - Auto-generate Conventional Commit (`feat(scope): description`)
5. **Sign** - GPG sign for GitHub Verified badge (auto-detect config)
6. **Push** - Auto-push to origin (never force push)

## Quick Commands

### Commit task-related files

```bash
python auto_commit.py --project-root ./ --files src/models/User.js src/routes/user.routes.js
```

### Commit with custom message

```bash
python auto_commit.py --project-root ./ --files src/models/User.js -m "feat(user): add email validation"
```

### Dry-run (preview)

```bash
python auto_commit.py --project-root ./ --files README.md --dry-run
```

### Setup GPG for Verified badge

```bash
python auto_commit.py --setup-gpg
```

## Safety Guarantees

- `NEVER` commits if pre-commit gate fails
- `NEVER` force pushes
- Unstages files on gate failure (clean state)
- Falls back to unsigned commit if GPG fails
- Timeout on all git operations (60s)
- Conventional Commits format (CI/CD compatible)

## GPG Setup (One-Time)

Run `python auto_commit.py --setup-gpg` for interactive guide, or:

```bash
winget install GnuPG.GnuPG
gpg --quick-generate-key "your@email.com" rsa4096 sign never
gpg --list-secret-keys --keyid-format=long
git config --global user.signingkey YOUR_KEY_ID
git config --global commit.gpgsign true
gpg --armor --export YOUR_KEY_ID
```

Paste the exported key in GitHub Settings > SSH and GPG Keys > New GPG Key.

## Integration

This skill integrates with:

- `codex-execution-quality-gate/scripts/pre_commit_check.py` (CI gate)
- `codex-project-memory/scripts/generate_changelog.py` (reads commit history)
Files in this package (3)
  • SKILL.md 2 KB
  • agents/openai.yaml 1 KB
  • scripts/auto_commit.py 28 KB

Versions

The database has no other skills named codex-git-autopilot.

Database snapshot: 13.11.2026 · package version 3d2851f92cf3 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100writing-git-commits
    Split staged or uncommitted changes into conventional commits. Use when asked to commit, generate commit messages, split commits, squash commits, or reorder history.
  • 100git-commit
    Create commits with conventional messages and issue references. Use when user says "commit", "save changes", or "stage and commit". Local commits only — see git-push for remote.
  • 100git-workflow
    Conventional commits, PR creation, and quality gate verification. Use when: commit, PR, branch, push, conventional commit, create pull request, git.
  • 100helping-with-commits
    Automates Git commit creation with Conventional Commits. Use when user wants to commit changes. (project)
  • 100creating-commit
    Creates context-aware git commits with smart pre-commit checks, submodule support, and conventional commit message generation. Use when user requests to commit changes, stage and commit, check in code, save work, save changes, push my code, finalize changes, add to git, create…
  • 95SourceControl
    Git workflow automation including commits, branch management, and PR creation with conventional commits and clean commit rules. USE WHEN commit, git commit, create branch, pull request, PR, push, git workflow, conventional commit, stage changes, commit message.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.