ingest-screenshot
Analyze an uploaded image (screenshot of a design, website, app) and extract design tokens to use as a starting point. Use when user pastes or attaches an image and says "recreate this", "match this image", "use this style".
How do I install this agent skill?
npx skills add https://github.com/bluzir/claude-code-design --skill ingest-screenshotIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is safe and performs image analysis to extract design tokens. It has a standard risk surface for indirect prompt injection common to vision-based tools, as it processes external image files that could contain adversarial text.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Ingest Screenshot
Extract design tokens from a static image using Claude's vision. Honest caveats: exact hex codes are approximate without source files. Claude recreates UIs more reliably from code than from screenshots.
Steps
-
Resolve image path:
$0.Bash(file <path>)to confirm it's an image (png/jpg/webp/heic). -
Read via multimodal
Read: this loads the image for vision. Claude can see it. -
Analyze systematically. From the image, identify:
- Dominant colors — pick 5-8 swatches with hex approximations. Flag uncertain ones ("looks like #2A4B6D but vision hex is approximate").
- Typography — font family (match to common families: Inter-like, serif-like, display, mono), sizes (relative), weights (light/regular/medium/bold), line-height impression
- Spacing rhythm — estimate base unit (4/6/8px) from gaps + padding
- Radii — sharp / small / medium / pill
- Component patterns — what types of elements appear (buttons, cards, navigation, inputs)
- Aesthetic register — minimal / dense / decorative / playful / corporate / brutalist
-
Write output:
artifacts/ingested/screenshot-<timestamp>-tokens.jsonSame schema as
ingest-github+"source": { "image": "<path>", "ingested_at": "..." }+"confidence": "low|medium|high"per category. -
Preview confidence: for each uncertain value, add a
"confidence"field (low|medium|high). Vision-derived hex codes should belowormedium. -
Offer next step:
- "Extracted tokens saved. Colors are approximate — do you have the source file (CSS, design system, brand guide) to cross-check?"
- Follow-up:
/create-design-systemor start/make-deck//interactive-prototypeusing these as starting point.
Limitations — tell the user
- Vision returns approximate hex, not exact. For production accuracy, provide source files.
- Multiple overlapping colors → Claude picks representative samples, not all variations
- Typography recognition is fuzzy — "looks like Inter" ≠ "is Inter"
- Pixel dimensions require the image's actual resolution to be readable
Workflow integration
After ingest, always offer to pair with a real source (Figma, codebase) to lock in exact values — the screenshot gives a starting direction, not ground truth.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/bluzir/claude-code-design/ingest-screenshot">View ingest-screenshot on skillZs</a>