Skip to main content
affpapa.org
RU EN
skill CX Codex

read-github — Claude Code skill: read GitHub docs via gitmcp.io

Lets the agent pull documentation and code from any GitHub repository through the gitmcp.io MCP service. Useful when you need to understand a project without cloning it.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add am-will/codex-skills --skill read-github -a claude-code
Open on GitHub

What read-github does

The skill turns a repository link into a source of answers. Hand the agent a URL like github.com/owner/repo or just owner/repo, and it fetches the README and other documentation files through gitmcp.io. A script at scripts/gitmcp.py does the work, with subcommands list-tools, fetch-docs, search-docs, search-code, fetch-url, and call for hitting an MCP tool directly.

Doc search is semantic; code search goes through the GitHub Search API and matches exactly. Tool names get prefixed with the repo name on the fly: facebook/react becomes fetch_react_documentation, my-org/my-repo becomes fetch_my_repo_documentation. Dashes turn into underscores.

The script runs under python3, so Python has to be on your machine. External links mentioned in the docs are fetched separately and robots.txt is respected — a site that blocks crawlers returns nothing. Worth remembering when an answer about a linked page comes back empty.

What it helps with

  • read a repo's README without cloning it
  • find a specific function in a codebase by name
  • answer a question about a library from its own docs
  • pull content from an external link cited in the documentation
  • check which MCP tools a repository exposes

Example prompts for the agent

  • Read the docs for facebook/react and explain how rendering works
  • Search the karpathy/llm-council code for the request handler
  • What does owner/repo do? Look at its documentation

How to install read-github

1Skills CLI (Vercel)

npx skills add am-will/codex-skills --skill read-github -a claude-code

2Manually: put the files in place

~/.claude/skills/read-github/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/read-github/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about read-github

How do I install read-github in Claude?

Run npx skills add am-will/codex-skills --skill read-github -a claude-code. The skill file lands at ~/.claude/skills/read-github/SKILL.md.

What does read-github do?

It reads and searches GitHub repository documentation and code through the gitmcp.io MCP service. Works from a URL or an owner/repo string.

What does the skill need to run?

The scripts/gitmcp.py script runs under python3, so Python must be installed. External links are fetched with robots.txt in mind.

Similar skills

All skills for Agent setup: memory, context, orchestration →
github-research lingzhi227 Finds open-source repositories matching research topics, inspects their codebases, and produces an integration blueprint. Useful when tracking down implementations of algorithms. CX Codex +1 1,800installs github-webhooks hookdeck A skill for receiving and verifying GitHub webhooks: signature checks, event types, and handlers for push, pull_request, issues and release. CX Codex +1 487installs python-github-setup-cursorrules-prompt-file PatrickJS Tells Cursor how to write and review Python code: style, tests, GitHub Pull Requests and GitHub Actions CI. Useful when the team has no shared rulebook. ★ 41,011repo stars github-deep-research bytedance Runs multi-round research on any GitHub repository and writes a structured markdown report with a timeline, metrics and Mermaid diagrams. CX Codex +1 2,900installs github-triage code-yeongyu Reads every open issue and PR in a repo and writes evidence-backed reports. It never comments, merges or closes anything. CX Codex +1 2,700installs github-project-management ruvnet Turns issue triage and board upkeep into gh and ruv-swarm calls: labels, subtasks, duplicate lookup. Useful when the tracker holds more tickets than order. CX Codex +1 1,400installs

From the same set10

role-creator Builds and updates Codex subagent definitions as standalone TOML files. Useful when you need isolated role configs with explicit model settings and developer instructions. CX Codex +1 1,200installs swarm-planner Builds implementation plans that show task dependencies for parallel agent work. Use it before coding changes in an unfamiliar codebase. CX Codex +1 1,200installs gemini-computer-use Runs Gemini 2.5 Computer Use agents with Playwright to drive browser workflows. It captures screenshots, calls UI actions, and prompts for confirmation on risky steps. CX Codex +1 1,200installs llm-council This skill runs several CLI agents as independent planners, strips their identities, and merges the results into one final plan. Useful when a single model's bias is the problem. CX Codex +1 1,200installs Agent Browser A skill that hands your agent a Rust-based headless browser: navigate, click, fill forms and snapshot pages through structured commands. CX Codex +1 1,200installs plan-harder Turns complex requests into structured sprint plans with atomic tasks. Triggers when you tell the agent to plan harder, focusing purely on architecture and risks. CX Codex +1 1,200installs planner Splits bug fixes and feature development into structured sprints and atomic tasks. It helps you design software changes before writing any code. CX Codex +1 1,200installs parallel-task-spark An orchestration skill that runs markdown plan tasks in parallel waves using Sparky subagents with dependency checks. It helps when executing modular plans with strict TDD. CX Codex +1 1,100installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor