clean-commit

Audit a target folder for junk and structural issues, then clean and commit changes.

Updated May 22, 2026
One-click install
npx skills add https://github.com/asifhussain60/journal --skill clean-commit-asifhussain60
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-commit
Source: https://github.com/asifhussain60/journal/tree/main/skills-staging/clean-commit
Command: npx skills add https://github.com/asifhussain60/journal --skill clean-commit-asifhussain60

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits a target folder for sprawl, stray files, and misplaced items, cleans up safely, and records a detailed categorized commit.

Core Features & Use Cases

  • Detects junk files, empty dirs, and misplacements and cleans them with safety checks.
  • Proposes actions for Tier 2 changes requiring confirmation, then executes after approval.
  • Ensures git integrity by only deleting untracked files or using git rm for tracked ones and commits with a structured message.

Quick Start

Resolve the target folder and trigger the cleanup pass to audit, clean, and commit changes with a descriptive log.

Frequently Asked Questions about clean-commit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clean up junk files and empty directories in a git repository safely?

To clean up junk and empty directories safely, the agent audits the target folder and applies auto-clean operations while respecting git state. It only deletes untracked files directly and uses git rm for tracked files to maintain repository integrity.

What is folder hygiene and how does it prevent directory sprawl?

Folder hygiene is the process of auditing a target folder to detect stray files, misplacements, and structural sprawl. The agent identifies these issues and plans safe cleanup actions to maintain a clean and organized directory structure.

Can I automate git commit messages after cleaning up my project folder?

Yes, you can automate git commit messages after cleanup. The agent generates a structured, categorized commit message detailing the junk removal and folder hygiene actions applied during the automated audit.

How do I handle folder cleanup actions that require manual confirmation in git?

For folder cleanup actions requiring manual confirmation, the agent proposes tiered actions for Tier 2 changes. It lists the structural modifications needed and executes them only after receiving your explicit approval.

Does the cleanup agent delete tracked git files without using git rm?

No, the cleanup agent does not delete tracked git files without using git rm. It strictly respects git state by avoiding the deletion of tracked files and ensuring all tracked removals are processed through git.