無料GitHub で公開

screenshot-analyzer

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

minicoohei/ai-agent-camp

インストール方法を見る

含まれるファイル（5）

SKILL.md2.8 KB
agents/openai.yaml153 B
scripts/analyze.py9.2 KB
SKILL.en.md2.6 KB
SKILL.es.md2.9 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Screenshot Analyzer

Analyze screenshots for error diagnosis or operation tutorial generation.

Modes

Analyze: Detect errors, identify causes, suggest solutions
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ファイルが正しく生成されている

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ

ab-test-setup

無料日本語概要

A/Bテストや実験の設計・実装を支援するスキル。「A/Bテストを設計して」「スプリットテストしたい」「仮説を立ててテストしたい」「バリアントを比較」等のリクエストで発動。トラッキング実装は analytics-tracking を参照。