AUDITOR
README
SEO
LEGAL
Built for Claude Code // Repository Optimization
Claude GitHub - Repository Optimization Suite for Claude Code
Most GitHub repos have no keywords in the description, no structured README, missing license files, zero community health signals. Search engines skip them. Developers scroll past. Claude GitHub scores your repo 0-100 and generates every fix.
$
git clone https://github.com/avalonreset-pro/claude-github.git && cd claude-github && bash install.sh
Works on macOS, Linux, Windows. Requires Claude Code + GitHub CLI.
8
Skills
6
Parallel Agents
6
Audit Categories
9
Reference Guides
<60s
Full Audit
// How It Works
From Invisible to Discoverable
Most GitHub repositories are missing basic discoverability signals. No keywords in the description, no structured README, missing license, no community health files. Search engines and AI assistants skip them entirely. Claude GitHub fixes this in one pass.
Diagnose
Run /github audit
6 agents score your repo simultaneously across README quality, metadata, legal compliance, community health, release management, and search discoverability. You get a 0-100 score with a prioritized remediation plan in under 60 seconds.
Research
Live Keyword Data
The /github seo skill queries DataForSEO for real monthly search volumes, keyword difficulty scores, and competitor SERP analysis. Every recommendation is backed by actual search data, not assumptions about what developers might search for.
Fix
Generate Everything
Each skill generates production-ready files: LICENSE, SECURITY.md, CONTRIBUTING.md, issue templates, CHANGELOG, CI badges, and a search-optimized README. Nothing is left as a TODO. Every output is ready to commit.
Verify
Re-audit and Measure
Run the audit again after applying fixes. Compare before and after scores across all 6 categories. Track improvement over time as you optimize your entire portfolio with /github empire.
// All Commands
8 Skills. One Suite.
Every recommendation cites its source: DataForSEO keyword volume, GitHub API metadata, codebase analysis, or reference guides. Nothing is guesswork.
/github audit
Score any repo 0-100 across 6 categories with prioritized fixes. Spawns 6 agents in parallel.
/github legal
Select a license, generate SECURITY.md, CITATION.cff, handle fork compliance and attribution.
/github community
Generate issue templates, CONTRIBUTING.md, CODE_OF_CONDUCT.md, .gitattributes, CI workflow, devcontainer.
/github release
Plan release strategy, CHANGELOG, badges, semantic versioning, and package distribution.
/github seo
Run keyword research with real search volume and difficulty data from DataForSEO.
/github meta
Optimize description, topics, homepage URL, feature toggles, and social preview image.
/github readme
Generate or rewrite your README with search-optimized headings and AI-generated banner images.
/github empire
Portfolio strategy, profile README, AI avatar generation, cross-linking, and topic sync.
// How Scoring Works
0-100 Health Score
6 specialized agents score your repo in parallel. Each uses a detailed rubric with specific point values, not subjective impressions.
| Category | Weight | What It Checks |
|---|---|---|
| README Quality | 25% | Structure, headings, badges, table of contents, code examples |
| Metadata and Discovery | 20% | Description keywords, topics, homepage URL, feature toggles |
| Legal Compliance | 15% | License file, SECURITY.md, CITATION.cff, fork obligations |
| Community Health | 15% | Issue templates, CONTRIBUTING, CODE_OF_CONDUCT, devcontainer |
| Release and Maintenance | 15% | Releases, CHANGELOG, CI badges, dependabot, recency |
| SEO and Discoverability | 10% | Keyword placement, GitHub Explore signals, AI citability |
// Installation
5-Minute Setup
The installer copies all skills and configures DataForSEO + KIE.ai for live keyword data and AI-generated banner images.
// Standard Operating Procedure
Follow the SOP
The audit generates a numbered remediation plan. Run each skill in order. Each one hands off to the next.
Step 0
/github audit
Diagnose: scores 6 categories, generates your SOP
Step 1
/github legal
Foundation: license, compliance, fork obligations
Step 2
/github community
Infrastructure: templates, CoC, devcontainer
Step 3
/github release
Versioning: CHANGELOG, badges, catch-up releases
Step 4
/github seo
Research: keyword data for description and README
Step 5
/github meta
Settings: description, topics, features (uses keyword data)
Step 6
/github readme
Capstone: README optimization (uses everything above)
Step 7
/github audit
Measure: re-audit to verify improvement
// FAQ
Questions
Claude Code skills are markdown instruction files (SKILL.md) that extend Claude Code with specialized capabilities. They follow the Agent Skills open standard, meaning any SKILL.md file placed in ~/.claude/skills/ is automatically loaded when Claude Code starts. Each skill defines a trigger pattern (like /github audit), reference files it needs, and sub-agents it can spawn. For example, the Claude GitHub audit skill triggers on "/github audit", loads 9 reference guides covering README scoring rubrics, legal compliance checklists, and SEO best practices, then spawns 6 parallel scoring agents. Skills are plain markdown with YAML frontmatter, so they are easy to read, edit, and version control alongside your code. No compilation or build step is required.
Run the installer from your terminal: bash install.sh on macOS/Linux or .\install.ps1 on Windows. The installer copies all 8 skill files to ~/.claude/skills/github/, sets up the DataForSEO MCP server configuration in ~/.claude/.mcp.json, and optionally configures KIE.ai for AI-generated banner images. After installation, restart Claude Code and the skills are available immediately. Type /github to see all available commands. The installer also validates your environment, checking for Claude Code CLI, GitHub CLI (gh), and Node.js. If DataForSEO credentials are not provided during installation, all skills still work using fallback analysis from the GitHub API and built-in reference guides, though keyword recommendations will be marked as unverified.
No. Every skill works without DataForSEO by falling back to codebase analysis, GitHub API data, and 9 built-in reference guides. The /github audit, /github legal, /github community, /github release, /github readme, /github meta, and /github empire commands all function independently. However, keyword recommendations from /github seo will be marked "unverified" without live search data. DataForSEO adds real monthly search volume numbers, keyword difficulty scores, SERP competitor analysis, and search intent classification. A typical single-repo audit costs about 15-30 cents in API credits. Portfolio audits with /github audit username cost proportionally more depending on the number of repos analyzed.
Skills are instruction files (SKILL.md) that Claude loads based on trigger patterns in your message, like "/github audit" or "/github readme". They define what to do, which reference files to consult, and what agents to spawn. Agents are independent sub-processes that skills dispatch to run tasks in parallel. Each agent gets its own context window and can use tools like file reading, web fetching, and code analysis. In Claude GitHub, the /github audit skill spawns 6 scoring agents simultaneously: one each for README Quality, Metadata and Discovery, Legal Compliance, Community Health, Release and Maintenance, and SEO Discoverability. They all run at the same time, so a full audit completes in under 60 seconds instead of running each check sequentially.
Run /github audit and 6 specialized agents score your repository in parallel. Each agent evaluates a specific category using a detailed rubric with specific point values, not subjective impressions. The categories and their weights are: README Quality (25%) checks structure, headings, badges, code examples, and table of contents. Metadata and Discovery (20%) evaluates description keywords, topics, homepage URL, and feature toggles. Legal Compliance (15%) verifies license files, SECURITY.md, CITATION.cff, and fork obligations. Community Health (15%) checks issue templates, CONTRIBUTING.md, and CODE_OF_CONDUCT.md. Release and Maintenance (15%) looks at CHANGELOG, CI badges, and semantic versioning. SEO and Discoverability (10%) analyzes keyword placement and AI citability. The final score is a weighted sum of all six categories.
Yes. Run /github audit username to quick-scan all public repositories under that GitHub account. The skill fetches repository metadata via the GitHub API, ranks repos by stars, forks, and recent activity, then selects the top candidates for deep analysis. Each selected repo gets a full 6-agent parallel audit. The output is a cross-portfolio report highlighting shared patterns (like missing licenses across multiple repos) and a prioritized remediation plan. After fixing individual repos, use /github empire for profile-level optimization including generating a profile README, setting up cross-linking between repositories, synchronizing topics, and creating an AI-generated avatar that matches your project branding.
STOP BEING INVISIBLE.
8 skills. 6 parallel agents. Live keyword data. One install command. Your repos deserve to be found.
// Built By
Meet the Developer
About Claude GitHub
Claude GitHub is a repository optimization suite built for Claude Code. It provides 8 specialized skills and 6 parallel scoring agents that audit, score, and fix GitHub repositories across README quality, metadata and discovery, legal compliance, community health, release management, and SEO discoverability. Every recommendation is data-backed through DataForSEO integration for live keyword research, and KIE.ai for AI-generated banner images. Built by Avalon Reset. Scaffolded with skill-forge. Search optimization methodology adapted from Claude SEO.