read-github
Read and search GitHub repository documentation via gitmcp.io MCP service. **WHEN TO USE:** - User provides a GitHub URL - User mentions a specific repo in owner/repo format - User asks "what does this repo do?", "read the docs for X repo", or similar - User wants to search code or docs within a rep
By am-will · 1,192 installs
npx skills add am-will/codex-skills --skill read-github
Source repository · Upstream listing
Read GitHub Docs
Access GitHub repository documentation and code via the gitmcp.io MCP service.
URL Conversion
Convert GitHub URLs to gitmcp.io:
github.com/owner/repo → gitmcp.io/owner/repo
https://github.com/karpathy/llm council → https://gitmcp.io/karpathy/llm council
CLI Usage
The scripts/gitmcp.py script provides CLI access to repository docs.
List Available Tools
Fetch Documentation
Retrieves the full documentation file (README, docs, etc.):
Search Documentation
Semantic search within repository documentation:
Search Code
Search code using GitHub Search API (exact match):
Fetch Referenced URL
Fetch content from URLs mentioned in documentation:
Direct Tool Call
Call any MCP tool directly:
Tool Names
Tool names are dynamically prefixed with the repo name (underscored):
karpathy/llm council → fetch llm council documentation
facebook/react → fetch react documentation
my org/my repo → fetch my repo documentation
Available MCP Tools
For any repository, these tools are available:
1. fetch {repo} documentation Fetch entire documentation. Call first for general questions.
2. search {repo} documentation Semantic search within docs. Use for specific queries.
3. search {repo} code Search code via GitHub API (exact match). Returns matching files.
4. fetch generic url content Fetch any URL referenced in docs, respecting robots.txt.
Workflow
1. When given a GitHub repo, first fetch documentation to understand the project
2. Use search docs for specific questions about usage or features
3. Use search code to find implementations or specific functions
4. Use fetch url to retrieve external references mentioned in docs