GHSYour repos deserve better.

How It Works

From scan to merge in four steps

GHS follows a simple loop: scan to find problems and create GitHub Project items, optionally sync to publish findings as GitHub Issues for team visibility, fix to create pull requests (with auto-close references), and merge to land the improvements. Each cycle raises your health score closer to 100%.

Quick Start

Up and running in under a minute

# Clone GHS and open it with Claude Code
git clone https://github.com/Atypical-Consulting/GitHubSkills.git
cd GitHubSkills
claude

Then simply ask:

scan owner/repo

That's it. GHS runs 40 core checks plus language-specific modules (.NET and more coming) — and creates structured GitHub Project items for everything that needs attention.

What Gets Checked

Modular check system — core always runs, language modules activate on detection

Core covers universal best practices: README, LICENSE, CI/CD, branch protection, .editorconfig, CODEOWNERS, issue templates, security, and more across 7 categories.

.NET adds .NET-specific checks: Directory.Build.props, test projects, nullable reference types, central package management, code coverage, analyzers, SourceLink, and more across 4 categories.

When a language module is active, scores are combined: core × 60% + language × 40%. More modules coming soon (Python, Node, Go, Rust).

Terminal Output Preview

## Repository Scan: phmatray/my-dotnet-project

### Core Health Checks

#### Tier 1 — Required
  [PASS] README.md — Found (2.3 KB)
  [PASS] LICENSE — MIT License
  [FAIL] Repository description — Not set
  [PASS] Branch protection — Enabled on main

#### Tier 2 — Recommended
  [PASS] .gitignore — Found
  [PASS] CI/CD workflows — 2 workflows found
  [FAIL] .editorconfig — Not found
  [PASS] CODEOWNERS — Found
  ...

Core Score: 52/74 (70%)

---

### .NET Health Checks

#### Tier 1 — Required
  [PASS] Directory.Build.props — Found
  [PASS] Test Project Exists — 3 test projects

#### Tier 2 — Recommended
  [PASS] Nullable Reference Types — Enabled
  [FAIL] Central Package Management — Not found
  [FAIL] Code Coverage — No coverlet detected
  [PASS] global.json SDK Pinning — net9.0
  ...

.NET Score: 22/34 (65%)

---

### Combined Health Score: 68%
  (core 70% × 60% + .NET 65% × 40%)

  Core:   52/74  ██████░░ (70%)
  .NET:   22/34  █████░░░ (65%)

---

Project items created: phmatray/my-dotnet-project (GHS project)
  health/   — 6 items (5 FAIL, 1 WARN)
  dotnet/   — 3 items (3 FAIL)
  issues/   — 5 items