Embedding screenshots in GitHub PRs and issues

Why this skill exists

GitHub's native image hosting — the github.com/user-attachments/... URLs you get from drag-and-dropping into the web editor — is only reachable through an authenticated browser session. There is no supported gh CLI or REST API endpoint for it; the web UI signs the upload with a session cookie, not a token. So when you write a PR/issue body with gh ... --body-file, any image URL must already point at something publicly hosted.

The fix: upload the image to a Cloudflare R2 bucket you control that serves publicly over a custom domain, then reference that https://<your-domain>/<key> URL in the markdown. No repo bloat, no browser, no session — and stable URLs.

One-time setup