Agent skill

Color Management

by magnus919 in magnus919/agent-skills

Manage color workflows with ICC profiles, working spaces, gamut mapping, and color science.

MITAuto-check: notes

Install Color Management

skills CLI
$ npx skills add magnus919/agent-skills --skill color-management -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install magnus919/agent-skills color-management --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/color-management .claude/skills/color-management && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
color-management
GitHub stars
119
Token cost
~2.6k tokens
SKILL.md length
1,133 words
Files
22 (incl. scripts, references, assets)
Skills in repo
131
Repo updated
First seen
Licence
MIT

At a glance

Manage color workflows with ICC profiles, working spaces, gamut mapping, and color science.

  • Inspecting ICC profiles
  • SKILL.md covers Quick Reference, Required Tools, Python Scripts and Gotchas, plus 2 more sections
  • Runs Python scripts from its folder; calls python3, brew and apt
  • Converting between color spaces

What it does

Color Management is an agent skill from magnus919/agent-skills. Manage color workflows with ICC profiles, working spaces, gamut mapping, and color science. Use when inspecting ICC profiles, converting between color spaces, checking gamut clipping, validating well-behaved working spaces, or troubleshooting color workflow issues with ImageMagick, ArgyllCMS, Exiftool, or LittleCMS. Do not use this skill for unrelated requests; route to the nearest named specialist.

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 26 other files, including scripts, reference files and assets (for example `README.md`, `assets/templates/icc-profile-report.md` and `assets/templates/lch-layer-stack.md`). Compatibility notes: CLI tools used (ImageMagick, Exiftool, ArgyllCMS, LittleCMS) are platform-independent; Python scripts require Python 3.8+

The repository describes itself as: Curated collection of AI agent skills for Hermes and other agent frameworks. The licence is MIT.

When your agent uses it

  • Inspecting ICC profiles
  • Converting between color spaces
  • Checking gamut clipping
  • Validating well-behaved working spaces

Example prompts

  • “/color-management”

Requirements

  • Python 3
  • Compatibility (from SKILL.md): CLI tools used (ImageMagick, Exiftool, ArgyllCMS, LittleCMS) are platform-independent; Python scripts require Python 3.8+

What it can do on your machine

Read from SKILL.md and the folder at commit 9cb2f8b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • brew
    • apt
    • dnf
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    CLI tools used (ImageMagick, Exiftool, ArgyllCMS, LittleCMS) are platform-independent; Python scripts require Python 3.8+

    From compatibility in the SKILL.md frontmatter.

Context cost

Color Management loads about 2.6k tokens when it runs, and up to ~18k if it reads all its reference files. Until then it costs about 105 tokens; SKILL.md has 1,133 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~105
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~18k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:56
    sudo apt install imagemagick libimage-exiftool-perl argyll littlecms2
  • NoteRuns commands with sudoSKILL.md:59
    sudo dnf install ImageMagick perl-Image-Exiftool ArgyllCMS littlecms2

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from magnus919/agent-skills at commit 9cb2f8b, republished under its MIT licence (© magnus919). 1,133 words, ~2,638 tokens.

Download SKILL.mdSave it as .claude/skills/color-management/SKILL.md (or your agent's skills folder). This skill also uses 21 other files; get the full folder from GitHub.
name
color-management
description
Manage color workflows with ICC profiles, working spaces, gamut mapping, and color science. Use when inspecting ICC profiles, converting between color spaces, checking gamut clipping, validating well-behaved working spaces, or troubleshooting color workflow issues with ImageMagick, ArgyllCMS, Exiftool, or LittleCMS. Do not use this skill for unrelated requests; route to the nearest named specialist.
compatibility
CLI tools used (ImageMagick, Exiftool, ArgyllCMS, LittleCMS) are platform-independent; Python scripts require Python 3.8+
license
MIT
metadata.spec-version
1.0
metadata.source
Distilled from ninedegreesbelow.com (Elle Stone) and Bruce Lindbloom's color science resources
metadata.version
1.0.0

Color Management Skill

Expert-level guidance for ICC profile color management in open-source workflows. Covers color science fundamentals, working space selection, ICC profile operations, gamut analysis, and practical tool usage.

Quick Reference

If you need to...Load this referenceRun this script
Understand CIELAB, xyY, or color science basicsreferences/color-management-overview.md—
Inspect an ICC profile's metadata/primaries/TRC—scripts/icc-profile-inspect.py
Check if a profile is well-behaved (neutral gray axis)references/working-spaces-reference.mdscripts/well-behaved-check.py
Convert images between color spacesreferences/icc-profile-operations.mdscripts/color-space-convert.py
Check which image colors exceed a color space gamutreferences/soft-proofing-workflow.mdscripts/gamut-check.py
Compare sRGB profile variantsreferences/working-spaces-reference.mdscripts/srgb-compare.py
Calculate color difference (dE) between two images—scripts/color-difference.py
Soft proof an image before conversionreferences/soft-proofing-workflow.mdscripts/gamut-check.py
Calibrate and profile a monitorreferences/monitor-calibration-workflow.md—
Process raw files with dcrawreferences/dcraw-pipeline.md—
Understand hex quantization and create well-behaved profilesreferences/hex-quantization-and-profile-creation.mdscripts/well-behaved-check.py
Generate a comprehensive color analysis report—scripts/color-report.py
Set up a GIMP LCH layer stack for separate tonality/color editingassets/templates/lch-layer-stack.md—
Extract embedded ICC profile from an imagereferences/icc-profile-operations.mdscripts/icc-profile-inspect.py
Understand conversion intents (relative/absolute/perceptual)references/color-management-overview.md—
Set up Firefox for color-managed browsingreferences/tool-reference.md—

Required Tools

The scripts in this skill check for these tools and report if missing. Install what you need:

  • ImageMagick (convert, identify, compare, composite) — primary image processing
  • Exiftool — metadata and ICC profile extraction
  • ArgyllCMS (xicclu, iccgamut, colprof, cctiff) — professional color management
  • LittleCMS (tificc, transicc) — ICC profile conversions
bash
# macOS
brew install imagemagick exiftool argyllcms littlecms

# Debian/Ubuntu
sudo apt install imagemagick libimage-exiftool-perl argyll littlecms2

# Fedora
sudo dnf install ImageMagick perl-Image-Exiftool ArgyllCMS littlecms2

Python Scripts

All scripts are in scripts/. They require Python 3.8+ with these optional dependencies:

bash
pip install numpy colour-science Pillow  # optional but recommended

Each script has a --help flag:

bash
python3 scripts/icc-profile-inspect.py --help
python3 scripts/well-behaved-check.py --help

Gotchas

sRGB profile variants

There is no single "sRGB" ICC profile. Different vendors produce profiles that differ in D50 adaptation, hexadecimal quantization, and TRC encoding. The ArgyllCMS sRGB.icm and the colord Shared sRGB.icm are both well-behaved; the Adobe/color.org/Windows 2000 variants are not well-behaved (they produce a false magenta cast at high bit depths). See references/working-spaces-reference.md and scripts/srgb-compare.py.

Matrix profiles cannot use perceptual intent

sRGB, AdobeRGB, ProPhotoRGB, and all other matrix working space profiles do NOT support perceptual or saturation intents. When you select perceptual intent for a matrix destination profile, you actually get relative colorimetric (which clips out-of-gamut colors). The "perceptual keeps all colors" mantra only applies when converting to LUT profiles (printer profiles, some monitor profiles).

Perceptual intent for sRGB is a lie

The oft-repeated statement "perceptual intent preserves colors when converting to sRGB" is false. sRGB is a matrix profile; it has no perceptual intent table. What actually happens is relative colorimetric intent, which clips. The only way to preserve out-of-gamut colors at floating point is to use LCMS2 unbounded mode.

Display-referred vs scene-referred
  • Display-referred: RGB values bounded by 0.0-1.0. White (1,1,1) = maximum display brightness. ~9 stops dynamic range. Operations clamp.
  • Scene-referred: No upper bound on RGB values. White has no special significance. 20+ stops possible (OpenEXR). Requires linear gamma. Operations do NOT clamp. Always check which model your editing pipeline uses.
Unbounded editing has limits

LCMS2 unbounded mode prevents clipping during conversions by allowing negative and >1.0 RGB values. This is useful for storage and transport, but many editing operations (Multiply, Divide, Screen, Levels gamma slider, Curves, color correction) produce meaningless results on out-of-gamut colors. Use integer precision if you don't want to manage out-of-gamut values.

Luminance vs Luma is not pedantry
  • Luminance: calculated on linearized RGB (radiometrically correct). Uses sRGB-specific multipliers (R0.213 + G0.715 + B*0.072).
  • Luma: calculated on gamma-encoded RGB (perceptually uniform). Different multipliers (R0.222 + G0.717 + B*0.061 for GIMP 2.9+, Bradford-adapted to D50). GIMP 2.8 used wrong multipliers. GIMP 2.9+ corrected them. Always use Luminance for physically meaningful black/white conversions.
Camera profiles require negative tristimulus values

Every digital camera sensor needs negative XYZ tristimulus values in its input matrix profile (analysis of 233 dcraw cameras: 100% had negative green Z, 93% had negative blue Y). ICC V2 prohibited these; V4 allows them via 32-bit floating point. If your workflow clips negative values, you lose blue and green channel detail.

8-bit vs 16-bit vs floating point
  • 8-bit: Use only sRGB or AdobeRGB (small gamut, perceptually uniform TRC). Never use linear gamma (posterization in shadows).
  • 16-bit integer: ProPhotoRGB is usable. Linear gamma is OK for radiometrically correct editing.
  • 32-bit floating point: Any working space, any TRC. Unbounded conversions possible. Required for scene-referred HDR.
Show full SKILL.md (454 more words)Show less
LCH vs HSV is not an upgrade — it's a replacement

HSV is a 1960s "fast math" hack for slow CPUs. It cannot separate color from tonality. LCH (Lightness, Chroma, Hue) is derived from CIELAB and allows true separate editing of color and tonality. GIMP's LCH blend modes are the first correct implementation in open-source software. Never use HSV blend modes for serious editing.

Concrete failure: Levels gamma slider + unbounded sRGB = disaster

If you take a ProPhotoRGB image with saturated reds, convert it to unbounded sRGB at 32-bit float, and apply a Levels gamma slider adjustment (e.g., gamma=3.0), the reds turn magenta and any chrome in the image turns cyan. This is because the gamma slider is chromaticity-dependent — it multiplies channels differently in different working spaces. The fix: do gamma adjustments in the same working space the image was edited in, or use a chromaticity-independent operation like Value channel Levels.

Concrete failure: Color correction in the wrong working space

If an image was given a green color cast in the ProPhotoRGB color space, and you correct it in unbounded sRGB using the white balance eyedropper, the correction produces: cyan grass, orange skin tones, saturated sky, and a saturated red truck in the distance. Even though the white point dot itself turns neutral, all other colors are wrong. Color correction must be performed in the same color space in which the cast was created. Converting to a different space and correcting produces unpredictable results.

Concrete failure: Channel-based mono mixing with out-of-gamut colors

Converting a yellow truck from its camera input profile to sRGB drives the blue channel negative over most of the yellow truck body. If you then try to use Channel Mixer (Mono Mixer) to create a black-and-white conversion by blending from the blue channel, the negative blue channel values produce completely meaningless results — you can't emulate orthochromatic film or any other channel-based effect on colors that are out of gamut. Channel-based editing must be done before converting to a smaller gamut, or in a working space large enough to contain all image colors.

References

FileWhen to load
references/color-management-overview.mdYou need to understand CIELAB, xyY, color science fundamentals
references/icc-profile-operations.mdYou need to convert, assign, extract, or create ICC profiles
references/tool-reference.mdYou need CLI commands for ImageMagick, ArgyllCMS, Exiftool, LCMS
references/working-spaces-reference.mdYou need working space data (primaries, white points, gamma values)
references/glossary.mdYou encounter an unfamiliar term
references/soft-proofing-workflow.mdYou need to soft proof before conversion
references/monitor-calibration-workflow.mdYou need to calibrate or profile a monitor
references/dcraw-pipeline.mdYou're working with raw files and need a color-managed pipeline
references/hex-quantization-and-profile-creation.mdYou need to create well-behaved ICC profiles

Assets

FileDescription
assets/templates/icc-profile-report.mdTemplate for a human-readable ICC profile analysis report
assets/templates/lch-layer-stack.mdGIMP LCH layer group template for separate tonality/color editing

© magnus919, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 21 other files (scripts, references, assets) in color-management of magnus919/agent-skills.

  • SKILL.md
  • .gitignore
  • README.md
  • assets/templates/icc-profile-report.md
  • assets/templates/lch-layer-stack.md
  • evals/evals.json
  • references/color-management-overview.md
  • references/dcraw-pipeline.md
  • references/glossary.md
  • references/hex-quantization-and-profile-creation.md
  • references/icc-profile-operations.md
  • references/monitor-calibration-workflow.md
  • references/soft-proofing-workflow.md
  • references/tool-reference.md
  • references/working-spaces-reference.md
  • scripts/color-difference.py
  • … and 6 more

Open the folder on GitHubat commit 9cb2f8b

Compare with similar skills

Color Management next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Color Management compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Color Management this skillmagnus919/agent-skills119—~2.6kAutomated safety check: NotesMIT
Color Expertnexu-io/open-design100k—~331Automated safety check: PassApache-2.0
Profileccusage/ccusage19k—~430Automated safety check: PassCustom licence
Cpu ProfileClickHouse/ClickHouse50k—~1.9kAutomated safety check: NotesApache-2.0
Codex Profilessickn33/agentic-awesome-skills47k1 repos~1.7kAutomated safety check: PassMIT
Better Colorstrycompai/crm11k—~1.9kAutomated safety check: PassMIT

Similar skills

  • Color Expert

    nexu-io/open-design

    Color science expert skill with 286K words of reference material covering OKLCH/OKLAB, palette generation, accessibility/contrast, color naming, pigment mixing, and historical color theory.

    100k GitHub stars~331 tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Profile

    ccusage/ccusage

    Profiles ccusage performance. An agent skill from ccusage/ccusage.

    19k GitHub stars~430 tokensUpdated today
    Auto-check passed
  • Cpu Profile

    ClickHouse/ClickHouse

    Profile a ClickHouse query using the sampling query profiler and system.tracelog.

    50k GitHub stars~1.9k tokensUpdated today
    DatabasesAuto-check: notes
  • Codex Profiles

    sickn33/agentic-awesome-skills

    Use codex-profiles to run Codex CLI or Codex Desktop with isolated CODEXHOME profiles for separate accounts, projects, and local state.

    47k GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Better Colors

    trycompai/crm

    OKLCH color space and color usage for web projects. An agent skill from trycompai/crm.

    11k GitHub stars~1.9k tokensUpdated 1 mo ago
    Frontend & DesignAuto-check passed
  • Maintain Space

    asgeirtj/system_prompts_leaks

    Reconcile new evidence into existing ChatGPT Pages or a Space when the user requests upkeep.

    69k GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed

More from magnus919/agent-skills

All 131 skills in this repo
  • Artifact Pyramids

    magnus919/agent-skills

    Organize durable agent research outputs as summaries, analysis, and evidence dossiers.

    119 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Ascii City Engine

    magnus919/agent-skills

    Build portable, first-person colored ASCII city engines and small GIS-derived city packs.

    119 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Data Scientist

    magnus919/agent-skills

    A skill your agent uses for PhD-level expertise in data science, statistics, and machine learning: rigorous statistical analysis, experimental design, causal inference, advanced modeling, research…

    119 GitHub stars~4.1k tokensUpdated today
    Auto-check passed
  • Docker Compose

    magnus919/agent-skills

    Use Docker Compose to define, run, debug, and harden multi-container applications.

    119 GitHub stars~2k tokensUpdated today
    Auto-check: notes
  • Fpga Development

    magnus919/agent-skills

    Design, review, simulate, and verify FPGA logic using explicit RTL contracts, clock and reset models, CDC analysis, timing constraints, and reproducible implementation evidence.

    119 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Langgraph

    magnus919/agent-skills

    Build multi-agent AI systems with LangGraph — the low-level orchestration framework for stateful, graph-based agent workflows.

    119 GitHub stars~2.8k tokensUpdated today
    Auto-check passed

Questions about Color Management

What does Color Management do?

Manage color workflows with ICC profiles, working spaces, gamut mapping, and color science. Color Management is an agent skill from magnus919/agent-skills. Manage color workflows with ICC profiles, working spaces, gamut mapping, and color science.

When should I use Color Management?

Color Management fits situations like: inspecting ICC profiles; converting between color spaces; checking gamut clipping; validating well-behaved working spaces.

How do I install Color Management in Claude Code?

Run `npx skills add magnus919/agent-skills --skill color-management -a claude-code`. Or copy the skill folder (color-management in magnus919/agent-skills) into .claude/skills/color-management in your project. Claude Code loads it when a task matches its description.

How do I install Color Management in Codex?

Run `npx skills add magnus919/agent-skills --skill color-management -a codex`. Or copy the skill folder (color-management in magnus919/agent-skills) into .agents/skills/color-management in your project. Codex loads it when a task matches its description.

Can I use Color Management in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add magnus919/agent-skills --skill color-management -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/color-management, .gemini/skills/color-management, .github/skills/color-management and .opencode/skills/color-management in your project.

What does Color Management need to run?

Going by SKILL.md and its folder, Color Management needs Python for the scripts in its folder and the command-line tools its instructions call (python3, brew, apt, dnf and pip). Our summary lists: Python 3. Compatibility (from SKILL.md): CLI tools used (ImageMagick, Exiftool, ArgyllCMS, LittleCMS) are platform-independent; Python scripts require Python 3.8+.

Does Color Management access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Color Management safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Color Management use?

Color Management is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Color Management use?

About 2.6k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 16k tokens, read only when the agent opens those files.

What are the alternatives to Color Management?

Skills that share tags, products or a category with Color Management: Color Expert (nexu-io/open-design, 100k stars), Profile (ccusage/ccusage, 19k stars), Cpu Profile (ClickHouse/ClickHouse, 50k stars) and Codex Profiles (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Color Management?

magnus919 (a GitHub user) maintains it in magnus919/agent-skills, which has 119 GitHub stars. The repository holds 131 skills in this directory. The repository was last updated on October 11, 2026.

Source: magnus919/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.