repo-cleanup

Audit repositories for obsolete files and recommend .gitignore patches.

1|Updated Sep 6, 2024
One-click install
npx skills add https://github.com/carlos18bp/gym_project --skill repo-cleanup-carlos18bp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-cleanup
Source: https://github.com/carlos18bp/gym_project/tree/main/.agents/skills/repo-cleanup
Command: npx skills add https://github.com/carlos18bp/gym_project --skill repo-cleanup-carlos18bp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you prevent repository bloat and confusion by auditing what files are obsolete, deprecated, orphaned, or unnecessary, then recommending cleanup actions safely.

Core Features & Use Cases

  • Prioritized repo audit: Identifies likely obsolete artifacts (coverage/build/test outputs), backups, temporary/debug files, and root-level leftovers.
  • Dead code detection: Flags potentially unused frontend utilities/components and non-standard backend modules by checking for zero external references.
  • .gitignore gap recommendations: Detects tracked files that should match existing ignore rules and suggests exact lines to add.

Quick Start

Ask the skill to audit the project by saying: "Run a repository cleanup audit for all areas and return a prioritized, read-only action plan with any recommended .gitignore patch."

Frequently Asked Questions about repo-cleanup

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

FAQPage Schema
How do I find obsolete files and dead code in my git repository?

To find obsolete files and dead code in your git repository, run a systematic audit that scans for tracked build artifacts, backups, and zero-reference modules. This generates a read-only, categorized action plan detailing exactly what clutter exists and why it is considered safe to remove.

What is the best way to fix .gitignore mismatches for tracked build artifacts?

The best way to fix .gitignore mismatches is to audit tracked files against existing ignore rules, which identifies artifacts that should have been ignored. This process produces an exact .gitignore patch you can apply to prevent future repository bloat from build and test outputs.

How does dead code detection work for frontend utilities and backend modules?

Dead code detection works by scanning frontend utilities and backend modules for zero external references across the codebase. It flags potentially unused components and non-standard modules as orphaned, categorizing them in a read-only report for review before any deletion occurs.

Can I audit repository hygiene without risking destructive git operations?

Yes, you can audit repository hygiene without risking destructive git operations. The audit follows an approval-first approach that only produces a prioritized, read-only action plan and recommended patches, ensuring no files are actually deleted or modified until you explicitly review and approve.

Does repository cleanup auditing work for both frontend and backend scopes?

Repository cleanup auditing works across frontend, backend, and documentation scopes. It locates tracked test outputs, orphaned configs, temporary debug files, and deprecated files within each specific area, returning categorized findings tailored to the technical stack being analyzed.

Why are root-level leftovers and backup files tracked when they should be ignored?

Root-level leftovers and backup files are tracked due to .gitignore gaps where existing ignore rules fail to match specific file patterns. An audit detects these mismatches and suggests exact lines to add to your .gitignore, preventing unnecessary files from remaining in version control.