repo-hygiene

What problem does it solve?

This Skill automates the process of auditing a code repository for common hygiene issues, ensuring consistency, identifying stale code, and flagging potential problems before they escalate.

Core Features & Use Cases

• Stale File Detection: Identifies Python scripts and utility files untouched for over 60 days.
• Archive Compliance: Checks if archived files have proper documentation headers.
• .gitignore Auditing: Verifies essential patterns are present in .gitignore and flags untracked files that should be ignored.
• Sync Health: Reports on unpushed commits, orphaned branches, and diverged branches.
• Documentation Freshness: Flags Markdown documentation files not updated within specified thresholds.
• Size Warnings: Identifies large files and checks overall repository size.
• Use Case: Run this audit before a major release to ensure the repository is clean, well-maintained, and free of common configuration or staleness issues.

Quick Start

Run the repo hygiene skill to perform a full repository audit.