ghs-repo-scan

Scan GitHub repositories for best practices and generate scored markdown reports.

2|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/Atypical-Consulting/GitHubSkills --skill ghs-repo-scan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ghs-repo-scan
Source: https://github.com/Atypical-Consulting/GitHubSkills/tree/main/.claude/skills/ghs-repo-scan
Command: npx skills add https://github.com/Atypical-Consulting/GitHubSkills --skill ghs-repo-scan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, git, python3, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automatically checks your GitHub repository against best practices, identifies open issues, and provides a comprehensive health score and actionable backlog items.

Core Features & Use Cases

  • Repository Auditing: Scans for missing files (README, LICENSE, CODEOWNERS), CI/CD setup, branch protection, and security policies.
  • Issue Triage: Organizes open issues and presents them in a structured format.
  • Health Scoring: Calculates a repository health score based on identified issues and best practice adherence.
  • Use Case: Run this Skill when you want to quickly assess the quality and setup of a new or existing repository, identify areas for improvement, and get a clear overview of open tasks.

Quick Start

Use the ghs-repo-scan skill to scan the repository phmatray/NewSLN.

Frequently Asked Questions about ghs-repo-scan

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

FAQPage Schema
How do I audit a GitHub repository for missing files and security policies?

Auditing a GitHub repository involves scanning for missing files like README, LICENSE, CODEOWNERS, and CI/CD configurations, along with checking branch protection rules and security policies to generate a scored health report.

What is a GitHub repository health score and how is it calculated?

A GitHub repository health score evaluates adherence to best practices by identifying missing files, CI/CD setup, branch protection, and security policies, calculating a quantitative score based on predefined logic to represent overall repository quality.

How do I organize open GitHub issues into a structured backlog?

To organize open GitHub issues into a structured backlog, fetch and triage open issues from the repository, presenting them in a structured format and saving the findings as structured markdown backlog items.

Do I need the gh CLI and python3 to scan my repository for best practices?

Yes, you need the gh CLI, git, and python3 installed to scan your repository for best practices, as these dependencies are required to execute the health check, fetch issues, and generate the SUMMARY.md report.

Does a repository health check scan for missing CI/CD configurations and CODEOWNERS?

Yes, a repository health check scans for missing CI/CD configurations and CODEOWNERS files, alongside README, LICENSE, branch protection rules, and security policies to evaluate overall repository quality and setup.

What's the best way to assess the quality and setup of an existing GitHub repository?

The best way to assess an existing GitHub repository's quality is to run an automated scan that checks best practice adherence, identifies missing files, fetches open issues, and produces a comprehensive health score with actionable backlog items.