# image-analysis

The image-analysis Claude Code skill extracts prominent colors from an image and returns a palette. It activates for screenshot matching, design mockups, and requests to identify image colors.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 107 installs · ★ 102 repo stars
- Author: pascalorg
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pascalorg/skills/tree/HEAD/image-analysis/SKILL.md
- Updated: 2026-09-11
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/image-analysis

## What it does

The skill runs a script that reads image pixels and identifies the dominant colors. It sorts the palette by prominence and reports each color as HEX, RGB, and HSL, with its share of the image area.

Pass the script a path to a PNG, JPG, WebP, BMP, or GIF file. It uses `get-pixels` and `extract-colors`, attempting to install both on its first run. If that fails, install the dependencies with `npm install` from the `scripts` directory. Images in formats unsupported by `get-pixels` need conversion before processing.

## Requirements
- Works with: Figma

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add pascalorg/skills --skill image-analysis -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/image-analysis/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/image-analysis/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add pascalorg/skills --skill image-analysis -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/image-analysis/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add pascalorg/skills --skill image-analysis -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/image-analysis/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pascalorg/skills image-analysis
```

2. **Manually: put the files in place**
- File: `.github/skills/image-analysis/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add pascalorg/skills --skill image-analysis -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/pascalorg/skills --path image-analysis
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/image-analysis/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add pascalorg/skills --skill image-analysis -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/pascalorg/skills/tree/HEAD/image-analysis/SKILL.md

## When to use it
- extract dominant colors from a screenshot
- get a palette from a Figma export
- match interface colors to a design mockup
- prepare color values for design tokens

## Example prompts
- Extract a palette from `./screenshot.png` and show HEX, RGB, and HSL values.
- Identify the main colors in `~/Downloads/figma-design.jpg`.
- Match the interface colors to the palette in this image.

## Similar
- [image](https://affpapa.org/en/nevibecode/skills/image.md) — skill · 99300 installs
- [figma](https://affpapa.org/en/nevibecode/skills/heygen-com-figma.md) — skill · 466500 installs
- [design-system-patterns](https://affpapa.org/en/nevibecode/skills/design-system-patterns.md) — skill · 15953 installs
- [build-design](https://affpapa.org/en/nevibecode/skills/build-design.md) — skill · 11100 installs
- [design-critique](https://affpapa.org/en/nevibecode/skills/design-critique.md) — skill · 6200 installs
- [design-handoff](https://affpapa.org/en/nevibecode/skills/design-handoff.md) — skill · 4000 installs

From the same set: [pascalorg/skills](https://affpapa.org/en/nevibecode/by/pascalorg/skills.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
