Agent skill · writing content · aiskillstore
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 repo
Why this skill is useful
Adds executable scripts for fetching and searching GitHub repository documentation that the AI wouldn't reliably generate on its own.
What it needs
Requires python3 installed locally. About 1k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
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 → fetchllmcouncildocumentation facebook/react → fetchreactdocumentation my-org/my-repo → fetchmyrepodocumentation 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. fetchgenericurlcontent - 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
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/read-github