repo-health

Audit local Git repositories for standard files, GitHub configuration, and code hygiene.

97|18|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/thatrebeccarae/claude-marketing --skill repo-health-thatrebeccarae
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-health
Source: https://github.com/thatrebeccarae/claude-marketing/tree/main/skills/repo-health
Command: npx skills add https://github.com/thatrebeccarae/claude-marketing --skill repo-health-thatrebeccarae

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Repositories often lack consistent governance and documentation, making it hard to onboard new contributors, ensure compliance, and track health metrics. This skill identifies missing standard files, configuration gaps, and documentation hygiene across a GitHub repo and surfaces actionable fixes.

Core Features & Use Cases

  • Detects presence of standard files (LICENSE, README, SECURITY.md, CONTRIBUTING.md, CODEOWNERS, .editorconfig, issue/PR templates, CHANGELOG, CODE_OF_CONDUCT) and reports gaps.
  • Evaluates GitHub configuration like repository description, topics, default branch name, and branch protection status.
  • Assesses documentation quality and changelog freshness to guide open-source readiness.
  • Flags code hygiene issues such as stale branches and tracked secrets.
  • Produces a prioritized fix list to guide remediation.

Quick Start

Run the repo-health audit on your local clone to generate a structured health report.

Frequently Asked Questions about repo-health

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

FAQPage Schema
How do I run a GitHub repository health audit to find missing standard files?

Run a GitHub repository health audit on your local Git clone to detect missing standard files like LICENSE, README, and SECURITY.md. The audit evaluates configuration gaps, documentation quality, and code hygiene, producing a structured score and prioritized fix list.

What does a repo health check include for GitHub configuration and branch protection?

A repo health check evaluates GitHub configuration by auditing repository descriptions, topics, default branch names, and branch protection status. It identifies branch protection gaps and configuration issues, surfacing actionable fixes to improve overall repository governance.

Can I audit private GitHub repositories locally for documentation maturity and code hygiene?

Yes, you can audit both private and public GitHub repositories locally. The audit assesses documentation maturity, flags stale branches and tracked secrets, and applies a scoring rubric to generate a concise health report with prioritized remediation steps.

How do I benchmark my repository's open-source readiness against standard files like CODEOWNERS and CONTRIBUTING.md?

Benchmark open-source readiness by auditing standard files such as CODEOWNERS, CONTRIBUTING.md, issue templates, and CHANGELOG. The audit checks for file presence, evaluates changelog freshness, and produces a structured score to guide open-source compliance.

What is the best way to identify tracked secrets and stale branches in a local Git repo?

The best way to identify tracked secrets and stale branches is running a local repository health audit. It flags code hygiene issues, scores the repository against a rubric, and outputs a prioritized fix list to remediate security and maintenance gaps.