gitshot

Upload images to GitHub issues and pull requests with markdown-ready URLs.

19|2|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/vipulgupta2048/gitshot --skill gitshot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gitshot
Source: https://github.com/vipulgupta2048/gitshot/tree/main/.commandcode/skills/gitshot
Command: npx skills add https://github.com/vipulgupta2048/gitshot --skill gitshot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GitHub has no native API for uploading images to issues, pull requests, or comments, leaving users and AI agents unable to attach screenshots or visual context to GitHub discussions, a long-standing gap that breaks workflows requiring visual feedback.

Core Features & Use Cases

  • One-Command Upload and Post: Upload images and automatically post them as comments to PRs/issues or create new issues with images in a single command, no extra steps required.
  • Permanent, Reliable Hosting: Auto-creates a dedicated public gitshot-images repository on the user's GitHub account to host images as Release assets, ensuring permanent, GitHub-native URLs that render correctly in markdown.
  • Flexible Output Options: Supports raw URL output, JSON output for AI agents/scripts, and standard markdown output, with auto-detection of the current PR from the active Git branch for faster workflows.

Quick Start

Use the gitshot skill to upload the screenshot 'ui-bug.png' and attach it as a comment to the current pull request with the caption 'Navigation bar misalignment on mobile'.

Frequently Asked Questions about gitshot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upload images to GitHub issues and pull requests when there is no native API?

To upload images to GitHub issues and pull requests, this skill uses the authenticated gh CLI to host images as permanent Release assets in a dedicated public repository, generating markdown-ready URLs instantly for visual feedback.

Does GitHub provide a native way to attach screenshots to comments via CLI?

GitHub does not provide a native API for attaching screenshots to comments via CLI. This skill fills that gap by automatically creating a dedicated public repository to host images as permanent Release assets and outputting markdown URLs.

How do I get markdown URLs for screenshots to embed in GitHub markdown?

To get markdown URLs for screenshots, upload your image using this skill which hosts it as a GitHub Release asset and outputs standard markdown, raw URLs, or JSON for embedding in GitHub markdown.

Do I need authenticated gh CLI access to automate image uploads to GitHub?

Yes, you need authenticated gh CLI access to automate image uploads to GitHub. The skill requires it to automatically create a dedicated public repository for hosting images as permanent GitHub Release assets.

Can I automatically post image comments to the current pull request from a Git branch?

You can automatically post image comments to the current pull request by using the skill's auto-detection feature for the active Git branch, uploading the screenshot and attaching it as a comment in a single command.

What output formats are supported when generating GitHub image URLs for AI agents?

For generating GitHub image URLs for AI agents, the skill supports raw URL output, JSON output for scripts, and standard markdown output, ensuring flexible integration into automated workflows and visual diff sharing.