# Gitshot

> Upload screenshots and images to GitHub, returning markdown-ready URLs for PRs, issues, and comments. Can upload AND post to PRs/issues in one command. Use when needing to attach images to GitHub PRs/issues, upload screenshots, embed visuals in markdown, or when a workflow produces images that should be shared on GitHub. Trigger words - upload image, attach screenshot, add image to PR, add image to issue, embed screenshot.

- Skill: `vipulgupta2048/gitshot-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vipulgupta2048/gitshot-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vipulgupta2048/gitshot-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- License: MIT
- Author: vipulgupta2048 (https://skillmd.com/u/vipulgupta2048)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vipulgupta2048/gitshot-2

---


# gitshot — Upload Images to GitHub

Upload images and post them to GitHub PRs/issues in one command. No piping needed.

## When to Use This Skill

- User asks to "upload", "attach", or "embed" an image/screenshot to a GitHub PR or issue
- A workflow produces screenshots or images that need to go into a PR comment or issue body
- User asks for a "visual diff", "before/after", or "screenshot" in a PR
- You have taken a screenshot and need to include it in GitHub markdown

## Quick Reference

```bash
# Upload + comment on a PR (ONE command, most common)
npx gitshot rick.gif --pr 42

# Upload + comment on PR with a caption
npx gitshot rick.gif --pr 42 -m "Here's the fix"

# Auto-detect PR from current branch
npx gitshot rick.gif --pr

# Upload + comment on an issue
npx gitshot rick.gif --issue 10

# Upload + create a new issue with image
npx gitshot bug.png --new-issue "Button is misaligned"

# Multiple images + caption
npx gitshot before.png after.png --pr 42 -m "Visual diff"

# Just upload, print markdown (no GitHub action)
npx gitshot rick.gif

# Raw URL only
npx gitshot --raw rick.gif

# JSON output for programmatic use
npx gitshot --json rick.gif
```

## How It Works

1. Uploads image to `<user>/gitshot-images` repo as a GitHub Release Asset (auto-created on first use)
2. If `--pr`, `--issue`, or `--new-issue` is set, posts a comment/creates the issue automatically
3. Always prints the markdown URL to stdout (composable even when posting)

## Key Flags

| Flag | What it does |
|------|-------------|
| `--pr [N]` | Comment on PR (auto-detects from branch if no number) |
| `--issue N` | Comment on issue |
| `--new-issue "title"` | Create new issue with image |
| `-m "text"` | Caption/message to include with image |
| `--raw` | Output raw URL only |
| `--json` | JSON output for scripts |

## Important Notes

- stdout = URLs/markdown only (pipe-safe)
- stderr = status messages
- Exit code 0 = success, 1 = failure
- Supported formats: PNG, JPG, JPEG, GIF, SVG, WebP, BMP, ICO, TIFF, AVIF
- First run auto-creates `<user>/gitshot-images` repo (one-time)