← Back to Skills Marketplace
am-will

Read GitHub

by am-will · GitHub ↗ · v1.0.1
cross-platform ⚠ suspicious
4785
Downloads
3
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install read-github
Description
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.
Usage Guidance
Install only if you are comfortable with the skill making remote requests through gitmcp.io and with agents having access to its broad `fetch-url` and `call` commands. Prefer using the scoped `fetch-docs`, `search-docs`, and `search-code` commands, and avoid allowing arbitrary external URLs or direct MCP tool calls unless you have reviewed the target and trust the remote service.
Capability Analysis
Type: OpenClaw Skill Name: read-github Version: 1.0.1 The skill is classified as suspicious due to the broad capabilities exposed by the `scripts/gitmcp.py` script. Specifically, the `fetch-url` command allows fetching content from arbitrary URLs provided by the user, which could lead to Server-Side Request Forgery (SSRF) or access to internal network resources if the `gitmcp.io` service does not adequately restrict target URLs. Additionally, the `call` command allows invoking any tool on the `gitmcp.io` service with arbitrary JSON arguments, providing a wide attack surface if the service exposes powerful or unintended functionalities. While the `SKILL.md` instructions are benign, the underlying script provides these risky capabilities.
Capability Assessment
Purpose & Capability
The main purpose is reading GitHub documentation and code through gitmcp.io, but the script also exposes a generic MCP tool-call command and a URL-fetch command that is not technically limited to GitHub or documented references.
Instruction Scope
SKILL.md documents the broad commands, including direct tool calls, but does not set clear boundaries, allowlisted tools, confirmation requirements, or destination limits for non-GitHub URL fetching.
Install Mechanism
There is no standalone installer or persistence mechanism, but each command launches `npx -y mcp-remote`, which may fetch and run the MCP bridge package in the user's environment.
Credentials
Network access to gitmcp.io is expected, but the artifact allows user-supplied MCP URLs/tool names through the repo argument and direct-call path, making the effective network/service authority broader than the advertised GitHub-read workflow.
Persistence & Privilege
No artifact evidence shows background persistence, privilege escalation, credential harvesting, local file mutation, or destructive behavior.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install read-github
  3. After installation, invoke the skill by name or use /read-github
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Improved description - explains why gitmcp.io beats raw GitHub scraping
v1.0.0
Initial release - Access GitHub repos via gitmcp.io MCP service
Metadata
Slug read-github
Version 1.0.1
License
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is 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. It is an AI Agent Skill for Claude Code / OpenClaw, with 4785 downloads so far.

How do I install Read GitHub?

Run "/install read-github" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Read GitHub free?

Yes, Read GitHub is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Read GitHub support?

Read GitHub is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Read GitHub?

It is built and maintained by am-will (@am-will); the current version is v1.0.1.

💬 Comments