repo-hygiene

Audits git repositories for stale files, archive compliance, .gitignore gaps, sync health, documentation freshness, and oversized files.

Updated Jan 4, 2026
One-click install
npx skills add https://github.com/LudiInformatio/Ludi-Bot --skill repo-hygiene-ludiinformatio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-hygiene
Source: https://github.com/LudiInformatio/Ludi-Bot/tree/main/.claude/skills/repo-hygiene
Command: npx skills add https://github.com/LudiInformatio/Ludi-Bot --skill repo-hygiene-ludiinformatio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

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.

Frequently Asked Questions about repo-hygiene

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

FAQPage Schema
How do I audit a git repository for stale files and configuration gaps?

To audit a git repository for stale files and gaps, run an automated hygiene check that analyzes git logs, git status, and file system sizes to detect untouched scripts, missing .gitignore patterns, and unpushed commits, generating a structured report for review.

What does repository hygiene maintenance include for pre-release checks?

Repository hygiene maintenance includes detecting stale Python scripts untouched for over 60 days, verifying .gitignore patterns, checking archive compliance, flagging large files, and reporting on diverged or orphaned branches to ensure the repository is clean before a release.

Can I check for unpushed commits and orphaned branches in my repository audit?

Yes, you can check for unpushed commits and orphaned branches during a repository audit. The sync health feature analyzes git status to report on diverged branches, orphaned branches, and unpushed commits, flagging potential synchronization issues for review.

How do I identify large files and documentation freshness issues in my codebase?

To identify large files and documentation freshness issues, the audit checks overall repository size against thresholds and flags Markdown documentation files not updated within specified timeframes, analyzing file system sizes and modification dates to surface warnings.

Does the repository audit work without external dependencies or tools?

Yes, the repository audit works without external dependencies. It requires no additional packages, relying on scripts and references to analyze git logs, git status, and file system metadata directly to generate its structured hygiene report.

What are the limitations of automated .gitignore auditing for untracked files?

Automated .gitignore auditing verifies essential patterns are present and flags untracked files that should be ignored, but it relies on predefined essential patterns and cannot infer project-specific ignore rules or dynamically adjust to novel framework outputs.