/screenshot-analyzer

name: screenshot-analyzer
description: "スクリーンショットからエラー診断や操作チュートリアルを自動生成するスキル。 「スクショを分析して」「画面のエラーを調べて」「操作手順を作って」等のリクエストで発動。"
triggers:
  - スクショを分析して
  - 画面のエラーを調べて
  - 操作手順を作って
  - スクリーンショット解析
  - エラー画面を診断
  - screenshot-analyzer
  - screenshot analysis

Screenshot Analyzer

Analyze screenshots for error diagnosis or operation tutorial generation.

Modes

1. **Analyze**: Detect errors, identify causes, suggest solutions 2. **Tutorial**: Generate step-by-step operation guides with annotations

Usage

# Error analysis (default)
python scripts/analyze.py "{screenshot}" --mode analyze

# Tutorial generation
python scripts/analyze.py "{screenshot}" --mode tutorial

Parameters

| Parameter | Required | Default | Description | |-----------|----------|---------|-------------| | screenshot | Yes | - | Path to screenshot | | --mode, -m | No | analyze | Mode: analyze or tutorial | | --output, -o | No | auto | Output HTML path | | --no-annotate | No | false | Skip annotation generation |

Output

Analyze Mode

• Screen description
• Error detection (message, type, location)
• Root cause analysis
• Solution suggestions (NextStep)

Tutorial Mode

• Screen overview
• Numbered operation steps
• Annotated screenshots per step
• Tips and warnings

Examples

# Analyze error screenshot
python scripts/analyze.py "error_console.png"

# Generate tutorial
python scripts/analyze.py "settings_menu.png" --mode tutorial

# Specify output
python scripts/analyze.py "login.png" --mode tutorial --output "docs/login_guide.html"

# Skip annotations
python scripts/analyze.py "error.png" --no-annotate

Requirements

• GEMINI_API_KEY or GOOGLE_API_KEY in environment
• Python packages: google-genai, Pillow, python-dotenv

Overview

スクリーンショットからエラー診断や操作チュートリアルを自動生成するスキルです。Gemini Vision APIでUI要素を認識し、エラーの原因分析・解決策提案、またはステップバイステップの操作ガイドを出力します。

Troubleshooting

| エラー | 解決方法 | |--------|---------| | API key not found | `GEMINI_API_KEY` または `GOOGLE_API_KEY` を環境変数に設定 | | Analysis returned empty results | スクリーンショットが不鮮明な可能性。より高解像度の画像を使用 |

Success Criteria

• [ ] analyzeモード: エラー内容と解決策が出力されている
• [ ] tutorialモード: ステップ番号付きの操作ガイドが出力されている
• [ ] 出力HTMLファイルが正しく生成されている