Description

Boost developer productivity with Gitai: An AI-powered Git automation tool that analyzes code changes and generates semantic Conventional Commits instantly. Supports Node.js, Python, Java, Go, PHP, and more. Compatible with OpenAI, Anthropic, and Groq.

README (SKILL.md)

Gitai Automation - AI-Powered Git Workflow

Name: Gitai - Git Commit Automation
Author: leandrosilvaferreira

Transform your development workflow with intelligent, automated commit management.

Gitai analyzes your code changes to generate precise, descriptive commit messages following the Conventional Commits standard. It eliminates the friction of writing commit messages, ensuring a clean, semantic, and professional git history automatically.

Key capabilities:

Universal Language Support: Analyzes Node.js, Python, Java, Go, PHP, and more.
Multi-LLM Support: Choose your preferred AI brain—OpenAI (GPT), Anthropic (Claude), or Groq.
Workflow Automation: Stages, commits, and pushes changes in a single command.
Standardized History: Enforces consistency across your project's version history.

📦 Prerequisites (MANDATORY)

This skill requires the @notyped/gitai CLI tool to be installed and configured on the system BEFORE the agent can operate.

The AGENT MUST NOT attempt to install this package or configure it.

CHECK if gitai is available:
```
command -v gitai
```
IF MISSING, STOP immediately and inform the user:

"The gitai CLI tool is not installed. Please install it globally (e.g., npm install -g @notyped/gitai) and configure it before using this skill."
CHECK if ~/.gitai exists.
IF MISSING, STOP immediately and inform the user:

"The gitai tool is installed but not configured. Please run gitai in your terminal to complete the setup."
ONLY PROCEED if both checks pass.

🚀 Usage & Workflows

Command Structure

Based on gitai --help:

gitai [options] [projectPath] [baseMessage]

Arguments:

projectPath: The path to the project (default: ".").
baseMessage: The base commit message (Optional).

Options:

-p, --push: Whether to push after committing (default: false).
-V, --version: Output the version number.
-h, --help: Display help for command.

Standard Workflows

Command	Action Description
`gitai . ''`	Analyzes current folder, Generates message and commits
`gitai . '' --push`	Analyzes current folder, Generates message, commits, AND pushes to remote
`gitai ./frontend 'ui update'`	Analyzes only the `./frontend` directory, Generates message and commits

Verification

Check which version of Gitai is currently active:

gitai --version

⚠️ Troubleshooting

Interactive Wizard Hangs: If gitai hangs waiting for input, it means ~/.gitai is missing or invalid. create the file manually as described in Step 2.
Node Version Error: Ensure Node.js 18+ is active (node -v).
API Errors: Check the API_KEY in ~/.gitai.

Links

GitHub: https://github.com/leandrosilvaferreira/gitai-skill
Issues: https://github.com/leandrosilvaferreira/gitai-skill/issues

Author

Leandro Zuck
GitHub: https://github.com/leandrosilvaferreira
Email: [email protected]

License

MIT

Usage Guidance

This skill is a thin instruction layer that expects you to have the third-party `gitai` CLI installed and configured. Before installing/using the skill: 1) Verify and inspect the external CLI (@notyped/gitai) from its upstream repository (the SKILL.md and README reference a GitHub URL) to ensure you trust it; 2) Check the ~/.gitai file for any API keys or provider configuration and make sure those credentials are intended for use; 3) Be cautious with workflows that include automatic --push (the agent can run commands that push to remotes); if you prefer, run the CLI manually or restrict the agent from pushing until you confirm behavior; 4) Because the skill is instruction-only, its safety depends on the external CLI — treat that dependency as the primary risk. If you want higher assurance, test the CLI locally in a disposable repo and review the GitHub source before enabling autonomous agent runs.

Capability Analysis

Type: OpenClaw Skill Name: gitai-skill Version: 1.0.2 The skill is designed to integrate with an external `gitai` CLI tool, but the `SKILL.md` explicitly instructs the AI agent NOT to install or configure this tool. The agent is only permitted to check for the presence of the `gitai` command and the existence of its configuration file (`~/.gitai`). While the skill uses broad permissions ('Run Command', 'Read File', 'Write File'), the instructions for the agent are highly constrained and defensive, preventing it from performing high-risk actions like installing software, reading sensitive configuration file content, or exfiltrating data. The `README.md` mentions installation scripts (`scripts/install.sh`, `scripts/install.ps1`), but these are not part of the analyzed skill bundle and the agent is explicitly forbidden from running them.

Capability Assessment

✓ Purpose & Capability

The skill's name/description match the runtime instructions: it delegates work to a local `gitai` CLI for analyzing diffs and creating Conventional Commits. Requiring the CLI and its config file (~/.gitai) is coherent with the stated purpose.

ℹ Instruction Scope

SKILL.md instructs the agent to check for `gitai` on PATH and for the presence of ~/.gitai, and to stop if either is missing. It does not instruct the agent to install or modify unrelated system files. However the skill permits running commands that can stage/commit/push git changes — which will interact with repositories and remotes — so users should be aware the agent may perform networked git operations (e.g., push) if invoked.

✓ Install Mechanism

There is no install spec and no code files; the skill is instruction-only and requires the third-party `@notyped/gitai` CLI to be installed by the user. This minimizes supply-chain risk from the skill itself, but shifts trust to the external CLI package.

ℹ Credentials

The skill declares no required environment variables or credentials. It does rely on a user-controlled config file (~/.gitai) that the CLI uses for PROVIDER/API_KEY settings; the agent checks only for its existence but could be granted file-read capability. Ensure any API keys in that file are intended to be used by the local CLI.

✓ Persistence & Privilege

The skill is not always-enabled and allows normal autonomous invocation (platform default). It does not request persistent privileges or modify other skills/configs. Users should remember autonomous execution can run git/push commands if allowed by the agent.

Version History

v1.0.2

- Removed installation and update scripts (`scripts/install.sh`, `scripts/update.sh`) from the project. - Updated documentation to require manual installation and configuration of the `@notyped/gitai` CLI tool before use. - Clarified that the agent must not attempt installation or configuration of dependencies. - Updated setup instructions to enforce prerequisite checks for both the CLI tool and its configuration file. - Removed all references to automated install/update commands from the usage guide.

v1.0.1

- Updated configuration instructions: users are now advised to launch the native setup wizard by running `gitai` in their terminal, rather than manually creating the `~/.gitai` file. - Removed previous manual API key and configuration steps to improve security and streamline setup. - No functional or code changes—documentation update only.

v1.0.0

- Initial release of gitai-automation. - AI-powered tool for generating Conventional Commit messages in Git. - Supports multiple programming languages including Node.js, Python, Java, Go, and PHP. - Compatible with OpenAI, Anthropic, and Groq models. - Automates staging, committing, and pushing with a single command. - Enforces standardized, semantic git commit history for improved collaboration.

Metadata

Slug gitai-skill

Version 1.0.2

License —

All-time Installs 8

Active Installs 8

Total Versions 3

Frequently Asked Questions

What is Gitai - Git Commit Automation?

Boost developer productivity with Gitai: An AI-powered Git automation tool that analyzes code changes and generates semantic Conventional Commits instantly. Supports Node.js, Python, Java, Go, PHP, and more. Compatible with OpenAI, Anthropic, and Groq. It is an AI Agent Skill for Claude Code / OpenClaw, with 3125 downloads so far.

How do I install Gitai - Git Commit Automation?

Run "/install gitai-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Gitai - Git Commit Automation free?

Yes, Gitai - Git Commit Automation is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Gitai - Git Commit Automation support?

Gitai - Git Commit Automation is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Gitai - Git Commit Automation?

It is built and maintained by leandrosilvaferreira (@leandrosilvaferreira); the current version is v1.0.2.

More Skills

Gitai - Git Commit Automation