Grade Images skill
A Codex skill for photo color grading and RAW development from a JSON recipe, with no generative edits and faces and texture kept.
- 58 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- The skill runs local Python scripts and reads and writes image files in the chosen folder
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/grade-imagesDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The skill runs local Python scripts and reads and writes image files in the chosen folder
This is third-party code. Review the repository files before installing.
What it does
Grade Images processes photographs deterministically: it develops RAW and DNG files, fixes exposure and white balance, matches a shot to a reference and keeps a series consistent. The agent interprets intent and reviews previews, while a local renderer changes pixels from a versioned JSON recipe. The source file is never overwritten and the recipe is saved beside the result. No generative editor is involved. Size, geometry, faces, objects, text and texture stay unchanged, and light effects such as a halo or glow are added only with explicit consent and only from real highlights in the shot. Sharpening is enabled by a separate request.
Who it is for. Photographers and content authors who grade shots in Codex and want a reproducible result without the frame being redrawn.
Good fit when
- A series of event photos must look consistent after shooting under mixed light
- A frame has to be matched to the palette of a reference with shadows, midtones and highlights checked
- A camera RAW file needs a careful development with known parameters recorded in a manifest
- A client asks for a calm cinematic or documentary look and three strengths should be compared before the full run
Not a fit when
- Retouching, background replacement, object removal or detail painting is needed, which the skill refuses
- Video or animated images must be processed, which the skill does not support
- A JPEG is overexposed and lost detail is expected back, which cannot be recovered
Example request
Grade the photos in this folder to a calm cinematic look, render previews of three strengths first and save the recipes.Limitations
The skill targets Codex and is installed by copying a folder, with no package manager. Python 3.10 or newer is required, and RAW and DNG additionally need rawpy with LibRaw. Single-frame 8-bit JPEG and PNG are accepted, and a RAW result is saved as an 8-bit PNG or JPEG. Retouching, geometry changes, denoising, grain and generative edits are unsupported. Light effects need explicit consent and sharpening is enabled only by a separate request. Codex is restarted after installing or updating. The repository is small and maintained by one author.
How to disable. Delete the `grade-images` folder from the Codex skills directory and restart Codex. Recipes and results sit beside your photos and are cleaned up by hand.
FAQ
Is a RAW decoder required?
Only for RAW and DNG. Install the dependencies from `requirements-raw.txt` for them, while JPEG and PNG work without rawpy.
Does the skill change source files?
No. The source is never overwritten, and the result and recipe are saved separately so any version can be reproduced.
How do I compare processing strength?
The `scripts/variants.py` script builds conservative, standard and bold variants from one base recipe with labeled previews beside the original.
Can a shot be matched to a reference?
Yes. `scripts/compare.py` with `--reference` shows how tone, saturation and balance match across brightness zones and suggests the next adjustment.
Can sharpening be added?
Yes, but only through a separate explicit request under schema 1.3. The skill never infers sharpening from a style, reference or strength.
Discussion
No questions or reviews yet.
Related
SkillsA skill that makes an editorial poster from a photo: the shot stays unchanged, with an abstract panel and a local title beside it.
A Codex skill that turns a photograph into a vertical composition with an abstract memory panel and an English title
Five image-generation skills: Qwen-Image prompts, logos with shared geometry, diary comics, transparent PNGs and process dioramas
Travel Photo Abstraction turns a photo into an editorial abstraction tied to the shape, count and position of its subjects.
A Codex skill that redraws your photo as a watercolor illustration on white paper, with wide margins and a handwritten caption
Rebuilds light, exposure and skin of a finished portrait while the person stays the same and the skin loses its plastic look.
README in short
The structure and proportions of a shot are protected at any strength. Color strength and permission for light effects are set independently.