read-githubRead 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.
Install via ClawdBot CLI:
clawdbot install am-will/read-githubAccess GitHub repository documentation and code via the gitmcp.io MCP service.
Convert GitHub URLs to gitmcp.io:
github.com/owner/repo → gitmcp.io/owner/repohttps://github.com/karpathy/llm-council → https://gitmcp.io/karpathy/llm-councilThe scripts/gitmcp.py script provides CLI access to repository docs.
python3 scripts/gitmcp.py list-tools owner/repoRetrieves the full documentation file (README, docs, etc.):
python3 scripts/gitmcp.py fetch-docs owner/repoSemantic search within repository documentation:
python3 scripts/gitmcp.py search-docs owner/repo "query"Search code using GitHub Search API (exact match):
python3 scripts/gitmcp.py search-code owner/repo "function_name"Fetch content from URLs mentioned in documentation:
python3 scripts/gitmcp.py fetch-url owner/repo "https://example.com/doc"Call any MCP tool directly:
python3 scripts/gitmcp.py call owner/repo tool_name '{"arg": "value"}'Tool names are dynamically prefixed with the repo name (underscored):
karpathy/llm-council → fetch_llm_council_documentationfacebook/react → fetch_react_documentationmy-org/my-repo → fetch_my_repo_documentationFor any repository, these tools are available:
Generated Mar 1, 2026
Developers new to an open source repository can quickly understand its structure and documentation without manually navigating GitHub. This skill fetches comprehensive docs and enables semantic search to answer specific questions about usage, accelerating contribution setup.
Investors or analysts evaluating a tech startup's codebase can use this skill to access and search repository documentation and code efficiently. It provides accurate file layouts and semantic insights, reducing time spent on manual code reviews and minimizing errors in assessment.
Instructors or tutorial creators preparing materials based on GitHub projects can fetch and search documentation to gather accurate information. This ensures content is up-to-date and correctly references code examples, enhancing learning resources for students.
Teams integrating third-party libraries or APIs from GitHub into their systems can use this skill to quickly access documentation and search for specific code implementations. It streamlines the integration process by providing clean, structured data without rate limit issues.
Security auditors can leverage this skill to fetch and search repository docs and code for compliance checks or vulnerability assessments. The accurate file structure and semantic search help identify relevant sections quickly, improving audit efficiency and accuracy.
Offer basic access to gitmcp.io for free with limited searches or repositories, while charging for premium features like advanced semantic search, higher rate limits, and enterprise support. This model attracts individual developers and scales up to teams.
Monetize the underlying MCP service by providing API access to gitmcp.io for other developers or companies to integrate into their tools. Charge based on API call volume or data processed, catering to businesses building on top of the service.
Sell customized versions of the skill or gitmcp.io service to large organizations for internal use, with features like enhanced security, dedicated support, and compliance with corporate policies. This targets industries with strict data handling requirements.
💬 Integration Tip
Start by converting GitHub URLs to gitmcp.io format and use the fetch documentation tool first to get an overview before diving into specific searches for efficient workflow integration.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Query the DeepWiki MCP server for GitHub repository documentation, wiki structure, and AI-powered questions.
Automated GitHub PR code review with diff analysis, lint integration, and structured reports. Use when reviewing pull requests, checking for security issues,...
Essential Git commands and workflows for version control, branching, and collaboration.
Advanced git operations beyond add/commit/push. Use when rebasing, bisecting bugs, using worktrees for parallel development, recovering with reflog, managing subtrees/submodules, resolving merge conflicts, cherry-picking across branches, or working with monorepos.
Format commit messages using the Conventional Commits specification. Use when creating commits, writing commit messages, or when the user mentions commits, git commits, or commit messages. Ensures commits follow the standard format for automated tooling, changelog generation, and semantic versioning.