画像から詳細な視覚情報を抽出する、音声・動画の文字起こし、ドキュメントのMarkdown変換、および画像生成を行います。
- GitHubスター
- 126
- ファイル
- 9
- 最終コミット
- 2026年5月16日
- ライセンス
- MIT
- 許可されたツール
- —
media-processor skillは何をしますか
画像から詳細な視覚情報を抽出する、音声・動画の文字起こし、ドキュメントのMarkdown変換、および画像生成を行います。
skillのSKILL.mdから生成された要約。
media-processor skill について
このSKILLは、UIモックアップや情報量の多いスクリーンショットから、正確な視覚的詳細を抽出することを開発者やデザイナーに可能にします。画像から正確な16進数カラーコード、ピクセル単位の間隔、フォントサイズ、コンポーネントの階層構造を特定するための専用ツールを提供します。エージェントがデザインに対するユーザーインターフェースの監査を行ったり、視覚的なリグレッションを確認するためにスクリーンショットを比較したりする場合、これらのツールをロードすることで、非常に精度の高い技術仕様書を作成できます。
このSKILLは、scriptsディレクトリにある3つの主要なスクリプトを利用します。gemini_batch_process.pyスクリプトは、画像解析、音声・動画の文字起こし、およびPDFからのデータ抽出を担当します。document_converter.pyスクリプトは、PDF、DOCX、XLSX、PPTXファイルをMarkdown形式に変換します。クリエイティブなタスクについては、image_gen.pyを使用して画像の生成や編集が可能ですが、これには有料プランが必要です。すべての操作にはGEMINI_API_KEYが必要であり、複雑な視覚タスクに対してはgemini-3.1-pro-previewなどのモデルオーバーライドを使用して微調整できます。
エージェントができること
- 1UI仕様の抽出実装のために、デザインモックアップから正確な色や間隔を特定するようエージェントに指示します。
- 2ドキュメントのMarkdown変換複雑なPDFやOfficeファイルを、構造化されたMarkdownテキストに変換するよう依頼します。
- 3視覚的リグレッション監査の実行エージェントに、実際のスクリーンショットと元のデザインを比較させ、不整合を見つけさせます。
- 4マルチメディアファイルの文字起こしツールを使用して、音声や動画コンテンツをテキストに変換します。
skill の SKILL.md から作成されています。すべてのユースケースは、その引用と照合されています。
media-processor skillのインストール方法
各コマンドはskillフォルダをクライアントのskillsディレクトリにコピーします。読み込むには、クライアントを再起動するか新しいセッションを開始してください。Claude Codeにmedia-processor skillをインストールする
~/.claude/skills/media-processor/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/skills/media-processor ~/.claude/skills/media-processorClaude Code (project)にmedia-processor skillをインストールする
.claude/skills/media-processor/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/skills/media-processor .claude/skills/media-processorCodexにmedia-processor skillをインストールする
~/.agents/skills/media-processor/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/skills/media-processor ~/.agents/skills/media-processorGemini CLIにmedia-processor skillをインストールする
~/.gemini/skills/media-processor/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/skills/media-processor ~/.gemini/skills/media-processorClaude.aiにmedia-processor skillをインストールする
npx degit avibebuilder/claude-prime/.claude/skills/media-processor media-processor && zip -r media-processor.zip media-processor # claude.ai → Customize → Skills → + → Create skill → Upload a skill → media-processor.zip
自動チェック
実行日 2026年11月16日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。エージェントに実行させる前にスクリプトを読んでください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能avibebuilder/claude-prime/.claude/skills/media-processor is public and reachablegithub.com/avibebuilder/claude-prime/tree/HEAD/.claude/skill ↗合格
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit 2026-05-16github.com/avibebuilder/claude-prime/commits ↗合格
- スクリプトにダウンロード実行や認証情報の窃取がない3 scripts read; no download-and-run, remote eval, base64 execution or credential upload合格
- SKILL.md に隠れた指示がないNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/skill ↗合格
- 事前許可ツールが限定されているNo pre-approved tools; the agent asks before using onegithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/skill ↗合格
- SKILL.md が Agent Skills の形式に従っているValid name and description; says when to use it; 75 linesgithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/skill ↗合格
SKILL.md
GitHubで表示Media Processor
Specialized tools for extracting precise visual details (exact colors, spacing, hierarchy), processing audio/video, and generating images.
Tools
All scripts live in scripts/ relative to this skill's directory. They auto-select the best model per task and handle retries, large file uploads, and error reporting.
| Script | Purpose |
|---|---|
gemini_batch_process.py |
Analyze images, transcribe audio/video, extract data from PDFs |
image_gen.py |
Generate and edit images (paid plan required) |
document_converter.py |
Convert PDF, DOCX, XLSX, PPTX to Markdown; extract page ranges and images |
Requires GEMINI_API_KEY in environment or .env in this skill's directory. Run any script with --help for setup details and available parameters.
Quick start — image analysis:
python <skill-dir>/scripts/gemini_batch_process.py \
--files <image-path> \
--task analyze \
--prompt "<tailored prompt>" \
--output <output-path>.md
Prompt Quality Matters
The prompt sent to the processing model is the single biggest factor in output quality. Tailor prompts to what the task actually needs — generic prompts produce generic results.
What makes a good analysis prompt:
- Ask for the specific details the task requires (hex colors, spacing in px, component hierarchy) rather than "describe this image"
- Structure the ask as a numbered list — the model mirrors the structure back, making output easy to parse
- Name the desired output format ("as a markdown table", "as JSON", "as a component tree")
- Include implementation context when relevant ("for React with Tailwind") so the model emphasizes useful details
Example prompt patterns:
UI implementation: "Extract component hierarchy, layout type, exact hex colors, typography (sizes/weights), spacing in px, interactive states, icons and decorative elements"
Chart data: "Extract chart type, axes with units, every data point with exact values, legend entries with colors. Output as a markdown table"
Design review: "Compare this screenshot against the design. Flag differences in spacing, colors, alignment, missing elements, and visual inconsistencies. Note exact values for each discrepancy"
Pasted Images
When a user pastes images in chat, they are auto-saved to:
$CLAUDE_DIR/image-cache/<current_session_id>/<image_number>.png
Use ls "$CLAUDE_DIR/image-cache/" to discover the session ID, then list its contents to find available images.
Model Overrides
Scripts auto-select models per task (see model-routing.md). Override with --model <model-id> when the default isn't enough — for example, --model gemini-3.1-pro-preview for complex visual analysis where the pro model catches more detail than flash.
References
| Reference | When to read |
|---|---|
| api-gotchas.md | Before using image generation, video processing, or raw API calls — prevents common failures |
| model-routing.md | When choosing or overriding the default model for a task |
| media-optimization.md | When files are too large to upload — ffmpeg compression recipes |
Gotchas
- Rate limits — scripts retry up to 3 times with backoff. If still rate-limited after retries, stop and ask the user to check their API key quota or provide a new key.
- Model IDs change — Google frequently rotates preview model IDs. If you get a 404, the model was likely superseded — check the models page for current IDs.
- Safety filters — the API may refuse some content. Report clearly to the user rather than retrying.
- Large files auto-upload — files >20MB automatically use the File API (2GB max, 48h retention). No action needed.
このスキルのファイル
9media-processor skillに関する質問
Claude Codeにmedia-processor skillをインストールするには
npx degit avibebuilder/claude-prime/.claude/skills/media-processor ~/.claude/skills/media-processorを実行してください。Claude Codeは~/.claude/skills(すべてのプロジェクト)または.claude/skills(単一プロジェクト)からskillsを読み込み、説明がタスクに一致する場合にskillを使用します。
media-processor skillはどのクライアントで使用できますか
Agent Skills形式を読み込むすべてのクライアントで使用できます: Claude Code、Codex、Gemini CLI、claude.ai(ZIPとしてアップロード)。skill内のスクリプトは、クライアントがコード実行を許可した場合にのみ実行されます。
非常に大きなファイルをアップロードしようとするとどうなりますか?
20MBを超えるファイルは自動的にFile APIが使用されます。File APIは最大2GBまで対応しており、ファイルは48時間保持されます。
PDFやDOCXをMarkdownに変換するにはどうすればよいですか?
document_converter.pyスクリプトを使用してください。PDF、DOCX、XLSX、PPTXファイルをMarkdownに変換し、画像やページ範囲を抽出できます。