Agent skill · writing content · sundial-org
read-github
Read GitHub repos the RIGHT way - via gitmcp.io instead of raw scraping. Why this beats web search: (1) Semantic search across docs, not just keyword matching, (2) Smart code navigation with accurate file structure - zero hallucinations on repo layout, (3) Proper markdown output optimized for LLMs, not raw HTML/JSON garbage, (4) Aggregates README + /docs + code in one clean interface, (5) Respects rate limits and robots.txt. Stop pasting raw GitHub URLs - use this instead.
Why this skill is useful
Adds a set of executable scripts for semantic search and documentation retrieval that enhance the AI's ability to interact with GitHub repositories.
What it needs
Requires python3 installed locally. About 1k tokens when loaded. Last updated 2026-03-07. 639 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 sundial-org/read-github