Readable github
Reads GitHub via the gh CLI — repo metadata / README / file tree, issues with comments and timeline, pull requests (diff, files, inline comments, GraphQL review threads with isResolved / isOutdated), discussions (GraphQL), code (file contents and code search), and releases (with tarball / zipball fallback). Routes by URL shape into references/{topic}.md so only the relevant command sheet is loaded. Use when the URL is on github.com.From its SKILL.md
npx -y skills add yamadashy/agent-readable --skill readable-githubAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
- runs commandsInstructs the agent to run 3 commands, including `gh auth status` and 2 more.
SKILL.md
2.0 KB, 406 tokens by cl100k_base, as published. Nobody here has run it
GitHub Reader
Uses the gh CLI (which calls the GitHub REST/GraphQL API) for everything. The CLI handles auth, pagination, and rate limiting; AUP exempts API access from its scraping clauses.
Prerequisite
gh auth status
If not logged in: gh auth login.
Pick the right reference
Identify what kind of GitHub URL the user supplied, then follow the matching reference file:
| URL shape | Reference |
|---|---|
github.com/{owner}/{repo} (root, README, file tree) | references/repo.md |
github.com/{owner}/{repo}/issues/... | references/issues.md |
github.com/{owner}/{repo}/pull/... | references/pulls.md |
github.com/{owner}/{repo}/discussions/... | references/discussions.md |
github.com/{owner}/{repo}/blob/..., tree/..., code search | references/code.md |
github.com/{owner}/{repo}/releases/... | references/releases.md |
For Gist URLs (gist.github.com/...), use the readable-gist skill instead.
General tips
- Prefer
ghsubcommands (gh repo,gh issue,gh pr, ...) where they exist; fall back togh apifor endpoints they don't cover. - Use
--json {fields}to keep responses small. Each subcommand documents its--jsonfield set; rungh {sub} view --helpto list them. - Rate limit: 5,000 req/hour for authenticated users.
gh api rate_limitreports current usage.
What ships with it: 6 files
10.9 KB alongside SKILL.md
references/
- code.md1.5 KB
- discussions.md1.7 KB
- issues.md1.7 KB
- pulls.md3.4 KB
- releases.md1.3 KB
- repo.md1.2 KB