mcpField
S
screenshot

screenshot

github.com/ninehills生産性27738 回インストール18 週間前に更新
リポジトリ

screenshot について

Screenshot は、Bash から macOS の screencapture を使って画面、ウィンドウ、範囲を撮影するスキルです。画像を読み込む前に縮小し、モデルのコンテキスト使用量を抑える手順を示します。

主な機能

  1. 01画面全体の撮影
  2. 02ウィンドウの対話的な選択
  3. 03指定範囲の撮影
  4. 04画像サイズと圧縮品質の調整
  5. 05画像寸法の取得

活用シーン

  1. 01画面を撮影して視覚的に確認
  2. 02ウィンドウや UI の一部を撮影
  3. 03モデルで確認する前に画像を縮小

インストール

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

$npx skills add https://github.com/ninehills/skills --skill screenshot

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE.txt
agents/
openai.yaml
scripts/
ensure_macos_permissions.sh
macos_display_info.swift
macos_permissions.swift
macos_window_info.swift
take_screenshot.ps1
take_screenshot.py

詳細

スクリーンショットスキル

Bash 経由で macOS の screencapture コマンドを使ってスクリーンショットを撮影します。

重要：必ずコンテキストに合わせてサイズを変更してください

フル解像度のスクリーンショット（特に Retina／5K ディスプレイの場合）は、巨大な base64 データになり、モデルのコンテキスト長を超えてしまいます。読み込む前に必ずサイズを変更してください。

スクリーンショットを撮影して表示する

# 1. Capture full screen
/usr/sbin/screencapture -x -t jpg /tmp/alma-screenshot.jpg

# 2. Resize to 1024px wide (critical for context size!)
/usr/bin/sips --resampleWidth 1024 --setProperty formatOptions 60 /tmp/alma-screenshot.jpg --out /tmp/alma-screenshot-thumb.jpg 2>/dev/null

# 3. Get dimensions
/usr/bin/sips -g pixelWidth -g pixelHeight /tmp/alma-screenshot.jpg 2>/dev/null

その後、Read ツールを使って /tmp/alma-screenshot-thumb.jpg（フルサイズではなく、サイズ変更した画像）を読み込みます。

撮影オプション

# Full screen (default)
/usr/sbin/screencapture -x -t jpg /tmp/alma-screenshot.jpg

# Interactive window selection
/usr/sbin/screencapture -x -w -t jpg /tmp/alma-screenshot.jpg

# Specific region (x,y,w,h)
/usr/sbin/screencapture -x -R 0,0,800,600 -t jpg /tmp/alma-screenshot.jpg

# With 3-second delay
/usr/sbin/screencapture -x -T 3 -t jpg /tmp/alma-screenshot.jpg

スクリーンショットをユーザーに送信する（Telegram）

ユーザーがスクリーンショットを直接見たい場合は、alma CLI を使うか、見えている内容を説明してください。フル解像度のファイルは /tmp/alma-screenshot.jpg にあります。

ヒント

  • コンテキストに読み込む前に、必ずサイズを変更してください — サムネイル版を使います
  • -x フラグを指定すると、撮影音を抑制できます
  • -t jpg を指定すると、JPEG（PNG より小さいサイズ）で出力されます
  • 必要に応じて、圧縮率を高めるには sips --setProperty formatOptions 60 を使います

コメント

Markdown 対応