How do I install the Gitshot skill?

Run npx skillmds@latest add vipulgupta2048/gitshot-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Gitshot safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gitshot?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gitshot free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Gitshot?

vipulgupta2048 (@vipulgupta2048) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gitshot by vipulgupta2048 — Agent Skill

Name: Gitshot
Author: vipulgupta2048

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.

File contents

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

# 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

Uploads image to <user>/gitshot-images repo as a GitHub Release Asset (auto-created on first use)
If --pr, --issue, or --new-issue is set, posts a comment/creates the issue automatically
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)

---name: gitshot-2description: 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.license: MIT---# gitshot — Upload Images to GitHubUpload 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 captionnpx gitshot rick.gif --pr 42 -m "Here's the fix"# Auto-detect PR from current branchnpx gitshot rick.gif --pr# Upload + comment on an issuenpx gitshot rick.gif --issue 10# Upload + create a new issue with imagenpx gitshot bug.png --new-issue "Button is misaligned"# Multiple images + captionnpx gitshot before.png after.png --pr 42 -m "Visual diff"# Just upload, print markdown (no GitHub action)npx gitshot rick.gif# Raw URL onlynpx gitshot --raw rick.gif# JSON output for programmatic usenpx gitshot --json rick.gif```## How It Works1. 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 automatically3. 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)

Frequently asked questions