How do I install the Read Github skill?

Run npx skillmds@latest add am-will/read-github in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Read Github safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Read Github?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Read Github free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Read Github?

am-will (@am-will) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Read Github by am-will — Agent Skill

Name: Read Github
Rating: 4.2 (5 reviews)
Author: am-will

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

am-will Updated Sep 8, 2026

File contents

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:

python3 scripts/gitmcp.py call owner/repo tool_name '{"arg": "value"}'

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:

fetch_{repo}_documentation - Fetch entire documentation. Call first for general questions.
search_{repo}_documentation - Semantic search within docs. Use for specific queries.
search_{repo}_code - Search code via GitHub API (exact match). Returns matching files.
fetch_generic_url_content - Fetch any URL referenced in docs, respecting robots.txt.

Workflow

When given a GitHub repo, first fetch documentation to understand the project
Use search-docs for specific questions about usage or features
Use search-code to find implementations or specific functions
Use fetch-url to retrieve external references mentioned in docs

Source: am-will/codex-skills → skills/read-github/SKILL.md

---name: read-githubdescription: | 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---# Read GitHub DocsAccess GitHub repository documentation and code via the gitmcp.io MCP service.## URL ConversionConvert 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 UsageThe `scripts/gitmcp.py` script provides CLI access to repository docs.### List Available Tools```bashpython3 scripts/gitmcp.py list-tools owner/repo```### Fetch DocumentationRetrieves the full documentation file (README, docs, etc.):```bashpython3 scripts/gitmcp.py fetch-docs owner/repo```### Search DocumentationSemantic search within repository documentation:```bashpython3 scripts/gitmcp.py search-docs owner/repo "query"```### Search CodeSearch code using GitHub Search API (exact match):```bashpython3 scripts/gitmcp.py search-code owner/repo "function_name"```### Fetch Referenced URLFetch content from URLs mentioned in documentation:```bashpython3 scripts/gitmcp.py fetch-url owner/repo "https://example.com/doc"```### Direct Tool CallCall any MCP tool directly:```bashpython3 scripts/gitmcp.py call owner/repo tool_name '{"arg": "value"}'```## Tool NamesTool 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 ToolsFor 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.## Workflow1. When given a GitHub repo, first fetch documentation to understand the project2. Use search-docs for specific questions about usage or features3. Use search-code to find implementations or specific functions4. Use fetch-url to retrieve external references mentioned in docs---**Source:** [`am-will/codex-skills`](https://github.com/am-will/codex-skills) → `skills/read-github/SKILL.md`

Frequently asked questions