Read Github

This connects Claude to GitHub repos through the gitmcp.io MCP service, letting you fetch READMEs, search documentation semantically, and query code without leaving your conversation. You get four tools per repo: fetch full docs, search docs, search code via GitHub's API, and pull referenced URLs. The URL conversion is dead simple (github.com/owner/repo becomes gitmcp.io/owner/repo), and tool names auto-prefix with the repo name. Honestly most useful when you're asking "what does this project do" or hunting for specific implementation details. Beats context-switching to a browser when you're already in a flow with Claude.

skills.sh installs: 1.2K
GitHub stars: 1K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add am-will/codex-skills --skill read-github --agent claude-code

Installs into .claude/skills of the current project.

Files

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

python3 scripts/gitmcp.py list-tools owner/repo

Fetch Documentation

Retrieves the full documentation file (README, docs, etc.):

python3 scripts/gitmcp.py fetch-docs owner/repo

Search Documentation

Semantic search within repository documentation:

python3 scripts/gitmcp.py search-docs owner/repo "query"

Search Code

Search code using GitHub Search API (exact match):

python3 scripts/gitmcp.py search-code owner/repo "function_name"

Fetch Referenced URL

Fetch content from URLs mentioned in documentation:

python3 scripts/gitmcp.py fetch-url owner/repo "https://example.com/doc"

Direct Tool Call

Call any MCP tool directly:

SKILL.md on GitHub

Details

Repository: github.com/am-will/codex-skills
Categories: Git & Pull Requests, Documentation, Code Review & Quality, AI & Agent Building

More from am-will/codex-skills

All 19