An intelligent git assistant that automates conventional commit messages while enforcing security scans and atomic staging.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install shadows-smart-commit
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 shadows-smart-commit 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 Smart Commit?
Smart Commit is an essential addition to the Openclaw Skills ecosystem, designed to streamline the version control process for developers. It acts as an intelligent layer over standard git operations, ensuring that every commit is descriptive, follows the Conventional Commits specification, and remains free of sensitive data. By analyzing code diffs and repository history, this skill helps maintain a clean and professional project timeline.
Integrating Smart Commit into your development environment through Openclaw Skills ensures that your team follows best practices without the manual overhead. It handles the cognitive load of summarizing changes, allowing developers to focus on writing code while maintaining high standards for repository health and security. The skill is entirely local, requiring no external API calls, making it a privacy-conscious choice for sensitive projects.
Smart Commit Use Cases
- Automating commit messages after completing a coding task or bug fix.
- Ensuring security compliance by scanning staged changes for API keys, tokens, or passwords before they are committed.
- Refining messy working trees into atomic, logical commits by identifying related file changes.
- Maintaining a standardized git history using the Conventional Commits specification across a multi-developer team.
- Quickly reviewing and staging changes via an AI-guided workflow.
How Smart Commit Works
- The skill performs a reconnaissance phase by running git status and analyzing diffs to understand the current state of the repository.
- It executes a mandatory security scan using regex patterns to detect potential secrets, leaked credentials, or prohibited file types in the staged changes.
- The agent suggests a staging strategy, prioritizing explicit file naming over generic commands to prevent accidental inclusions.
- A conventional commit message is generated based on the nature of the changes (feat, fix, refactor, etc.) and the project's existing history.
- The commit is executed locally, and the skill verifies the final state of the repository to ensure the operation was successful.
Smart Commit Setup
To get started with this skill, ensure that git is installed and available in your system's PATH. As part of the Openclaw Skills collection, no external APIs or network configurations are required.
# Ensure git is installed
git --version
Smart Commit Data Schema & Taxonomy
Smart Commit interacts primarily with the local .git directory. It organizes its internal logic based on the following metadata and data patterns:
| Component | Description |
|---|---|
| Commit Types | Uses standard types: feat, fix, refactor, docs, test, chore, perf, style, build, ci. |
| Security Patterns | Scans for strings like api_key, secret, token, and extensions like .env or .pem. |
| Staging Logs | Tracks which files are explicitly staged to ensure atomic commits. |
| History Baseline | Reads the last 5 commits to match the repository's existing tone and scope. |
Smart Commit Advanced Features
- Strict security enforcement that halts the process if a potential secret is detected in the diff.
- Multi-line commit message generation using HEREDOC to preserve complex descriptions and co-author metadata.
- Atomic commit grouping to split unrelated changes into separate, logical updates.
- Compatibility with different operating systems including macOS, Linux, and Windows.
- Zero-persistence architecture ensuring no credentials or sensitive data are stored outside the local git environment.
SKILL.md
Loading
Related Openclaw Skills
Skill Factory
A powerful meta-skill designed to guide developers through the creation, formatting, and validation of standardized SKILL.md files for AI agents.
Security Scanner
A professional 7-phase security auditing pipeline that identifies vulnerabilities, scans dependencies, and detects leaked secrets.
Python Sensei
A specialized AI coding assistant that enforces strict Python engineering standards, including type safety, async patterns, and modular architecture.
Project Architect
A professional-grade planning protocol that guides AI agents through requirements analysis, architecture design, and actionable task mapping.
Telegram ASCII Table Formatter
Converts pipe-separated raw data into formatted ASCII or Unicode box tables specifically optimized for Telegram monospace code blocks.
YouTube Watcher
A specialized skill to fetch, read, and analyze YouTube video transcripts for summarization and information extraction.
METADATA
Featured*
