GitHub Repository Analysis Skill
Automatically triggered when the user wants to analyze a GitHub repository or codebase.
Trigger Phrases
- "analyze this repo"
- "review this GitHub repository"
- "what does this codebase do"
- "explain this project"
- "github.com/..."
- "look at this repository"
- "understand this codebase"
Process
1. Identify the Repository
Determine the repository source:
- GitHub URL:
https://github.com/owner/repo - Short form:
owner/repo - Local path:
./path/to/repo
2. Fetch Repository Content
For GitHub URLs:
- Use
gh repo view owner/repofor metadata - Clone or fetch key files via GitHub API
- Prioritize: README, package files, src/ structure
For local paths:
- Read directory structure
- Identify project type from config files
3. Load Analysis Prompt
Read prompts/github.md for the comprehensive analysis template.
4. Key Files to Examine
Prioritize reading these files:
README.md- Project overviewpackage.json/requirements.txt/Cargo.toml/go.mod- Dependenciessrc/orlib/- Main source code structure.github/workflows/- CI/CD configurationdocker-compose.yml/Dockerfile- Container setuptsconfig.json/pyproject.toml- Build configurationCONTRIBUTING.md- Contribution guidelinesLICENSE- License information
5. Generate Analysis Report
Follow the 13-section structure:
- Repository Overview
- Technology Stack
- Architecture Analysis
- Key Features & Functionality
- Code Quality Indicators
- Getting Started Guide
- Notable Code Patterns
- Contribution Insights
- Dependencies Analysis
- Comparison & Alternatives
- Learning Opportunities
- Latent Signals
- Summary & Recommendations
6. Save Report
Save to: reports/github/YYYY-MM-DD_repo-name.md
Format:
# [Repository Name]
**Source**: [GitHub URL]
**Date**: YYYY-MM-DD
**Type**: GitHub Repository
---
[Analysis content following the 13-section structure]
---
## My Notes
7. Log Activity
Append to logs/YYYY-MM-DD.md:
## Repositories Analyzed
- [Repo Name](../reports/github/filename.md) - HH:MM
Output Directory
Ensure reports/github/ exists before saving.
Example Usage
User: "Can you analyze https://github.com/anthropics/claude-code" Assistant: [Fetches repo, analyzes structure, generates comprehensive report]
User: "What's in this fastapi/fastapi repository?" Assistant: [Analyzes FastAPI framework, documents architecture and patterns]