Gitshot Image Uploader

What it does

When your agent uses it

• Attaching a screenshot to a GitHub pull request or issue
• Building a before and after image table for a visual diff
• Embedding a diagram or image in a GitHub markdown comment

Example prompts

• “Upload shot.png and add it as a comment on my open PR.”
• “Take a before and after screenshot and put them in a table in the PR description.”
• “Create an issue for the misaligned button and attach this screenshot.”

Requirements

• Node.js with npx
• An authenticated GitHub CLI (gh), or a Cloudinary or imgbb key

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

1. 1If gh CLI is authenticated (most common): Uploads to /gitshot-images repo as a GitHub Release Asset. Creates the repo automatically on…
2. 2If no gh CLI: Falls back to catbox.moe (free, no signup).
3. 3Optional: Set CLOUDINARY_URL or IMGBB_API_KEY env vars for those backends.

What it can do on your machine

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

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • npx
  • gh

  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 these keys or tokens, usually read from environment variables:

  • IMGBB_API_KEY

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

Context cost

Gitshot Image Uploader loads about 855 tokens when it runs. Until then it costs about 101 tokens; SKILL.md has 236 words of instructions outside code blocks.

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

~101

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

~855

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 trekawek/coffee-gb at commit 554ea56, republished under its MIT licence (© trekawek). 236 words, ~855 tokens.

name

gitshot

description

Upload screenshots and images to GitHub, returning markdown-ready URLs for PRs, issues, and comments. 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, embed screenshot, visual diff, before/after screenshot.

license

MIT

argument-hint

<image-path>

metadata.author

vipulgupta2048

metadata.version

0.0.1

# Upload one image — returns markdown
npx gitshot screenshot.png
# → ![screenshot](https://github.com/user/gitshot-images/releases/download/_gitshot/screenshot-a1b2c3d4.png)

# Upload and comment on a PR (most common agent workflow)
npx gitshot screenshot.png | gh pr comment <PR_NUMBER> --body-file -

# Upload and create an issue with image
npx gitshot bug.png | gh issue create --title "Bug report" --body-file -

# Upload multiple images
npx gitshot before.png after.png

# Get raw URL only (for embedding in larger text)
npx gitshot --raw screenshot.png

# JSON output (structured, for programmatic use)
npx gitshot --json screenshot.png
# → {"url":"...","markdown":"![...](...)","filename":"...","backend":"release"}

# Take screenshot on macOS, upload, comment on PR
screencapture -x /tmp/shot.png
npx gitshot /tmp/shot.png | gh pr comment 42 --body-file -

BEFORE=$(npx gitshot --raw before.png)
AFTER=$(npx gitshot --raw after.png)
echo "## Visual Diff\n| Before | After |\n|--------|-------|\n| ![]($BEFORE) | ![]($AFTER) |" | gh pr comment 42 --body-file -

URL=$(npx gitshot --raw diagram.png)
# Now use $URL anywhere in markdown text

BODY=$(npx gitshot bug.png)
gh issue create --title "UI Bug: Button misaligned" --body "$BODY"

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

Files

Just SKILL.md in .agents/skills/gitshot of trekawek/coffee-gb.

Open the folder on GitHubat commit 554ea56