이미지에서 정밀한 시각적 세부 정보를 추출하고, 오디오/비디오를 전사하며, 문서를 markdown으로 변환하고 이미지를 생성합니다.
- GitHub 스타
- 126
- 파일
- 9
- 마지막 커밋
- 2026년 5월 16일
- 라이선스
- MIT
- 허용된 도구
- —
media-processor skill은 무엇을 하나요?
이미지에서 정밀한 시각적 세부 정보를 추출하고, 오디오/비디오를 전사하며, 문서를 markdown으로 변환하고 이미지를 생성합니다.
skill의 SKILL.md에서 생성된 요약입니다.
media-processor skill 정보
UI 목업이나 복잡한 스크린샷에서 정밀한 시각적 세부 정보를 추출하는 기능은 개발자와 디자이너에게 매우 유용합니다. 이미지에서 정확한 hex 색상, 픽셀 단위 간격, 글꼴 크기 및 컴포넌트 계층 구조를 식별할 수 있는 전문 도구를 제공합니다. 에이전트가 디자인과 사용자 인터페이스를 대조하여 감사하거나 시각적 회귀를 확인하기 위해 스크린샷을 비교해야 할 때, 이 도구를 로드하여 매우 정확한 기술 사양을 생성할 수 있습니다.
이 SKILL은 scripts 디렉토리에 있는 세 가지 주요 스크립트를 활용합니다. gemini_batch_process.py 스크립트는 이미지 분석, 오디오 및 비디오 전사, PDF 데이터 추출을 처리합니다. document_converter.py 스크립트는 PDF, DOCX, XLSX, PPTX 파일을 markdown 형식으로 변환합니다. 창의적인 작업의 경우 image_gen.py를 통해 이미지 생성 및 편집이 가능하지만, 이는 유료 플랜이 필요합니다. 모든 작업은 GEMINI_API_KEY를 기반으로 하며, 복잡한 시각적 작업을 위해 gemini-3.1-pro-preview와 같은 모델 오버라이드를 사용하여 미세 조정할 수 있습니다.
agent가 수행할 수 있는 작업
- 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를 사용하며, 최대 2GB까지 지원하고 파일은 48시간 동안 유지됩니다.
PDF 또는 DOCX를 Markdown으로 어떻게 변환하나요?
document_converter.py 스크립트를 사용하여 PDF, DOCX, XLSX, PPTX 파일을 Markdown으로 변환하고 이미지나 페이지 범위를 추출할 수 있습니다.