SkillAgentSearch skills...

Repocheckai

Agentic CLI Tool for GitHub Repository Health Analysis

GenerateConvertImprove

Install / Use

/learn @glaucia86/Repocheckai
About this skill

Quality Score

0/100

Supported Platforms

GitHub Copilot

README

<p align="center"> <img src="resources/banner.svg" alt="RepoCheckAI Banner" width="700"/> </p> <h1 align="center">🩺 RepoCheckAI</h1> <p align="center"> <strong>AI-powered GitHub Repository Health Analyzer</strong><br> Built with the <a href="https://github.com/github/copilot-sdk">GitHub Copilot SDK</a> — the same AI agent runtime that powers Copilot CLI. </p> <p align="center"> <a href="https://github.com/glaucia86/repocheckai/stargazers"> <img src="https://img.shields.io/github/stars/glaucia86/repocheckai?style=for-the-badge&logo=github&color=yellow" alt="Stars"/> </a> <a href="https://github.com/glaucia86/repocheckai/fork"> <img src="https://img.shields.io/github/forks/glaucia86/repocheckai?style=for-the-badge&logo=github&color=blue" alt="Forks"/> </a> <a href="https://github.com/glaucia86/repocheckai/actions/workflows/ci.yml"> <img src="https://github.com/glaucia86/repocheckai/actions/workflows/ci.yml/badge.svg?style=for-the-badge" alt="CI"/> </a> <a href="https://www.npmjs.com/package/repocheckai"> <img src="https://img.shields.io/npm/v/repocheckai?style=for-the-badge&color=cb3837" alt="npm version"/> </a> <a href="https://codecov.io/gh/glaucia86/repocheckai"> <img src="https://img.shields.io/codecov/c/github/glaucia86/repocheckai?style=for-the-badge" alt="Coverage"/> </a> <a href="LICENSE"> <img src="https://img.shields.io/badge/license-MIT-green?style=for-the-badge" alt="License"/> </a> <a href="https://libraries.io/github/glaucia86/repocheckai"> <img src="https://img.shields.io/librariesio/github/glaucia86/repocheckai?style=for-the-badge" alt="Dependencies"/> </a> <a href="https://bundlephobia.com/package/repocheckai"> <img src="https://img.shields.io/bundlephobia/min/repocheckai?style=for-the-badge" alt="Bundle Size"/> </a> </p> <p align="center"> <a href="https://glaucia86.github.io/repocheckai/">Website</a> • <a href="#-quick-start">Quick Start</a> • <a href="#-features">Features</a> • <a href="#-how-it-works">How It Works</a> • <a href="#-commands">Commands</a> • <a href="#-documentation">Documentation</a> </p>

📖 Overview

RepoCheckAI is your repository's AI doctor that diagnoses issues and prescribes solutions. It performs comprehensive health checks across 6 critical areas — documentation, developer experience, CI/CD, testing, governance, and security — delivering a detailed diagnosis with prioritized findings (P0/P1/P2) and actionable remediation steps.

Two Analysis Modes

| Mode | Description | Use Case | |------|-------------|----------| | 🔍 Quick Scan | Analyzes via GitHub API (up to 20 file reads) | Fast checks, governance review | | 🔬 Deep Analysis | Full source scan using Repomix | Code quality, architecture review |

✨ Features

<table> <tr> <td width="50%">

🤖 AI-Powered Analysis

  • 11+ AI Models — GPT-4o, Claude Sonnet 4, GPT-5.3-Codex, o3, and more
  • Contextual Understanding — Adapts to your stack
  • Evidence-Based — Every finding backed by file evidence
</td> <td width="50%">

📊 Comprehensive Reports

  • Health Score — Overall percentage (0-100%)
  • Prioritized Findings — P0 (critical), P1 (high), P2 (suggestions)
  • Actionable Steps — Code snippets included
</td> </tr> <tr> <td width="50%">

💬 Interactive CLI

  • Slash Commands — /analyze, /deep, /copy, /export
  • Chat Interface — Ask follow-up questions
  • Streaming Output — Real-time analysis
</td> <td width="50%">

Auto-Publish Issues

  • One-Click Issue Creation — --issue flag creates structured GitHub issues
  • Prioritized Findings — P0/P1/P2 labels with detailed descriptions
  • Team Collaboration — Automated tracking of repository health issues
  • CI/CD Integration — Perfect for automated health checks
</td> </tr> <tr> <td width="50%">

🔐 Security First

  • Prompt Injection Protection — File content treated as data
  • Token Management — Secure GitHub authentication
  • No Data Storage — Analysis runs locally
</td> </tr> </table>

📢 Publishing Features

Automatically publish analysis reports to GitHub as structured issues:

🚀 Auto-Create Issues for Each Problem Found

export GITHUB_TOKEN=ghp_xxx          # or REPOCHECKAI_GITHUB_TOKEN, as configured
repocheck analyze owner/repo --issue
# Creates: 🔴 [RepoCheckAI] docs: Missing README
#         🟠 [RepoCheckAI] ci: No CI/CD Pipeline
#         🟡 [RepoCheckAI] dx: Code Quality Issues

Each issue includes:

  • Detailed description with evidence and impact assessment
  • Actionable fix instructions with code examples
  • Priority labels (P0/P1/P2) and category tags
  • Full analysis context for team collaboration

💬 Interactive Mode

# Set token securely (recommended)
export GITHUB_TOKEN=ghp_your_token_here

# Or use gh CLI auth
gh auth login

# Then start interactive mode
repocheck chat
/analyze facebook/react --issue
/deep microsoft/vscode

[!TIP] Perfect for automated repository health tracking and team collaboration!

📖 Learn how to set up GitHub tokens

� Quick Start (5 minutes)

Want to see RepoCheckAI create GitHub issues automatically?

# 1. Get a GitHub token (see detailed setup below)
# 2. Set it as environment variable
export GITHUB_TOKEN=ghp_your_token_here

# 3. Analyze and create issues automatically!
repocheck analyze your-username/your-repo --issue

Result: Multiple GitHub issues created with detailed analysis, impact assessment, and fix instructions! 🎉

🔑 Setting up GitHub Token

For the --issue feature, you'll need a GitHub Personal Access Token with specific permissions:

  1. Go to github.com/settings/tokens
  2. Generate a new "Tokens (classic)"
  3. Select these scopes:
    • repo (full repository access) OR the following granular permissions:
      • metadata — Read repository metadata
      • contents — Read repository contents
      • issues — Create and manage issues
  4. Copy the token (starts with ghp_)

[!IMPORTANT] 📖 Complete setup guide with screenshots

🧭 Issue Publishing TL;DR

--issue (CLI) and Publish to GitHub Issues (Web UI) both need GitHub API credentials with issue-write permission.

CLI

export GITHUB_TOKEN=ghp_your_pat_here
repocheck analyze owner/repo --issue

Web UI

npm run dev:local-ui

In the form:

  1. Enable Publish to GitHub Issues
  2. Optional: paste GitHub Token (overrides server env token)
  3. Run analysis

If no token is provided in the field, the backend uses GITHUB_TOKEN from the server environment.

For full step-by-step setup and 401/403 troubleshooting, see docs/issue-publishing.md.

| Category | What's Checked | Example Findings | |----------|----------------|------------------| | 📚 Docs & Onboarding | README, setup instructions, contributing guidelines | Missing installation steps | | ⚡ Developer Experience | Build scripts, language version, project structure | No .nvmrc or .node-version | | 🔄 CI/CD | GitHub Actions, test automation, build pipelines | No CI workflow found | | 🧪 Quality & Tests | Test framework, linting, formatting, coverage | Missing test configuration | | 📋 Governance | LICENSE, CODE_OF_CONDUCT, SECURITY policy | No LICENSE file | | 🔐 Security | Dependabot/Renovate, security policy, secret scanning | No dependency updates configured |

🚀 Quick Start

Prerequisites

[!IMPORTANT]

  • GitHub Copilot — Active subscription required
  • Node.js — Version 18.0.0 or higher

Installation

# Clone the repository
git clone https://github.com/glaucia86/repocheckai.git
cd repocheckai

# Install dependencies and build
npm install
npm run build

# Link globally
npm link

Usage

# Interactive mode
repocheck

# Direct analysis
repocheck vercel/next.js

# Deep analysis with premium model
repocheck vercel/next.js --model claude-sonnet-4 --deep

# 🚀 Auto-create GitHub issues for each problem found
repocheck vercel/next.js --issue

[!NOTE] --issue requires a GitHub token. Learn how to set it up.

🔧 How It Works

alt text

📖 Commands

| Command | Description | |---------|-------------| | /analyze <repo> | Quick analysis via GitHub API | | /deep <repo> | Deep analysis with full source scan | | /copy | Copy last report to clipboard | | /export [path] | Save report as markdown file | | /model [name] | Switch AI model (now works in onboarding phase) | | /help | Show all available commands | | /quit | Exit RepoCheckAI |

[!TIP] Use /deep for comprehensive code quality analysis. Use /analyze for quick governance checks.

🗂️ Repository Layout

The repository keeps application runtime code in src/ and the public website in site/:

site/          # Static marketing/docs site deployed to GitHub Pages
src/           # Clean architecture runtime code

Implementation source is now organized by clean architecture layers in src/:

  • Presentation: src/presentation/** (CLI, API, Web UI, terminal UI)
  • Application: src/application/** (analysis and reporting orchestration)
  • Infrastructure: src/infrastructure/** (GitHub/providers/tools adapters)
  • Domain: src/domain/** (schemas, contracts, interfaces)
  • Shared utilities: src/utils/**

🖥️ Local Web UI

The project has a single Web UI implementation served from src/presentation/web/public by src/presentation/web/main.ts.

npm run dev:web-ui:api
npm run dev:web-ui

Or run both services together:

npm run dev:local-ui

Current MVP ca

glaucia86

View profile

View on GitHub
GitHub Stars109
CategoryDevelopment
Updated1d ago
Forks9
glaucia86/repocheckai

Languages

TypeScript

Security Score

100/100

Audited on Apr 1, 2026

No findings