# Image Utility

Review generated images, apply deterministic image editing, convert formats, and request explicit age-rating estimates.

Package version: 0.1.0-beta.6.

[Open Web Tools](https://basic-image-tools.fayegram.com) — MCP · MCP Apps · WebMCP

## Overview

Four image skills provide artifact and conformance assessment, precise drawing and editing, static format conversion, and informational age-rating estimates. Each workflow has a dedicated execution or assessment role.

## What you can do

- Choose stronger generated images using visible artifact and conformance evidence.
- Draw, annotate, composite, crop, and transform static images with precise operations.
- Convert JPEG, PNG, WebP, and base64, or request a structured rating estimate.

## Get started

- [Generated-image artifact audit](/skills/faye-image-utility/faye-image-artifact-audit/) — Assess generated images for artifacts and conformance.
- [Painting and annotation](/skills/faye-image-utility/simple-paint-n-annotation/) — Apply deterministic drawing, annotation, and image edits.
- [Image format conversion](/skills/faye-image-utility/faye-image-format-converter/) — Convert static image formats without generative editing.
- [Informational image age ratings](/skills/faye-image-utility/faye-image-age-rating/) — Request an informational estimate, subject to the literal invocation requirement below.

## Explicit rating requests

Age estimates require an explicit `$faye-image-age-rating` mention. They are informational, not official ratings. Provide accessible images and an explicit output path when the destination matters.

## Requirements

- All four skills require their bundled agents.

- Conversion, editing, and the rating contract runtime use the plugin’s Python launcher: Python 3.10+, `venv/ensurepip`, and Pillow 12.3.0+ with LittleCMS2 are required.

- Set `FAYE_WORKSPACE_ROOT` to the active project.

- Locked wheels install into an isolated project-local environment on first use; host software is not automatically installed or upgraded.

## Choosing the right image workflow

Painting and conversion produce real static image files; artifact audits and age-rating estimates assess images. Generative fill, semantic object removal, animation, PDF annotation, and moderation decisions are outside this package. The individual guides explain overwrite rules, image limits, and the difference between validated output and a substantively correct visual judgment.

## Web tools

Faye Image Utility is also available as web tools for inspecting and comparing images, converting formats, and drawing or annotating. Conversion and editing run in your browser.

Use the tools directly, or work with a compatible agent:

- **MCP and MCP Apps:** Connect through MCP to open the interactive tools in a compatible MCP Apps host.
- **WebMCP:** A compatible browser agent can discover and use the tools while the page is open.

Artifact Audit and Age Rating use your connected agent and require the corresponding Faye assessment skill. Your agent supplies the assessment.

[Open web tools ↗](https://basic-image-tools.fayegram.com) · [Connection help ↗](https://basic-image-tools.fayegram.com/help)

## Skills and supporting files

- [Generated-image artifact audit](/skills/faye-image-utility/faye-image-artifact-audit/) — Find visible artifacts, assess prompt and reference conformance, and choose images worth keeping or repairing.
- [Painting and annotation](/skills/faye-image-utility/simple-paint-n-annotation/) — Add precise text, arrows, shapes, and image composites, or apply deterministic crop, resize, and transform operations.
- [Informational image age ratings](/skills/faye-image-utility/faye-image-age-rating/) — Estimate image age/content ratings by analogy to five named systems and explain the visible causes in validated JSON.
- [Image format conversion](/skills/faye-image-utility/faye-image-format-converter/) — Convert static images among JPEG, PNG, WebP, and base64 with real, verified output files.
- [Image assessor](/agents/faye-image-utility/faye-image-assessor/) — Defines the read-only visual assessor used by artifact audits and explicit age-rating estimates.
- [Image painter](/agents/faye-image-utility/faye-image-painter/) — Defines the write-capable role that executes deterministic painting and editing.
- [Image converter agent](/agents/faye-image-utility/image-processor/) — Defines the role that executes and verifies supported image format conversions.
- [Rating runtime exports](/scripts/faye-image-utility/init-f04a17a6/) — Exposes the rating catalog, request normalization, system resolution, validation, and rendering functions.
- [Rating catalog loader](/scripts/faye-image-utility/catalog-ad87204c/) — Loads the skill's authoritative rating-system catalog for deterministic processing.
- [Technical image metrics](/scripts/faye-image-utility/image-metrics-cc3496c3/) — Computes deterministic image signals used to assess inspectability and confidence.
- [Rating request normalization](/scripts/faye-image-utility/request-contract-584dbe41/) — Normalizes the requested images, systems, causes, and output options.
- [Validated rating response rendering](/scripts/faye-image-utility/response-rendering-cc538ea2/) — Renders the public rating response only after correlated result validation.
- [Rating content consistency](/scripts/faye-image-utility/result-content-0828c3c2/) — Validates rating entries, visible causes, interactive risks, and review status.
- [Correlated rating validation](/scripts/faye-image-utility/result-contract-24319a3c/) — Checks a candidate result against its normalized request and resolved image plan.
- [Rating system selection](/scripts/faye-image-utility/system-resolution-c3ca5c2b/) — Applies deterministic rules for explicit and medium-based system selection.
- [Rating validation primitives](/scripts/faye-image-utility/validation-helpers-57c15db9/) — Provides shared checks for exact fields, text, lists, enums, and correlated values.
- [Local image preflight](/scripts/faye-image-utility/preflight-age-rating-images-11246991/) — Checks local rating images and returns technical decode, size, duplicate, and image-quality evidence.
- [Rating contract driver](/scripts/faye-image-utility/validate-age-rating-contract-9ce3ec00/) — Normalizes, resolves, validates, or renders a rating workflow from structured input.
- [Image conversion engine](/scripts/faye-image-utility/convert-image-58fb51f8/) — Decodes and writes static JPEG, PNG, WebP, and base64 representations.
- [Image workspace storage](/references/faye-image-utility/workspace-storage-e67b2ca0/) — Defines contained output, runtime, and temporary-session storage for image workflows.
- [Rating system catalog](/references/faye-image-utility/age-rating-catalog-66a6b578/) — Defines supported system IDs, rating labels, cause categories, and ordering.
- [Rating request schema](/references/faye-image-utility/age-rating-request-schema-207517b1/) — Describes the public structured request accepted by the age-rating workflow.
- [Rating result schema](/references/faye-image-utility/age-rating-result-schema-4380d203/) — Describes the structured rating result and its required public fields.
- [Informational rating guidance](/references/faye-image-utility/age-rating-systems-afbbfb35/) — Explains how the supported rating systems inform image estimates and visible-cause reporting.
- [Rating assessor protocol](/references/faye-image-utility/assessor-protocol-b40b53f9/) — Defines the visual assessor's stages and handoff in an explicit age-rating workflow.
- [Structured rating workflow](/references/faye-image-utility/structured-rating-contract-90f0120a/) — Documents requests, medium determination, system resolution, cause selection, and result correlation.
- [Artifact assessor protocol](/references/faye-image-utility/assessor-protocol-de9afb1e/) — Defines the image assessor's evidence and reporting responsibilities for artifact audits.
- [Artifact judgment framework](/references/faye-image-utility/audit-framework-8441f189/) — Defines the audit's evidence standard, finding model, and canonical assessment scales.
- [Objects and built scenes](/references/faye-image-utility/objects-and-built-scenes-b7ed05a6/) — Guides inspection of object structure, attachment, geometry, and constructed environments.
- [Optics, materials, and environment](/references/faye-image-utility/optics-materials-and-environment-95062e97/) — Guides checks of reflections, transparency, lighting, material behavior, and environmental effects.
- [Artifact audit handoff](/references/faye-image-utility/parent-handoff-3f276eb0/) — Defines the context and resolved reference paths supplied to the image assessor.
- [People and creatures](/references/faye-image-utility/people-and-creatures-824edbc6/) — Guides artifact inspection of anatomy, pose, limbs, accessories, clothing, and contact.
- [Audit aggregation](/references/faye-image-utility/aggregation-cc4c66f0/) — Explains how individual findings contribute to an overall artifact-audit assessment.
- [Batch comparison reports](/references/faye-image-utility/batch-compare-e1d3f9e3/) — Structures comparison across image variants or a series.
- [Compact audit reports](/references/faye-image-utility/compact-0f67fa5b/) — Provides a concise format for a useful artifact verdict and its key evidence.
- [Detailed audit reports](/references/faye-image-utility/deep-24e67fa9/) — Structures a fuller artifact assessment across relevant visual domains.
- [Audit reporting examples](/references/faye-image-utility/examples-d56b2643/) — Shows examples of how the artifact reporting contract is expressed.
- [Actionable repair targets](/references/faye-image-utility/repair-b3d54f4a/) — Explains how to describe a required visual correction while preserving valid image content.
- [Targeted audit reports](/references/faye-image-utility/targeted-dd841f32/) — Structures findings for named regions, subjects, or visual domains.
- [Rapid artifact triage](/references/faye-image-utility/triage-2b6be199/) — Provides a short screening format for early image selection or large sets.
- [Artifact report vocabulary](/references/faye-image-utility/reporting-2cc73e54/) — Defines reporting principles, modes, and terms for artifact-audit output.
- [Style and conformance](/references/faye-image-utility/styles-prompts-and-series-d0eec44f/) — Calibrates artifact inspection against rendering style, prompts, references, and series continuity.
- [Text, products, and interfaces](/references/faye-image-utility/text-products-and-interfaces-32d9ce23/) — Guides checks of labels, typography, branding, packaging, UI, charts, and diagrams.
- [Deterministic editor contract](/references/faye-image-utility/editor-contract-5cdd6325/) — Documents structured drawing, compositing, transform, and output operations for the image editor.

## Package manifest

[View package manifest](/manifests/faye-image-utility/)