Style checks
A style check measures each image delivered for a request that names a style guide, and compares it with that style's own references and samples. When an image sits outside the style, review shows a warning beside the spec warnings. The style's page in the Library lists accepted images that sit outside it, so a library that drifted, with some portraits bold and flat and others soft and painted, shows up in one place. Style checks come with the Pro, Team and Enterprise plans.
A style check is a warning, never a block. A reviewer can still accept the image.
What it measures
No AI is involved, so the same file and the same style version always give the same result. Asset Goes Here scales each image down to 256 pixels on its long side and leaves out transparent pixels, so a cut-out character is measured and its empty background isn't. Then it measures:
| Measurement | What it is |
|---|---|
| Ink coverage | The share of near-black pixels, such as inked contours and crosshatching |
| Edge density | The share of pixels on a sharp edge |
| Flat vs gradient | The share of flat fills, against soft gradients and painted light |
| Colour count | How many colours carry the image, leaving out speckle and anti-aliasing |
| Saturation | How vivid the colours are, on average |
| Brightness | How light the image is, on average |
| Warmth | How far the colours lean to red rather than blue |
| Texture fingerprint | Local brightness patterns and edge directions together, which separate inked hatching from brushwork |
How style measurements work gives the exact calculation behind each one, and what to change in an image to move it.
How it compares
Each style defines its own range, without fixed thresholds. Asset Goes Here measures the style's image references and sample images, and takes the range they span on each measurement, widened a little so that three similar references don't flag every small difference. For the texture fingerprint, it takes how far the references sit from their own average. An image is outside the style when two or more measurements fall outside the range, and review lists each one with the image's value, the range and a bar that shows both.
- Roles. When an image has a
roletag, such asrole=portrait, and at least three references share it, only those references set the range. Portraits and backgrounds then each have their own range, so the subject doesn't decide the result. Sample images always count. - Enough references. A style needs at least three image references and samples before images are checked. With fewer, review says the image wasn't checked and links to the style so you can add some.
- Versions. A check uses the style as it is when the file is delivered. When the style changes, the Library's list is worked out again against the new references.
In the Library
On Style guides, each style with an images section lists Outside the style: its accepted images that sit outside it now, each with the measurement furthest out of range. Request revision asks for a new version of one, and Request revisions for all asks for all of them. Each current file stays until a new one is accepted.
Images accepted before style checks are measured the first time the list is opened, 40 at a time. A large library fills in over a few visits, and the list says how many have been measured so far.
Compare an image with every style
Open an image in the Library and Compare with styles measures it against each of the project's styles with an images section. The style it names comes first, marked attached or its style, then the closest fits. Each row says Within the style, Outside with how many readings are out of range, or that the style doesn't have enough references yet, and opens to show each reading against the style's range, as in review.
Admins and developers can Attach this style from a row, which attaches it without a new version, or Request revision in this style from a row the image sits outside. The image measured is the accepted file, or the delivery under review when there is none. SVG images aren't measured.
agh style compare location.aberlis_hall.night
agh style compare location.aberlis_hall.night --pending # the delivery waiting for review
Coding agents call compare_styles, with file: "pending" for the delivery under review.
On Review
A delivered image under Review has the same Compare with styles section below its style check, measuring the new delivery rather than the published file it replaces. Its closed line already names the closest fit, so a revision that drifted toward another style shows at a glance. The request's own style comes first, marked this request, and the best match is marked closest fit. From another style's row:
- Use this style for the request changes the request's style without rejecting the delivery. Accepted, the file counts as attached to that style.
- Reject and ask for it in this style, on a style the delivery sits outside, sends it back with a note and the request moved to that style, so the next version is made from its words and references.
For agents and the CLI
An image delivered in a style carries the check as styleCheck on its pending file: in get_asset, get_file_link and review_delivery results, and in the API. It holds state, outside, a one-line summary, every reading's value, low, high and outside, and what the image was compared with. The list_outside_style tool lists a style's accepted images that sit outside it.
agh show character.maren.bust_portrait # the pending file's style check, with its out-of-range readings
agh style outside living_comic # accepted images outside the style
API
| Route | Who | What |
|---|---|---|
GET /projects/{id}/assets/{asset}/styles | members | The image measured against every style with an images section: each style's check, with named for the asset's own. ?file=pending measures the delivery under review; current the accepted or published file, the default when there is one. Free and Supporter plans get 402 with a link here. |
GET /projects/{id}/styles/{style}/outside | members | Accepted images outside the style, with measured and total while older images are still being measured. Free and Supporter plans get 402 with a link here. |
Plans
Style checks measure every file, so they come with the plans that cover running costs: Pro, Team and Enterprise. On Free and Supporter, review says that the image wasn't checked and links here and to the upgrade. An org admin can upgrade under Admins & projects › Plan & billing.
For agents: this page as Markdown is at /docs/style-checks.md, and the CLI prints it with agh guide style-checks.