repo-health

Validate documentation, configurations, and task definitions before commits or pushes.

32|4|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/sourcegraph/CodeScaleBench --skill repo-health-sourcegraph
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-health
Source: https://github.com/sourcegraph/CodeScaleBench/tree/main/skills/repo-health
Command: npx skills add https://github.com/sourcegraph/CodeScaleBench --skill repo-health-sourcegraph

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill prevents code drift and keeps branches clean by running automated checks before commits or pushes, catching issues early.

Core Features & Use Cases

  • Pre-commit/push validation: Ensures documentation, configurations, and task definitions are consistent and valid.
  • Drift reduction: Catches documentation inconsistencies and broken references.
  • Use Case: After updating task definitions in benchmarks/, run this skill to ensure all changes are valid and won't cause CI failures.

Quick Start

Run the repo health gate before pushing your changes.

Frequently Asked Questions about repo-health

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

FAQPage Schema
How do I run pre-commit checks to prevent code drift and maintain branch hygiene?

A pre-commit validation gate checks documentation, configurations, and task definitions to prevent code drift and maintain clean branches. It uses Python scripts to execute validation checks before commits or pushes are finalized.

How do I validate task definitions and configurations before pushing to CI?

Validating task definitions before pushing requires running automated checks that verify configurations and references are consistent. This prevents broken references and ensures changes in directories like benchmarks will not cause CI failures.

What is a repository health gate and how does it improve code quality?

A repository health gate is an automated pre-push validation process that improves code quality by catching documentation inconsistencies and configuration drift before commits. It ensures task definitions and references remain valid across branches.

Do I need Python scripts to set up pre-push hooks for repository health checks?

Yes, Python scripts are required to execute the repository health checks and define the validation configurations. These scripts power the pre-push hook logic that validates task definitions and prevents drift before commits.

What is the best way to catch documentation inconsistencies in a git pre-commit hook?

The best way to catch documentation inconsistencies in a pre-commit hook is to run a repository health gate that validates references and configurations. This automated drift reduction prevents broken links and invalid task definitions from entering clean branches.