Installation

Prerequisites

GHS requires two tools:

1. Claude Code — Anthropic's CLI agent that runs the skills
2. GitHub CLI (gh) — GitHub's official command-line interface for API interactions

Setup

1. Install Claude Code

Follow the official installation guide:

npm install -g @anthropic-ai/claude-code

Verify the installation:

claude --version

2. Install and Authenticate the GitHub CLI

Install gh using your package manager:

macOS

brew install gh

Linux (Debian/Ubuntu)

sudo apt install gh

Windows

winget install GitHub.cli

Then authenticate with your GitHub account:

gh auth login

Follow the interactive prompts to authenticate via browser or token. GHS needs at minimum read access to scan repositories, and write access to create branches, push commits, and open pull requests.

Verify authentication:

gh auth status

3. Clone GHS

git clone https://github.com/Atypical-Consulting/GitHubSkills.git
cd GitHubSkills

4. Verify

Open Claude Code in the GHS directory:

claude

Skills are auto-discovered from .claude/skills/. To confirm everything is working, type:

What skills are available?

Claude will list all 9 GHS skills with their descriptions and trigger phrases.

Required: GitHub Projects scope

GHS stores all findings in GitHub Projects (ProjectsV2). Ensure your gh token includes the project scope:

gh auth login --scopes repo,read:org,project

Score calculation and item discovery are done with jq pipelines against the GitHub Projects API — no local files or Python scripts are required.

Next Steps

• Run your first scan to see GHS in action
• Learn the core concepts behind the health loop and scoring system
• Troubleshooting if you run into issues