repo-health

Aggregate dead-code, tests, dependencies, secrets, and gotchas into a scored repo health report.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/exerias21/brainstorm-toolkit --skill repo-health-exerias21
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-health
Source: https://github.com/exerias21/brainstorm-toolkit/tree/main/skills/repo-health
Command: npx skills add https://github.com/exerias21/brainstorm-toolkit --skill repo-health-exerias21

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read-only: a repo hygiene sweep that aggregates dead-code, tests, dependency audit, secret scan, and gotchas currency into a single scored report. Use this to surface high-impact issues before release and provide a clear next-action.

Core Features & Use Cases

  • Unified checks: run parallel dead-code, tests, deps, secrets, and gotchas checks and produce a single score.
  • Early risk visibility: surface high-risk items with a next-action hint.
  • Pre-release hygiene: validate repo readiness prior to releases.

Quick Start

Ask Claude Code or Copilot to run a health sweep on your repository and review the resulting .claude/.next-action for the next steps.

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 repository health sweep to check for dead code and secrets?

A repository health sweep aggregates dead-code detection, test status, dependency audits, secret scanning, and gotchas tracking into a single scored report. You can trigger it by asking Claude Code or Copilot to run the health sweep on an active Git repository.

What is included in a repo health check report?

A repo health check report includes a unified score from parallel checks covering dead-code, test results, dependency vulnerabilities, exposed secrets, and outdated gotchas. It also generates a .claude/.next-action file suggesting the highest-impact maintenance task.

Can I use this repo health sweep to validate readiness before a release?

Yes, repo health sweeps are designed for pre-release hygiene validation. They surface high-risk items across dependencies, secrets, and tests early, providing a clear next-action hint to resolve critical issues before deployment.

How do I get a single actionable next-action for repository maintenance?

By running parallel checks on dead-code, tests, dependencies, secrets, and gotchas, the sweep produces a scored roll-up report and writes a .claude/.next-action suggestion for the single highest-impact maintenance task to prioritize.

Does the repository health check modify my code or run in read-only mode?

The repo health sweep operates in read-only mode to analyze repository hygiene without altering code. It aggregates issues into a scored report and outputs a next-action suggestion file without performing automatic fixes.

What is the best way to scan a Git repository for exposed secrets and dependency vulnerabilities?

Running an automated repo health sweep scans Git repositories for exposed secrets and dependency vulnerabilities alongside dead-code and test status. It consolidates findings into a single scored report with actionable maintenance priorities.