Redesign an existing website to make it better. Built on top of impeccable.
88%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Low
Low-risk findings worth noting
Every check, what it validates, its finding ids, and why each severity is what it is. Layers: delivery = raw fetch of what the pipeline serves; rendered = headless chromium after block decoration.
Severity philosophy: error = a visitor or crawler is harmed right now; warn = probably wrong or needs human/LLM triage; info = evidence worth recording, no action implied. Findings marked triage carry enough evidence for a judgment pass without re-crawling.
| id | sev | what |
|---|---|---|
page-not-200 | error | inventory path doesn't serve 200 |
plain-not-200 | error | .plain.html variant missing — content doc not delivered |
fragment-not-200 | error | chrome fragment (nav/footer) missing |
redirect-not-firing | error | a /redirects.json rule doesn't redirect |
redirect-dest-broken | error | redirect lands on a non-200 |
no-redirects-sheet | info | no /redirects.json — verification skipped |
redirect-missing / redirect-dest-differs | error / warn | a stardust/redirects.tsv row is absent from /redirects.json / points elsewhere |
trailing-slash-broken | warn | a folder index fails at /path (no redirect to /path/) |
404-not-404 | error | unknown paths don't 404 (soft-404s poison crawlers) |
404-page-empty | warn | 404 body is near-empty (unstyled error page) |
sitemap-missing | error | no sitemap.xml |
sitemap-lists-fragment | error | sitemap exposes nav/footer as pages |
sitemap-only-page | warn | published page nobody tracks |
missing-from-sitemap | warn | tracked page invisible to crawlers |
.plain.html)| id | sev | what |
|---|---|---|
h1-count | error | ≠ 1 <h1> |
about-error-img | error | image failed DA ingestion |
placeholder-copy | error | [Placeholder], REPLACE_WITH_*, lorem, TODO/TBD in copy (allowlist source-inherited ones) |
micro-paragraph-run | warn | ≥4 consecutive ≤3-word paragraphs — flattened component |
bare-ordinals | warn | <p>1</p> rows — numbered component flattened |
duplicate-text | warn | 12-word shingle repeats within 400 words — pasted twice |
flattened-collection | warn / error (≥6 repeats + >40% of page words unblocked) | a periodic tag cycle (e.g. h4+p+p ×24) or ≥5 same-level headings at a steady stride in DEFAULT content — a structured directory/card set rendered as plain prose instead of a block ("masthead + prose dump + CTA" pages). Fixture-tested: scripts/test/flattened.test.mjs |
single-block-hoard | warn / error (source-confirmed or ≥5 latent headings) | one PROSE-CONTAINER block (*-body/prose/text/content) holds ≥60% of a blocked page across ≤2 block types — the source's sections collapsed into one body (the flatten variant unblocked-page/flattened-collection miss). Skips prose-by-design template families (article/blog/wellness/legal…); with a source capture fires only when the source had ≥3 heading-led regions, without one only when the block's inner headings/lists reveal structure. Fixture-tested: scripts/test/single-block-hoard.test.mjs |
source-images-lost | error | capture has ≥4 images, delivered page renders <25% of them — pipeline strips imagery authored inside flat content |
unknown-block | error | authored block class serves no code under /blocks/ |
unknown-widget | error | a /widgets/<path>/<name>.html link (the one sanctioned .html link) whose code does not HEAD 200 |
verbatim-below-threshold | warn (triage) | <95% of captured source text found verbatim; evidence lists missing nodes |
verbatim-missing-nodes | info | coverage ok but some nodes absent |
scrape-dir-empty | info | fidelity skipped |
| id | sev | what |
|---|---|---|
missing-template-blocks | error | page lacks blocks its template prescribes (explicit config, else >70% sibling consensus); a widget link counts as a block named by its file stem |
unblocked-page | error | zero blocks (widget links included) while template siblings have them — fell back to plain prose |
no-template-map | info | no template assignments; check skipped |
| id | sev | what |
|---|---|---|
load-failed | error | navigation failed/timed out |
main-collapsed | error | <main> < 50px tall — blank page (gate on rect height, not computed display) |
section-collapsed | error | content-bearing section renders 0px |
broken-image | error | img.complete && naturalWidth === 0 |
zero-size-image | warn | loaded image (naturalWidth > 0) renders 0px wide while in layout — circular flex sizing collapse; the broken-image probe misses it |
upscaled-image | warn | rendered >2× a <200px source — blurry logo class of bug |
horizontal-overflow | error (mobile) / warn (desktop) | page scrolls sideways |
page-error | error | uncaught JS exception |
console-error | warn | console.error output (third-party noise → allowlist) |
request-failed | error | same-origin request failed or ≥400 |
decoration-stalled | warn | sections never reached data-section-status="loaded" (hanging tags stall EDS decoration) |
video-not-playing | error | an autoplay <video> scrolled to ≥ ¼ visible is paused, has no advancing currentTime, or never reached readyState ≥ 2 (the content.da.live 401 class — poster shows, nothing plays). Evidence: src, readyState, paused, Δt. Media the source freezes at capture is a captureState[].restoreAtDelivery promise, so a poster where live autoplays is a defect, not a residual. A probe that errors is video-probe-failed (info). Fixture-tested: scripts/test/video-not-playing.test.mjs |
dropdown-unreachable | error | desktop only — a hover-opened submenu closes while the pointer travels in 2px steps from the trigger link's centre to the first sub-link (its nearest point, i.e. straight down), or the sub-link is not the element under the pointer on arrival (pointer-events: none, occlusion). Submenus are discovered generically as header elements that become visible on mouse.move over a header nav li; items with none are skipped; probed once per distinct header (a probe that errors is dropdown-probe-failed, info). Fixture-tested: scripts/test/dropdown-unreachable.test.mjs |
stardust/dynamics/parity.json)Flows, not presence — each check replays a user-visible flow through skills/dynamics/scripts/dynamics-check.mjs (closed check set: fetch-json, dom-count, click-dialog, search-query, form-flow, video-plays, consent-gate, martech, no-page-errors; martech runs when stardust/martech-contract.json exists). Third-party request statuses are recorded per check so a probe-induced failure is distinguishable from a vendor restriction. Pass --parity <file> to point at another parity file; --auth-header / --token-env for protected origins (sent to the base origin only).
| id | sev | what |
|---|---|---|
parity-missing | info | no parity file — the migration never ran the stardust dynamics skill |
parity-failed | error | a replayed flow did not complete (empty form accepted, dialog did not open, query returned nothing, player never requested playback, video present but not playing) |
parity-env-limit | warn | a failed flow whose feature records an environment limit (geo-fenced hand-off target) |
parity-unchecked | info | a feature with a non-final status and no replayable check — an owner item |
The live header against stardust/chrome/header-contract.json (../../diff/SKILL.md § The header contract): comparer
ids and severities, owner-decided ones info; header-contract-missing info, header-explore-failed error.
| id | sev | what |
|---|---|---|
baseline-created | info | first run on this machine — screenshot saved as baseline (local, not tracked; a clone re-creates it) |
visual-diff | warn >0.5% / error >5% (triage) | pixels changed vs baseline; evidence: both PNG paths + per-band ratios. Iframes are masked; judge warn-level diffs before calling them regressions |
page-height-changed | warn | full-page height moved >2% |
screenshot-failed | warn | capture failed |
| id | sev | what |
|---|---|---|
missing-title | error · missing-description warn · missing-canonical warn · canonical-mismatch warn | head basics |
missing-og-title / -og-type / -og-image | warn · missing-og-image-alt info · og-image-broken error | social cards |
noindex-on-live | error | live pages excluded from indexing |
jsonld-invalid | error · jsonld-no-type warn | structured data must parse server-side |
jsonld-visible-as-text | error | "@context" in visible copy — JSON-LD row landed outside the metadata block |
duplicate-title / duplicate-description | warn | fleet-wide duplicates |
favicon-broken | error · favicon-default error · favicon-mismatch warn | the icon the home page links serves 200; is not the aem-boilerplate default (the site's icon never shipped — the recorded first-pass miss); matches stardust/current/assets/favicon.<ext> when present |
| id | sev | what |
|---|---|---|
broken-internal-link | error | internal href target ≥400 |
link-via-redirect | info | href resolves only via redirect |
off-inventory-link | info | live 200 but untracked |
broken-anchor | warn | #fragment has no matching id — server HTML first, then re-verified in the rendered DOM (blocks assign ids client-side; without the rendered pass this false-flags) |
anchor-unverified | info | id absent from server HTML and no browser available to check the rendered DOM |
empty-href | warn · malformed-mailto / malformed-tel warn | dead affordances |
broken-external-link | warn (never error — externals flap) | 404/410/DNS-fail, each unique URL probed once — opt-in via --probe-externals (on blog-scale fleets the unique-external set dominates sweep time) |
externals-skipped | info | externals not probed this run (the default); count reported so the skip is never silent |
| id | sev | what |
|---|---|---|
axe-<rule> | critical/serious → error, moderate → warn, minor → info | deduped fleet-wide by rule; evidence: affected pages + sample selectors. Contrast flags on alpha-tinted chips can false-positive — composite before trusting, triage don't auto-allowlist |
axe-unavailable | info | CDN blocked / injection failed |
| id | sev | what |
|---|---|---|
transfer-over-budget | warn | encoded bytes > budget (default 800KB) |
js-over-budget | warn | JS transfer > budget (default 250KB) |
lcp-poor | warn | lab LCP > 2.5s · cls-poor warn |
player-before-paint | warn | a player document, script or API request (any frame) started before first contentful paint (deploy #157) |
player-timing-unknown | warn | a player request had no browser start time and neither bound placed it — player-before-paint could not judge it |
network-degraded | info | neutral-host TTFB control tripped — all perf findings this run except player-before-paint downgraded to info (a slow network must not read as a site regression) |
measurement | info | per-page numbers, always recorded |
load-timeout | warn | no load event in 60s |
Reproduces what the da.live canvas does when an author opens a migrated page:
the document response is intercepted and instrumented like
editor-utils.getInstrumentedHTML (data-prose-index on every OUTERMOST
h1-h6/p/ul/ol/pre/blockquote inside <main>, bare-text block cells re-wrapped
as <p> first), the live page's own scripts.js decorates it, and each authored
text is then looked up by its index. Exactly one surviving element = editable;
zero = dead (the block rebuilt it from textContent/innerHTML, synthesized
or retagged it); several = duplicated (clone slides — the editor attaches to
the first in DOM order). Shared instrument:
skills/deploy/scripts/ew-editability-probe.mjs; contract: deploy SKILL.md
§ Experience Workspace editability contract (EW1–EW10).
| id | sev | what |
|---|---|---|
dead-text | error | a block has ≥1 non-exempt authored text that no longer carries its index after decoration — the author clicks it in the workspace and nothing happens. Message: block name, dead/authored count, first 3 texts; evidence lists up to 8. Fix in the block JS: MOVE the authored element into the wrapper (EW1) |
duplicated-index | warn | a text's index survives on several elements (presentational clones) — editable, but the editor may attach to a hidden copy; strip instrumentation from clones (EW4) |
summary | info | per page: authored / editable / dead / duplicated / exempt totals and the per-block breakdown — evidence for the migration ledger |
probe-failed | warn | navigation or instrumentation failed for the page (timeout, blocked response); nothing measured |
Severity rationale: dead text is an error because an author is harmed right
now (silently uneditable content, found by the customer in the canvas — no other
gate sees it); duplicates are warn because editing still works, on the wrong
copy at worst. Exemptions (EW5 — declared, never silent): --ew-exempt a,b
(blocks whose rows are config / derived / index fallback) and, with
--blocks-dir <dir>, @ew-exempt <reason> tags in each block's leading JSDoc
(@ew-exempt all = the whole block is index/API-driven). Exempt dead texts are
counted under exempt in the summary and never raise dead-text. Desktop
viewport only (instrumentation is viewport-independent); --max-pages applies;
needs playwright like browse.
Per page: served HTML (ChatGPT-User UA, no JS) vs the rendered DOM as textContent; landmarks
stripped by default. strict = the tool's popup number; code = fragments credited + app blocks
excluded (--ai-exclude-blocks, default client-app,widget); servedGap = rendered words absent
from the served HTML, per block. Formula, cause classes and fixes: deploy/reference/ai-readability.md.
| id | sev | what |
|---|---|---|
ai-readability-poor | error | strict < 75 — the owner's gauge reads Fair/Poor; the rendered DOM carries hundreds of words the document lacks (clones, index cards, fragments) |
ai-readability-low | warn | strict < 95 or code < 98 — block code adds words the document does not have |
ai-readability-served-gap | info | ≥ 40 rendered main words never served — non-rendering crawlers miss them (fragment / index / generated text); evidence names the blocks |
ai-readability-unmeasured | info | page could not be fetched or rendered for the check |
<check>/check-crashed (error) — a check module threw; the sweep continues
but the failure is visible, never silently dropped..tessl-plugin
skills
audit
reference
deploy
reference
scripts
test
diff
direct
dynamics
extract
migrate
prepare-migration
prototype
assets
motion
fixtures
reference
qa
replica
reference
scripts
test
reskin
rollout
spec
stardust
uplift
reference