An intelligent AI assistant that drafts high-quality Git commit messages by analyzing your staged changes and terminal history.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install contextual-git-committer
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install contextual-git-committer using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Contextual Git-Committer?
Contextual Git-Committer is a specialized tool designed for the Openclaw Skills ecosystem that automates one of the most tedious parts of the development cycle: writing meaningful commit messages. By synthesizing information from staged diffs, shell command history, and previous project logs, it provides developers with accurate and descriptive message options. This skill ensures your repository history remains clean and professional while saving valuable time during the development process.
Leveraging Openclaw Skills allows developers to maintain high documentation standards without manual effort. The tool doesn't just look at the code; it understands the intent by correlating what you typed in the terminal with what changed in the files, ensuring the why is captured as clearly as the what.
Contextual Git-Committer Use Cases
- Automating the creation of standards-compliant messages for teams following the Conventional Commits specification.
- Generating detailed narrative-style logs for complex refactors where the context of the change is critical for future maintenance.
- Streamlining quick updates and hotfixes with expressive, emoji-prefixed messages for casual or internal projects.
- Improving project documentation consistency by analyzing existing git logs to match established style patterns.
How Contextual Git-Committer Works
- The tool initiates by executing git diff --cached to extract exactly what changes are staged for the next commit.
- It reviews recent shell history to identify commands like test runs or package installations that provide context for the changes.
- The skill inspects the recent git log to ensure the generated suggestions align with the existing project naming conventions.
- It parses diff hunks to identify specific functions, classes, or modules that were modified during the session.
- The AI processes this multi-layered context to produce three distinct message options for the user to choose from.
Contextual Git-Committer Setup
To start using this skill within your local environment, follow these configuration steps. Ensure you have the Openclaw Skills framework installed and your Git repository initialized.
# Navigate to your local skills directory
cd path/to/openclaw/skills
# Clone or install the Contextual Git-Committer skill
git clone https://github.com/openclaw/contextual-git-committer.git
# Verify your Python environment is ready
python3 --version
Once installed, you can trigger the tool from your AI agent using the suggest_commit command.
Contextual Git-Committer Data Schema & Taxonomy
The skill organizes repository and environment data into a structured format for the AI agent to process. Below is the taxonomy of the data gathered during execution:
| Data Component | Source | Description |
|---|---|---|
| Staged Hunks | git diff --cached | The raw code changes analyzed for semantic meaning. |
| Action Context | Shell History | Recent commands that indicate the purpose of the work. |
| Style Reference | git log | A sample of previous commits to maintain project voice. |
| Target Scope | Optional Argument | User-defined module names (e.g., auth, ui) to narrow focus. |
| Style Preference | Optional Argument | Flag to toggle between conventional and detailed narrative formats. |
Contextual Git-Committer Advanced Features
- Multi-Format Generation: Provides Conventional, Story, and Emoji styles simultaneously for every staged change.
- Terminal Correlation: Unique ability to read terminal history to understand the developer's intent behind the code.
- Scoped Commit Focus: Supports manual scope definitions to ensure messages are accurately attributed to specific architectural layers.
- Diff Parsing: Intelligently identifies the specific code structures changed, such as class names or function signatures, for high-precision messaging.
SKILL.md
Loading
Related Openclaw Skills
x-search
A high-performance skill that enables real-time searching and summarization of X (Twitter) posts via the xAI Grok API.
Overseas Business Trip Suite
An all-in-one automation skill for managing overseas flight bookings, hotel reservations, policy compliance, and expense reporting.
Video Editor AI with Music
A cloud-powered AI video editor that automatically matches background music to your footage and renders high-quality clips in seconds.
Personal CRM Warm-Up
An automated networking assistant that identifies cold contacts and drafts personalized reconnection messages based on local data.
Screen Video
The Screen Video skill automates the editing of screen recordings, turning raw footage into professional walkthroughs with AI-driven trimming, captioning, and highlighting.
x-search
A real-time search utility for X (Twitter) powered by the xAI Grok API, designed for Openclaw Skills integrations.
Featured*
