Agent Skills › yohey-w/multi-agent-shogun › shogun-screenshot

shogun-screenshot

GitHub

用于获取、加工屏幕截图的技能，支持本地截图检索、Playwright网页抓取、图像裁剪及敏感信息黑码处理，旨在提升内容视觉质量。

skills/shogun-screenshot/SKILL.md yohey-w/multi-agent-shogun

Trigger Scenarios

请求获取最新截图需要截取网页页面需要对图片进行裁剪或调整大小需要对截图中的敏感信息进行遮蔽

Install

npx skills add yohey-w/multi-agent-shogun --skill shogun-screenshot -g -y

More Options

Use without installing

npx skills use yohey-w/multi-agent-shogun@shogun-screenshot

指定 Agent (Claude Code)

npx skills add yohey-w/multi-agent-shogun --skill shogun-screenshot -a claude-code -g -y

安装 repo 全部 skill

npx skills add yohey-w/multi-agent-shogun --all -g -y

预览 repo 内 skill

npx skills add yohey-w/multi-agent-shogun --list

SKILL.md

Frontmatter

{
    "name": "shogun-screenshot",
    "description": "スクリーンショットの取得・加工を行う。ローカルスクショから最新画像を取得、\nPlaywrightでWebページをキャプチャ、画像のトリミング・リサイズ、機微情報を黒塗りマスキング。\n記事執筆、レポート作成、UI確認、画像加工時に起動。\n「スクショ」「スクリーンショット」「画面キャプチャ」「最新のスクショ」「画像加工」「トリミング」「マスク」「写メ」「写メ撮った」「スクショ撮った」で起動。\nDo NOT use for: 画像生成（shogun-imagegenを使え）。\n",
    "allowed-tools": "Bash, Read",
    "argument-hint": "[url-or-target e.g. https:\/\/example.com, latest]"
}

/shogun-screenshot - スクリーンショット取得・加工スキル

North Star（全判断の最上位基準）

このスキルの北極星は記事・報告書のビジュアル品質向上によるコンテンツ差別化。高品質な画像（マスク済み・適切にトリミング済み）を記事・レポートに挿入することで、テキスト単体の競合コンテンツとの差別化を実現する。

Input

$ARGUMENTS = 操作対象の指定（URLまたはモードキーワード）

URL（https://...）→ Mode 2: Webキャプチャ
latest（省略可）→ Mode 1: ローカルスクショ取得
引数なし → ユーザーの意図に応じて最適なモードを選択

Overview

スクリーンショットの取得・加工を行う。4つのモードがある:

ローカル取得: ユーザーのスクショフォルダから最新画像を取得
Webキャプチャ: URLを指定してPlaywright MCPでページをキャプチャ
トリミング: 既存画像の一部を切り出し・リサイズ
マスキング: 機微情報（APIキー、個人情報等）を黒塗り

When to Use

「最新のスクショを見せて」「スクショ取って」と言われた時
記事やレポートに画像を挿入する時
UI画面のキャプチャが必要な時
画像のトリミング・切り出しが必要な時
スクショ内の機密情報をマスクする時

Configuration

スクショフォルダのパスは config/settings.yaml で管理（優先順の配列）:

screenshot:
  paths:
    - "/path/to/your/Screenshots/"      # OS のスクショ保存先
    - "queue/screenshots/"               # モバイルアプリ等からの受信先
  capture_dir: "images/"                 # Webキャプチャの保存先
  trim_dir: "images/trimmed/"            # トリミング後の保存先

paths 配列を上から順に探索し、ディレクトリが存在＋画像ファイルがあるものを使う。全パスが存在しない場合はエラーを返す。

Instructions

Mode 1: ローカルスクショ取得（複数パスフォールバック）

手順:

config/settings.yaml から screenshot.paths 配列を読む
優先順に各パスを探索: a. ls <path> でディレクトリ存在を確認（存在しなければ次へ） b. 存在するパスで ls -lt <path>/*.png <path>/*.jpg 2>/dev/null | head -5 で最新画像を取得
最も新しい画像ファイルを Read ツールで表示
複数パスに画像がある場合、全パスの最新を比較して最も新しいものを表示

ヘルパースクリプト (全パスを自動探索):

bash skills/shogun-screenshot/scripts/capture_local.sh -n 3

手動で特定パスを指定する場合:

# config/settings.yaml の screenshot.paths に設定されたパスを使用
ls -lt "/path/to/Screenshots/"*.png 2>/dev/null | head -3

注意: ディレクトリ自体が存在しない可能性がある（ドライブ未マウント等）。 2>/dev/null で存在しないパスのエラーを抑制すること。

Mode 2: Webキャプチャ（Playwright MCP）

Playwright MCP の playwright_navigate でURLに遷移
playwright_screenshot でキャプチャ
- fullPage: true（ページ全体）
- selector: 指定（要素のみ）
- savePng: true, downloadsDir: 保存先
保存されたPNGのパスを返す

Mode 3: トリミング

対象画像のパスを受け取る
Python (PIL/Pillow) でトリミング実行
トリミング後の画像を保存

python3 skills/shogun-screenshot/scripts/trim_image.py \
  --input /path/to/image.png \
  --output /path/to/trimmed.png \
  --crop "x1,y1,x2,y2"

オプション: --resize "width,height" でリサイズも同時に行える。

Mode 4: 機微情報マスキング

スクショ内のAPIキー、トピック名、個人情報等を矩形で黒塗りする。

# 単一領域
python3 skills/shogun-screenshot/scripts/mask_sensitive.py \
  --input /path/to/image.png \
  --output /path/to/masked.png \
  --regions "100,50,400,80"

# 複数領域
python3 skills/shogun-screenshot/scripts/mask_sensitive.py \
  --input /path/to/image.png \
  --output /path/to/masked.png \
  --regions "100,50,400,80" "500,200,800,230"

# 位置確認（赤枠プレビュー、塗りつぶさない）
python3 skills/shogun-screenshot/scripts/mask_sensitive.py \
  --input /path/to/image.png \
  --output /path/to/preview.png \
  --regions "100,50,400,80" --preview

オプション: