A specialized read-only tool for triaging uncommitted changes and identifying potential risks in a local git repository.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install git-dirty-check
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 git-dirty-check 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 Git Dirty Check?
The git-dirty-check skill for Openclaw Skills provides developers with a streamlined way to understand the state of their working tree without the risk of modifying repository data. It focuses on summarizing staged, unstaged, and untracked files while applying conservative risk heuristics based on file paths and names. By utilizing this Openclaw Skills enhancement, you get a compact operational summary that highlights critical changes like dependency updates or security-related file modifications before you commit your work.
This tool is intentionally designed as a narrow, read-only interface. It avoids the complexities of branch management or merge resolution, instead offering a high-level overview of what is dirty in your repo. By integrating with Openclaw Skills, developers can maintain a safe environment while performing rapid code triage and pre-commit checks.
Git Dirty Check Use Cases
- Summarizing all uncommitted changes before a final commit.
- Identifying risk flags such as manifest changes without corresponding lockfiles.
- Checking for untracked or conflicted files in a complex directory structure.
- Performing a quick triage of dirty files in a local repository without triggering full repo assistance.
- Verifying repository state during a handoff or local review process.
How Git Dirty Check Works
- Verifies that the target path is a valid git repository and fails fast if it is not.
- Collects repository state using read-only commands like git status and diff-stat.
- Groups all detected entries into specific categories: staged, unstaged, untracked, and conflicted.
- Applies conservative risk flags based on file paths, filenames, and capped diff statistics.
- Performs limited inspection of non-sensitive files to assign flags when metadata is insufficient.
- Generates a structured report including repo state, risk analysis, and suggested next steps.
Git Dirty Check Setup
To use git-dirty-check within Openclaw Skills, ensure your environment has git installed and accessible via your system's PATH. No additional write permissions are required as the skill operates entirely in read-only mode.
# Verify git is installed
git --version
# The Openclaw Skills agent will automatically use these commands:
git rev-parse --show-toplevel
git status --short
Git Dirty Check Data Schema & Taxonomy
The git-dirty-check skill organizes information into a consistent schema to ensure clarity within the Openclaw Skills ecosystem:
| Section | Description |
|---|---|
| Repo State | Displays the repo root and counts of staged, unstaged, untracked, and conflicted files. |
| Categories | Lists up to 10 entries per category, summarizing the remainder for readability. |
| Risk Flags | Highlights critical issues like CI file changes or manifest/lockfile mismatches. |
| Next Checks | Provides 1 to 3 copy-paste ready read-only git commands for further exploration. |
| Omissions | Explicitly notes any details skipped due to privacy rules or inspection caps. |
Git Dirty Check Advanced Features
- Automated risk heuristics for identifying potential auth, security, or infrastructure file changes.
- Built-in secret protection that prevents inspecting or exposing values from files like .env or private keys.
- Deep diff inspection caps that limit analysis to 3 files and 40 lines per file to maintain performance.
- Seamless integration with the Openclaw Skills framework for standardized repository reporting.
- Fail-fast validation to prevent accidental processing of non-git directories.
SKILL.md
Loading
Related Openclaw Skills
Browser Account Controller
A Python-based automation bridge for controlling multi-account browser profiles through a local HTTP API interface.
Kalshi F1 Race Momentum Trader
An automated trading agent that leverages recent Formula 1 race results to exploit momentum-based inefficiencies in Kalshi prediction markets.
Kalshi F1 Points Model Trader
An automated trading agent that uses Monte Carlo simulations of F1 standings to identify and exploit mispriced championship winner markets on Kalshi.
W Skill Pack
A multi-purpose toolkit offering eight essential utilities ranging from web research and weather updates to health tracking and writing assistance.
Entertainment 8
An AI-powered entertainment analysis tool that uncovers deep connections between celebrities, industry news, and the symbolic number 8.
Bid Proposal Manager
An intelligent bid and proposal management system that parses multi-format announcements, vectorizes content for semantic search, and automates Notion project creation.
Featured*
