GitHub PR Images

What it does

When your agent uses it

• A request pairs a local image (screenshot
• CleanShot capture
• Before/after) with an existing PR (by number
• Regardless of verb — attach

Example prompts

• “the open PR”
• “s history instead. It also owns the PR”
• “/github-pr-images”

Requirements

• A Bash shell
• Pre-approved tools (allowed-tools): Bash(gh:*), Bash(rtk proxy gh:*), Bash(ruby .claude/skills/github-pr-images/assets/inline_attachments.rb:*), Bash(brew upgrade gh), Bash(cp:*), Bash(bash .claude/skills/github-pr-images/assets/commit_images.sh:*), Bash(curl -sI https://raw.githubusercontent.com/:*), Read, Write, mcp__github__list_pull_requests, mcp__github__get_me, mcp__github__issue_read, mcp__github__add_issue_comment, mcp__github__update_issue_comment

Workflow steps

4 steps, taken from the step headings in SKILL.md.

1. 1Resolve PR context
2. 2The body
3. 3Post it
4. 4Verify

What it can do on your machine

Read from SKILL.md and the folder at commit ba388d8. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash(gh:*)
  • Bash(rtk proxy gh:*)
  • Bash(ruby .claude/skills/github-pr-images/assets/inline_attachments.rb:*)
  • Bash(brew upgrade gh)
  • Bash(cp:*)
  • Bash(bash .claude/skills/github-pr-images/assets/commit_images.sh:*)
  • Bash(curl -sI https://raw.githubusercontent.com/:*)
  • Read
  • Write
  • mcp__github__list_pull_requests

  …and 4 more on the same allowed-tools line.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships script files (Shell and Ruby), which the agent can run.

  Shell commands in SKILL.md call:

  • gh
  • brew
  • ruby

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • github.com

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

GitHub PR Images loads about 1.8k tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 210 tokens; SKILL.md has 763 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~210

When it runs · the whole SKILL.md, loaded when a task matches

~1.8k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~2.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from bikeindex/bike_index at commit ba388d8, republished under its AGPL-3.0 licence (© bikeindex). 763 words, ~1,807 tokens.

name

github-pr-images

description

Embed a local image file into an existing GitHub PR — either in the PR body or as a comment. Trigger when a request pairs a local image (screenshot, .png/.jpg, CleanShot capture, before/after) with an existing PR (by #number, URL, branch name, or "the open PR"), regardless of verb — attach, embed, add, put, post, drop, show, document. Also covers visually documenting test runs, bug repros, UI states, or CI failures on an existing PR. Uploads through `gh`'s `--attach` flag — except in the Claude Code web sandbox, which has no `gh` and hosts images through the PR branch's history instead. It also owns the PR's one `## Screenshots` comment — finding, creating, editing and verifying it — so other workflows (the `pr` skill's screenshot phase) hand it a composed body that references local image paths, and it posts it.

allowed-tools

Bash(gh:*), Bash(rtk proxy gh:*), Bash(ruby .claude/skills/github-pr-images/assets/inline_attachments.rb:*), Bash(brew upgrade gh), Bash(cp:*), Bash(bash .claude/skills/github-pr-images/assets/commit_images.sh:*), Bash(curl -sI https://raw.githubusercontent.com/:*), Read, Write, mcp__github__list_pull_requests, mcp__github__get_me, mcp__github__issue_read, mcp__github__add_issue_comment, mcp__github__update_issue_comment

gh help pr comment | grep -q -- --attach || brew upgrade gh

gh pr view --json number,url -q '"\(.number) \(.url)"'

cp /path/to/CleanShot*keyword*.png tmp/screenshot.png

## Screenshots

<img src="tmp/screenshot.png" width="500">

ME=$(gh api user --jq .login)
gh api --paginate "repos/{owner}/{repo}/issues/$PR_NUMBER/comments" \
  --jq ".[] | select(.user.login == \"$ME\") | {id, body: .body[:14]}"

gh api --paginate "repos/{owner}/{repo}/issues/$PR_NUMBER/comments" --jq ".[] | select(.user.login == \"$ME\") | .id" | tail -1

ruby .claude/skills/github-pr-images/assets/inline_attachments.rb {owner}/{repo} <comment-id>

gh api repos/{owner}/{repo}/issues/comments/<id> --jq .body

© bikeindex, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references, assets) in .claude/skills/github-pr-images of bikeindex/bike_index.

• SKILL.md
• assets/commit_images.sh
• assets/inline_attachments.rb
• references/web-sandbox.md

Open the folder on GitHubat commit ba388d8