svg-authoring
The one owner for SVG an agent writes by hand. Six lanes produce one — a
missing icon glyph, a geometric mark, an illustration, a diagram, an animated
asset, a wireframe canvas — and until this skill existed none of them had a
procedure or a check beyond the agent's own belief that the file looked right.
When to use
- A glyph the incumbent icon set does not have (
iconography first — the set wins).
- A simple geometric mark, when
logo-generation takes the true-vector path.
- An illustration or a diagram authored as SVG rather than generated.
- An animated asset: SMIL, CSS or WAAPI inside an
.svg or an inline graphic.
- A surgical edit to an existing SVG — "change only the hat", "remove the face".
- A raster converted to a vector — "turn the logo in this PNG into a real vector".
When NOT to use
- The icon exists in the set →
iconography, and stop there.
- A photoreal or illustrative raster →
image-generation.
- A full brand pipeline →
logo-generation (which routes back here for the mark).
- Motion design for video →
motion-choreographer.
Procedure
- Read the delivery mode first — it decides everything after it.
inline
in a host page, a standalone document opened directly, img, a CSS
background, or a deck. It decides what can animate, what can execute, and how
the graphic gets its accessible name. An undeclared mode is treated as
inline, the strictest.
- Classify the asset —
icon, mark, illustration, diagram,
animated. The class picks the fill-ratio threshold and the geometry
tolerance; there is no global threshold, because a 24-grid icon's designed
padding reads as an under-filled viewBox against one.
- Plan before attributes — concept, then layout, then attributes.
Primitives before detail: a mark built from
rect/circle/polygon is a
true vector and is often the right answer, not a lesser one.
- Write with the invariants.
- ids namespaced to the graphic — a bare
id="title" names the second
inline graphic on the page after the first.
- the accessible name comes from the ARIA corpus, not from here: ground
meaningful standalone svg chart graphic accessible name against
accessibility-auditor's aria-patterns.csv and follow the
Meaningful standalone graphic or Decorative graphic row.
- colour from the project's tokens or
currentColor, never a loose hex.
- an explicit
font-family with a fallback the target actually ships; a
<text> with none resolves to the platform serif.
- no
<script>, no on*, no javascript:, no foreignObject, no external
href or url(), no internal DTD subset or <!ENTITY (a bare public
DOCTYPE is fine).
- Run the static check —
lint_svg_asset, with the delivery mode declared:npx tsx node_modules/@event4u/agent-config/src/scripts/lint_svg_asset.ts \
--file path/to/asset.svg --delivery inline
- Run the witness — the asset profile, which opens the file in a real engine:
agent-config ui:render path/to/asset.svg --profile asset --class icon
- Look at the render. Looking stays mandatory for meaning; it is never the
pass for geometry. Fix what both the checks and the look found.
- Stop at a clean witness or after three render passes, whichever comes
first. A stop at the cap with error findings still open reports
unverified with the reason pass-cap-reached and lists what is open —
never verified, and never done. That reason is yours to report: the render
manifest never carries it, because one invocation of ui:render cannot see
how many passes you have made.
- Report the renderer and the checks that actually ran —
verified,
static-only or unverified — plus goal: unassessed, and name only
output files read back from disk. Where the renderer is absent, run the
static witness, report static-only, and name the missing capability in one
line; opening the file in a browser is never a step of this procedure or of
the user's.
Status — what each word is allowed to mean
| Status |
Allowed only when |
verified |
a render manifest from the asset profile exists whose recorded file digest equals the delivered file's digest on disk. A manifest from an earlier pass does not count. |
static-only |
the static check ran and no render did. A parser pass (xmllint --noout) is this, never verified — a file can parse and still be the wrong picture. |
unverified |
no browser resolved, or the pass cap was reached with error findings open (pass-cap-reached). Never a pass; never silently upgraded. |
A second axis, and it is not this table's. Every status above is about
whether a CHECK ran and what it found. Whether the graphic is right is a
different question, and verified was being read as an answer to it. So every
report carries goal: beside the status, and this skill writes exactly one
value into it:
| Goal |
Written by |
unassessed |
always, by this skill and by the renderer. The default, and the only value either may write. |
accepted / rejected |
an owner statement, or a pre-registered scenario witness. Never derived from a digest match, a clean witness, or a score. |
Editing an existing SVG — the baseline replaces the look
Declare the ids the edit is allowed to touch, then let the readout decide:
npx tsx node_modules/@event4u/agent-config/src/scripts/lint_svg_asset.ts \
--file after.svg --baseline before.svg --allow hat,hat-band
Every element outside the allowed set that changed is reported with the attribute
that changed, after number and whitespace canonicalisation. No pixel diff
decides this — anti-aliasing and font metrics would make it a per-machine
verdict.
This applies between the owner's own passes too. A part the user already
accepted joins the baseline and may not move by hand. A conversion pass that
re-derives that part from the source instead re-measures it and re-checks
the accepted property — a hole that was accepted as a hole stays a hole through
a full re-trace.
Converting a raster to a vector — its own branch
Drawing it from a look fails, and it fails the same way every time: the outlines
"coincide within a few pixels" by eye and read 0.883 silhouette IoU when
measured. The procedure below reached 0.984 with the same tools.
Trace to measure, construct to deliver
The trace is the underlay by default, not the deliverable. Trace the source
to measure and to align; then construct the deliverable over that underlay from
few points, palette colours and named shapes. Keep a trace AS the deliverable
only when the owner asks for maximum fidelity over editability, and say that is
what they are getting.
The reason is measured, not stylistic. In one session the traced mark scored
0.989 region IoU against the constructed one's 0.935 — and the trace was sent
back fifteen minutes after it was accepted, on criteria no score sees: a crown
cut at the crop edge, hairlines between segments, an off-palette spot, jagged
edges, 49 KB of edit-hostile points, and a face unreadable at 32 px. The
rebuild was 4.5 KB with 14 shapes and about 180 points. The score is the
alignment check. It is never the acceptance.
When the score stops applying. Once the owner's goal becomes a redesign
rather than a reproduction — different fingers, depth taken from a style
reference — the source-fidelity number measures agreement with something
nobody is still trying to match. Stop reporting it as progress and say why.
- Crop the source region with a margin, and make that crop the coordinate
system. Write every vector coordinate in the crop's pixel units; fit the
viewBox to the content at the end, not at the start. Widen the crop
whenever source content touches its edge — a trace takes the crop border
for a contour, and a comparison against that same crop cannot see the cut.
One session lost a crown that way: the crop started five pixels below it.
The engine's
geometry/source-cut-by-frame reading is the check.
- Derive geometry from the pixels, never by eye — then build over it. One
traced silhouette that clips everything, then named regions split along an
edge map; smooth, resample and simplify each contour. The outer edge comes
from one contour and the holes come from the source. That trace is the
underlay; the shapes you ship are constructed on top of it. A shape with
counters (o, e, a, B, 8, an O-ring mark) declares its
fill-rule, winds
its outer and inner contours in opposite directions, and runs overlap removal
only after both are settled — two same-direction contours under the default
nonzero paint the counter solid.
- Fit colour, do not pick it. Least-squares per region against that region's
own pixels; swap a linear gradient for a radial one only when the residual
actually drops.
- Classify near-white inside the mark as hole or paint from the source, and
check it on a dark background before the first report. Near-white paint
where the source shows a hole is invisible on white and obvious on black.
- Keep text, wordmark and slogan out unless they were asked for.
- Score every pass and every candidate change, and keep a change only when
the score improves — a tried-and-worse idea is dropped by the number, not by
taste. Use the two readings the geometry comparison produces: silhouette IoU
over saturated regions, and mean colour error plus the share of pixels off by
more than 40/255 — broken down per region, so the worst region is named. The
score ranks passes against the source; it does not decide acceptance, and it
stops meaning anything once the goal becomes a redesign.
- Stop at the declared tolerance, at the user's pass budget, or on a
plateau — whichever comes first. A plateau is two consecutive passes each
improving the score by less than 5 % relative: stop, report the residual's
cause, and offer the construct-or-redesign option instead of starting
another pass. An explicit pass budget from the user still wins when it is
smaller. Measured: twelve further scored passes took mean error 16.78 to
6.12 and the share off by 40 from 9.1 % to 1.5 %, and the owner said "still
unclean" twice; the plateau was named only after they brought a reference.
- Snapshot every delivered pass as
<name>.pass-<n>.svg, and diff the next
pass against the last accepted snapshot with lint_svg_asset --baseline.
Report which accepted properties carried forward. Restoring "version 4" is
then a copy, not a reconstruction — one session lost the same accepted
detail twice between hand edits, and the owner had to supply the file back
from their own downloads.
- Report the per-pass numbers, the cause of the remaining residual, and the
file size. Fidelity costs bytes — one accepted conversion went 5.3 KB →
49.5 KB and nothing measured it. Each number carries the registration
it was taken against as
x,y,w,h in the source's pixel frame, the
scorer that produced it (ui:render, or a named script) and the sample
resolution. Two scorers disagreed on one file by a factor of four and
neither number could be told from the other afterwards; a wordmark's frame
could not be recovered at all, and three plausible ones moved its IoU from
0.56 to 0.81.
Any tracing tool the host has may do the deriving, and a host with none can
write one. The measurement is the procedure, not the tool.
Deliver, re-open, re-render
The last step reads every delivered file back from its final path in a fresh
browser context (file://, every other request aborted) and re-renders it from
there — not from the source text the agent wrote. Report path, byte size and
digest. An img delivery is additionally loaded through a host <img> and must
report a non-zero natural width.
A file that does not re-open is not delivered.
Output format
- Delivery mode and asset class — declared, not assumed.
- The file — path, byte size, digest.
- Checks that ran — the static check's finding count, the witness's
readings, and the status word from the table above.
- For a conversion — the per-pass score table and the residual's cause,
each number carrying its registration (
x,y,w,h in the source's pixel
frame), the scorer that produced it and the sample resolution, so a later
run can repeat the reading and no second scorer's number is quoted as the
first's.
- Variants — for a
mark, the small-size variant when the 16 and 32 px
captures lose the detail, and a light-on-dark variant when the contrast
reading is low on a capture's ground. Built, or named as missing. Never
silent: one wordmark shipped in a dark violet that is unreadable on a dark
ground, and the dark variant was simply not mentioned.
- Outlined lettering — a word set from an installed font and converted to
outlines is reported with the font's name and whether its license allows
outlining into a distributed asset. An unknown license is reported as
unknown, never as permitted.
- Cost — the reading the manifest carries (
bytes, elements, paths,
gradients, coordinates), beside the fidelity numbers. No threshold: none
was measured, and a gate on bytes would have refused a 195 KB trace and a
59 KB accepted figure alike.
- What was looked at — honestly, or nothing.
Gotcha
- A
<path> is not evidence of a vector. A raster embedded beside one dummy
path passes a presence-of-<path> check and is not a vector; a mark built
from rect/circle fails that check and is one.
- CSS cannot stop SMIL.
svg * { animation: none !important } under an
emulated reduce leaves an <animate> running. Route the animation itself.
- An
<img>-delivered SVG never sees the OS motion preference. The host
needs a <picture> with a media="(prefers-reduced-motion: reduce)" source
pointing at a static file.
screenshot({ animations: 'disabled' }) does not freeze SMIL. Use
pauseAnimations() + setCurrentTime().
transform-origin without transform-box pivots against the view box, not
the element — per element, so a correct sibling proves nothing about it.
keySplines outside [0,1] stops the animation outright rather than
clamping it.
Do NOT
- Do NOT report
verified on a look, a parser pass, or a render of an earlier
draft.
- Do NOT say "matches" or "100 %" about a conversion without the two numbers and
the registration they were measured against.
- Do NOT rename ids or simplify paths as a side effect of a surgical edit.
- Do NOT restate motion, ARIA or render-security mechanism here — point at the
authority and let it own the rule.
- Do NOT add a rasteriser, a tracing dependency, or an optimiser to the write path.
See also
Named rather than linked, and that is a correctness property rather than a
style one: this skill ships in four packs, so a relative link to an artifact
that lives in only one of them resolves for a consumer who installed that pack
and is dead for the other three. The names are stable; the paths are not
promises this skill can keep.
iconography — the set comes first; this skill is
for the glyph it lacks.
logo-generation — the brand pipeline that
routes a geometric mark here.
type-design — "the rest of the alphabet" / "make this a font": a
wordmark extended into a constructed font, reusing the trace and counter rule.
image-provider-routing — illustrative
vector art goes to a provider, not here.
fe-design § Motion — the motion authority, in
references/design-patterns.md § Motion — decision-tree and rationale. The
SVG mechanism lines are step 6b, "Which mechanism carries it inside an
SVG?" — transform-box, pathLength, the keySplines range, path-morph
command equality, and delivery mode picking the reduced-motion route. Cited
here and never restated.
frontend-render-security § The
patterns AI ships by default, row Untrusted SVG markup into an HTML sink
— the sinks an SVG carries into a host origin, and what each delivery mode
can execute. Its § Backstop greps carries the grep that finds them.
design-intelligence — diagram layout; its
geometric pre-checks are witnessed by the asset profile now.
accessibility-auditor — the ARIA
corpus that answers what a graphic's accessible name has to be; its
data/aria-patterns.csv carries the Meaningful standalone graphic and
Decorative graphic rows this skill grounds against rather than copies.
canvas-design, wireframe
— the two lanes that use SVG as an execution surface.
design-fidelity — a provided artifact is
the spec; the baseline readout above is its surgical-edit witness.
docs/contracts/design-artifact-verification.md — frame_seek and the other
primitives the witness depends on.
1---2model_tier: inherit3name: svg-authoring4description: "Hand-author or edit an SVG — icon, mark, illustration, diagram, animation, raster-to-vector — checked and rendered."5domain: product6personas:7 - design-director8workspaces:9 - engineering10packs:11 - frontend-design12 - ai-image13 - ai-video14 - engineering-base15trust:16 level: professional17install:18 removable: true19scope:20 write: []21 verification_reason: "execution declares no handler, so this skill runs nothing of its own — every write is the calling agent's, under the rules that govern it. No command can prove a scope the skill never executes."22execution:23 type: manual24metadata:25 source: https://skillmd.com/skills/event4u-app/svg-authoring26---2728# svg-authoring2930> The one owner for SVG an agent writes by hand. Six lanes produce one — a31> missing icon glyph, a geometric mark, an illustration, a diagram, an animated32> asset, a wireframe canvas — and until this skill existed none of them had a33> procedure or a check beyond the agent's own belief that the file looked right.3435## When to use3637- A glyph the incumbent icon set does not have (`iconography` first — the set wins).38- A simple geometric mark, when `logo-generation` takes the true-vector path.39- An illustration or a diagram authored as SVG rather than generated.40- An animated asset: SMIL, CSS or WAAPI inside an `.svg` or an inline graphic.41- A **surgical edit** to an existing SVG — "change only the hat", "remove the face".42- A **raster converted to a vector** — "turn the logo in this PNG into a real vector".4344## When NOT to use4546- The icon exists in the set → `iconography`, and stop there.47- A photoreal or illustrative raster → `image-generation`.48- A full brand pipeline → `logo-generation` (which routes back here for the mark).49- Motion design for video → `motion-choreographer`.5051## Procedure52531. **Read the delivery mode first — it decides everything after it.** `inline`54 in a host page, a standalone `document` opened directly, `img`, a CSS55 background, or a deck. It decides what can animate, what can execute, and how56 the graphic gets its accessible name. An **undeclared** mode is treated as57 `inline`, the strictest.582. **Classify the asset** — `icon`, `mark`, `illustration`, `diagram`,59 `animated`. The class picks the fill-ratio threshold and the geometry60 tolerance; there is no global threshold, because a 24-grid icon's designed61 padding reads as an under-filled viewBox against one.623. **Plan before attributes** — concept, then layout, then attributes.63 Primitives before detail: a mark built from `rect`/`circle`/`polygon` is a64 true vector and is often the right answer, not a lesser one.654. **Write with the invariants.**66 - ids namespaced to the graphic — a bare `id="title"` names the second67 inline graphic on the page after the first.68 - the accessible name comes from the ARIA corpus, not from here: ground69 `meaningful standalone svg chart graphic accessible name` against70 `accessibility-auditor`'s `aria-patterns.csv` and follow the71 **Meaningful standalone graphic** or **Decorative graphic** row.72 - colour from the project's tokens or `currentColor`, never a loose hex.73 - an explicit `font-family` with a fallback the target actually ships; a74 `<text>` with none resolves to the platform serif.75 - no `<script>`, no `on*`, no `javascript:`, no `foreignObject`, no external76 `href` or `url()`, no internal DTD subset or `<!ENTITY` (a bare public77 DOCTYPE is fine).785. **Run the static check** — `lint_svg_asset`, with the delivery mode declared:79 ```bash80 npx tsx node_modules/@event4u/agent-config/src/scripts/lint_svg_asset.ts \81 --file path/to/asset.svg --delivery inline82 ```836. **Run the witness** — the asset profile, which opens the file in a real engine:84 ```bash85 agent-config ui:render path/to/asset.svg --profile asset --class icon86 ```877. **Look at the render.** Looking stays mandatory for *meaning*; it is never the88 pass for *geometry*. Fix what both the checks and the look found.898. **Stop** at a clean witness or after three render passes, whichever comes90 first. A stop **at the cap with error findings still open** reports91 `unverified` with the reason `pass-cap-reached` and lists what is open —92 never `verified`, and never done. That reason is yours to report: the render93 manifest never carries it, because one invocation of `ui:render` cannot see94 how many passes you have made.959. **Report** the renderer and the checks that actually ran — `verified`,96 `static-only` or `unverified` — plus `goal: unassessed`, and name only97 output files read back from disk. Where the renderer is **absent**, run the98 static witness, report `static-only`, and name the missing capability in one99 line; opening the file in a browser is never a step of this procedure or of100 the user's.101102## Status — what each word is allowed to mean103104| Status | Allowed only when |105|---|---|106| `verified` | a render manifest from the asset profile exists **whose recorded file digest equals the delivered file's digest on disk**. A manifest from an earlier pass does not count. |107| `static-only` | the static check ran and no render did. A parser pass (`xmllint --noout`) is this, never `verified` — a file can parse and still be the wrong picture. |108| `unverified` | no browser resolved, or the pass cap was reached with error findings open (`pass-cap-reached`). Never a pass; never silently upgraded. |109110**A second axis, and it is not this table's.** Every status above is about111whether a CHECK ran and what it found. Whether the graphic is *right* is a112different question, and `verified` was being read as an answer to it. So every113report carries `goal:` beside the status, and this skill writes exactly one114value into it:115116| Goal | Written by |117|---|---|118| `unassessed` | **always, by this skill and by the renderer.** The default, and the only value either may write. |119| `accepted` / `rejected` | an owner statement, or a pre-registered scenario witness. Never derived from a digest match, a clean witness, or a score. |120121## Editing an existing SVG — the baseline replaces the look122123Declare the ids the edit is allowed to touch, then let the readout decide:124125```bash126npx tsx node_modules/@event4u/agent-config/src/scripts/lint_svg_asset.ts \127 --file after.svg --baseline before.svg --allow hat,hat-band128```129130Every element outside the allowed set that changed is reported with the attribute131that changed, after number and whitespace canonicalisation. **No pixel diff132decides this** — anti-aliasing and font metrics would make it a per-machine133verdict.134135This applies **between the owner's own passes** too. A part the user already136accepted joins the baseline and may not move by hand. A conversion pass that137re-derives that part from the source instead **re-measures** it and re-checks138the accepted property — a hole that was accepted as a hole stays a hole through139a full re-trace.140141## Converting a raster to a vector — its own branch142143Drawing it from a look fails, and it fails the same way every time: the outlines144"coincide within a few pixels" by eye and read 0.883 silhouette IoU when145measured. The procedure below reached 0.984 with the same tools.146147### Trace to measure, construct to deliver148149**The trace is the underlay by default, not the deliverable.** Trace the source150to measure and to align; then construct the deliverable over that underlay from151few points, palette colours and named shapes. Keep a trace AS the deliverable152only when the owner asks for maximum fidelity over editability, and say that is153what they are getting.154155The reason is measured, not stylistic. In one session the traced mark scored1560.989 region IoU against the constructed one's 0.935 — and the trace was sent157back fifteen minutes after it was accepted, on criteria no score sees: a crown158cut at the crop edge, hairlines between segments, an off-palette spot, jagged159edges, 49 KB of edit-hostile points, and a face unreadable at 32 px. The160rebuild was 4.5 KB with 14 shapes and about 180 points. **The score is the161alignment check. It is never the acceptance.**162163**When the score stops applying.** Once the owner's goal becomes a redesign164rather than a reproduction — different fingers, depth taken from a style165reference — the source-fidelity number measures agreement with something166nobody is still trying to match. Stop reporting it as progress and say why.1671681. **Crop the source region with a margin, and make that crop the coordinate169 system.** Write every vector coordinate in the crop's pixel units; fit the170 viewBox to the content at the end, not at the start. **Widen the crop171 whenever source content touches its edge** — a trace takes the crop border172 for a contour, and a comparison against that same crop cannot see the cut.173 One session lost a crown that way: the crop started five pixels below it.174 The engine's `geometry/source-cut-by-frame` reading is the check.1752. **Derive geometry from the pixels, never by eye — then build over it.** One176 traced silhouette that clips everything, then named regions split along an177 edge map; smooth, resample and simplify each contour. The outer edge comes178 from one contour and the holes come from the source. That trace is the179 underlay; the shapes you ship are constructed on top of it. **A shape with180 counters** (o, e, a, B, 8, an O-ring mark) declares its `fill-rule`, winds181 its outer and inner contours in opposite directions, and runs overlap removal182 only after both are settled — two same-direction contours under the default183 `nonzero` paint the counter solid.1843. **Fit colour, do not pick it.** Least-squares per region against that region's185 own pixels; swap a linear gradient for a radial one only when the residual186 actually drops.1874. **Classify near-white inside the mark as hole or paint from the source**, and188 check it on a dark background **before** the first report. Near-white paint189 where the source shows a hole is invisible on white and obvious on black.1905. **Keep text, wordmark and slogan out** unless they were asked for.1916. **Score every pass and every candidate change**, and keep a change only when192 the score improves — a tried-and-worse idea is dropped by the number, not by193 taste. Use the two readings the geometry comparison produces: silhouette IoU194 over saturated regions, and mean colour error plus the share of pixels off by195 more than 40/255 — broken down per region, so the worst region is named. The196 score ranks passes against the source; it does not decide acceptance, and it197 stops meaning anything once the goal becomes a redesign.1987. **Stop** at the declared tolerance, at the user's pass budget, or **on a199 plateau** — whichever comes first. A plateau is two consecutive passes each200 improving the score by less than 5 % relative: stop, report the residual's201 cause, and offer the construct-or-redesign option instead of starting202 another pass. An explicit pass budget from the user still wins when it is203 smaller. Measured: twelve further scored passes took mean error 16.78 to204 6.12 and the share off by 40 from 9.1 % to 1.5 %, and the owner said "still205 unclean" twice; the plateau was named only after they brought a reference.2068. **Snapshot every delivered pass** as `<name>.pass-<n>.svg`, and diff the next207 pass against the last accepted snapshot with `lint_svg_asset --baseline`.208 Report which accepted properties carried forward. Restoring "version 4" is209 then a copy, not a reconstruction — one session lost the same accepted210 detail twice between hand edits, and the owner had to supply the file back211 from their own downloads.2129. **Report the per-pass numbers, the cause of the remaining residual, and the213 file size.** Fidelity costs bytes — one accepted conversion went 5.3 KB →214 49.5 KB and nothing measured it. Each number carries the **registration**215 it was taken against as `x,y,w,h` in the source's pixel frame, the216 **scorer** that produced it (`ui:render`, or a named script) and the sample217 resolution. Two scorers disagreed on one file by a factor of four and218 neither number could be told from the other afterwards; a wordmark's frame219 could not be recovered at all, and three plausible ones moved its IoU from220 0.56 to 0.81.221222Any tracing tool the host has may do the deriving, and a host with none can223write one. **The measurement is the procedure, not the tool.**224225## Deliver, re-open, re-render226227The last step reads every delivered file back **from its final path** in a fresh228browser context (`file://`, every other request aborted) and re-renders it from229there — not from the source text the agent wrote. Report path, byte size and230digest. An `img` delivery is additionally loaded through a host `<img>` and must231report a non-zero natural width.232233**A file that does not re-open is not delivered.**234235## Output format2362371. **Delivery mode and asset class** — declared, not assumed.2382. **The file** — path, byte size, digest.2393. **Checks that ran** — the static check's finding count, the witness's240 readings, and the status word from the table above.2414. **For a conversion** — the per-pass score table and the residual's cause,242 each number carrying its **registration** (`x,y,w,h` in the source's pixel243 frame), the scorer that produced it and the sample resolution, so a later244 run can repeat the reading and no second scorer's number is quoted as the245 first's.2465. **Variants** — for a `mark`, the small-size variant when the 16 and 32 px247 captures lose the detail, and a light-on-dark variant when the contrast248 reading is low on a capture's ground. Built, or named as missing. Never249 silent: one wordmark shipped in a dark violet that is unreadable on a dark250 ground, and the dark variant was simply not mentioned.2516. **Outlined lettering** — a word set from an installed font and converted to252 outlines is reported with the font's name and whether its license allows253 outlining into a distributed asset. An unknown license is reported as254 unknown, never as permitted.2557. **Cost** — the reading the manifest carries (`bytes`, `elements`, `paths`,256 `gradients`, `coordinates`), beside the fidelity numbers. No threshold: none257 was measured, and a gate on bytes would have refused a 195 KB trace and a258 59 KB accepted figure alike.2598. **What was looked at** — honestly, or nothing.260261## Gotcha262263- **A `<path>` is not evidence of a vector.** A raster embedded beside one dummy264 path passes a presence-of-`<path>` check and is not a vector; a mark built265 from `rect`/`circle` fails that check and is one.266- **CSS cannot stop SMIL.** `svg * { animation: none !important }` under an267 emulated `reduce` leaves an `<animate>` running. Route the animation itself.268- **An `<img>`-delivered SVG never sees the OS motion preference.** The host269 needs a `<picture>` with a `media="(prefers-reduced-motion: reduce)"` source270 pointing at a static file.271- **`screenshot({ animations: 'disabled' })` does not freeze SMIL.** Use272 `pauseAnimations()` + `setCurrentTime()`.273- **`transform-origin` without `transform-box` pivots against the view box**, not274 the element — per element, so a correct sibling proves nothing about it.275- **`keySplines` outside [0,1] stops the animation outright** rather than276 clamping it.277278## Do NOT279280- Do NOT report `verified` on a look, a parser pass, or a render of an earlier281 draft.282- Do NOT say "matches" or "100 %" about a conversion without the two numbers and283 the registration they were measured against.284- Do NOT rename ids or simplify paths as a side effect of a surgical edit.285- Do NOT restate motion, ARIA or render-security mechanism here — point at the286 authority and let it own the rule.287- Do NOT add a rasteriser, a tracing dependency, or an optimiser to the write path.288289## See also290291> Named rather than linked, and that is a correctness property rather than a292> style one: this skill ships in four packs, so a relative link to an artifact293> that lives in only one of them resolves for a consumer who installed that pack294> and is dead for the other three. The names are stable; the paths are not295> promises this skill can keep.296297- `iconography` — the set comes first; this skill is298 for the glyph it lacks.299- `logo-generation` — the brand pipeline that300 routes a geometric mark here.301- `type-design` — "the rest of the alphabet" / "make this a font": a302 wordmark extended into a constructed font, reusing the trace and counter rule.303- `image-provider-routing` — illustrative304 vector art goes to a provider, not here.305- `fe-design` § Motion — the motion authority, in306 `references/design-patterns.md` § *Motion — decision-tree and rationale*. The307 SVG mechanism lines are step **6b, "Which mechanism carries it inside an308 SVG?"** — `transform-box`, `pathLength`, the `keySplines` range, path-morph309 command equality, and delivery mode picking the reduced-motion route. Cited310 here and never restated.311- `frontend-render-security` § *The312 patterns AI ships by default*, row **Untrusted SVG markup into an HTML sink**313 — the sinks an SVG carries into a host origin, and what each delivery mode314 can execute. Its § *Backstop greps* carries the grep that finds them.315- `design-intelligence` — diagram layout; its316 geometric pre-checks are witnessed by the asset profile now.317- `accessibility-auditor` — the ARIA318 corpus that answers what a graphic's accessible name has to be; its319 `data/aria-patterns.csv` carries the **Meaningful standalone graphic** and320 **Decorative graphic** rows this skill grounds against rather than copies.321- `canvas-design`, `wireframe`322 — the two lanes that use SVG as an execution surface.323- `design-fidelity` — a provided artifact is324 the spec; the baseline readout above is its surgical-edit witness.325- `docs/contracts/design-artifact-verification.md` — `frame_seek` and the other326 primitives the witness depends on.