mcpField
G
gitshot

gitshot

github.com/vipulgupta2048開発3283 回インストール29 週間前に更新
リポジトリ

gitshot について

gitshot は、画像をコマンドラインからアップロードし、GitHub 向けの Markdown リンクを作るスキルです。スクリーンショットや視覚的な比較を Issue、プルリクエスト、コメントに添付でき、GitHub CLI のほか複数のアップロード先に対応します。

主な機能

  1. 01コマンドラインからの画像アップロード
  2. 02URL または Markdown の出力
  3. 03複数の画像形式に対応
  4. 04PR コメントや Issue 本文での利用
  5. 05複数のアップロード先

活用シーン

  1. 01GitHub の PR コメントへのスクリーンショット添付
  2. 02PR での変更前後の画像表示
  3. 03画像付き GitHub Issue の作成
  4. 04Markdown 埋め込み用画像 URL の取得

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/vipulgupta2048/gitshot --skill gitshot

インストール後、Claude Code で/gitshotを入力して読み込まれたか確認します。

詳細

gitshot — 画像を GitHub にアップロード

ターミナルから画像をアップロードし、GitHub のイシュー、PR、コメントに使える Markdown 対応の URL を取得します。

このスキルを使う場面

  • GitHub の PR またはイシューに画像やスクリーンショットを「アップロード」、「添付」、「埋め込み」するよう依頼された場合
  • ワークフローで、PR のコメントまたはイシュー本文に追加するスクリーンショットや画像が生成された場合
  • PR に「ビジュアル差分」、「変更前／変更後」、または「スクリーンショット」を追加するよう依頼された場合
  • 「PR に画像を追加して」、「イシューにスクリーンショットを添付して」などと依頼された場合
  • スクリーンショットを撮影し、GitHub の Markdown に含める必要がある場合

クイックリファレンス

# 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"}

仕組み

  1. gh CLI で認証済みの場合（最も一般的）：<user>/gitshot-images リポジトリに GitHub リリースアセットとしてアップロードします。初回使用時にリポジトリを自動作成します。
  2. gh CLI がない場合：catbox.moe にフォールバックします（無料、登録不要）。
  3. 任意：CLOUDINARY_URL または IMGBB_API_KEY の環境変数を設定すると、それらのバックエンドを使用できます。

エージェントでよく使われるワークフロー

スクリーンショット → PR コメント
# Take screenshot on macOS, upload, comment on PR
screencapture -x /tmp/shot.png
npx gitshot /tmp/shot.png | gh pr comment 42 --body-file -
PR の説明にビジュアル差分を追加
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 を取得
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"

重要な注意事項

  • 標準出力には URL または Markdown のみが含まれます（パイプで安全に使用できます）
  • 標準エラー出力にはステータスメッセージ（バックエンド名、進捗状況）が含まれます
  • 終了コード 0 = 成功、1 = 失敗
  • 対応形式：PNG、JPG、JPEG、GIF、SVG、WebP、BMP、ICO、TIFF、AVIF
  • リリースバックエンドを初めて実行すると、<user>/gitshot-images リポジトリが自動作成されます（一度のみ）
  • プライバシー： リリースバックエンドは公開リポジトリにアップロードします。機密性の高い画像（認証情報、内部ダッシュボード）はアップロードしないでください。機密情報を含むコンテンツには Cloudinary または imgbb を使用してください。

コメント

Markdown 対応