CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

adobe/stardust

Redesign an existing website to make it better. Built on top of impeccable.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Overview
Quality
Evals
Security
Files

checks.mdskills/qa/reference/

stardust:qa — check catalogue

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.

routing (A, delivery)

idsevwhat
page-not-200errorinventory path doesn't serve 200
plain-not-200error.plain.html variant missing — content doc not delivered
fragment-not-200errorchrome fragment (nav/footer) missing
redirect-not-firingerrora /redirects.json rule doesn't redirect
redirect-dest-brokenerrorredirect lands on a non-200
no-redirects-sheetinfono /redirects.json — verification skipped
redirect-missing / redirect-dest-differserror / warna stardust/redirects.tsv row is absent from /redirects.json / points elsewhere
trailing-slash-brokenwarna folder index fails at /path (no redirect to /path/)
404-not-404errorunknown paths don't 404 (soft-404s poison crawlers)
404-page-emptywarn404 body is near-empty (unstyled error page)
sitemap-missingerrorno sitemap.xml
sitemap-lists-fragmenterrorsitemap exposes nav/footer as pages
sitemap-only-pagewarnpublished page nobody tracks
missing-from-sitemapwarntracked page invisible to crawlers

content (B, delivery — .plain.html)

idsevwhat
h1-counterror≠ 1 <h1>
about-error-imgerrorimage failed DA ingestion
placeholder-copyerror[Placeholder], REPLACE_WITH_*, lorem, TODO/TBD in copy (allowlist source-inherited ones)
micro-paragraph-runwarn≥4 consecutive ≤3-word paragraphs — flattened component
bare-ordinalswarn<p>1</p> rows — numbered component flattened
duplicate-textwarn12-word shingle repeats within 400 words — pasted twice
flattened-collectionwarn / 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-hoardwarn / 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-losterrorcapture has ≥4 images, delivered page renders <25% of them — pipeline strips imagery authored inside flat content
unknown-blockerrorauthored block class serves no code under /blocks/
unknown-widgeterrora /widgets/<path>/<name>.html link (the one sanctioned .html link) whose code does not HEAD 200
verbatim-below-thresholdwarn (triage)<95% of captured source text found verbatim; evidence lists missing nodes
verbatim-missing-nodesinfocoverage ok but some nodes absent
scrape-dir-emptyinfofidelity skipped

templates (C, delivery)

idsevwhat
missing-template-blockserrorpage lacks blocks its template prescribes (explicit config, else >70% sibling consensus); a widget link counts as a block named by its file stem
unblocked-pageerrorzero blocks (widget links included) while template siblings have them — fell back to plain prose
no-template-mapinfono template assignments; check skipped

rendered (D, browser; desktop 1440 + mobile 390)

idsevwhat
load-failederrornavigation failed/timed out
main-collapsederror<main> < 50px tall — blank page (gate on rect height, not computed display)
section-collapsederrorcontent-bearing section renders 0px
broken-imageerrorimg.complete && naturalWidth === 0
zero-size-imagewarnloaded image (naturalWidth > 0) renders 0px wide while in layout — circular flex sizing collapse; the broken-image probe misses it
upscaled-imagewarnrendered >2× a <200px source — blurry logo class of bug
horizontal-overflowerror (mobile) / warn (desktop)page scrolls sideways
page-errorerroruncaught JS exception
console-errorwarnconsole.error output (third-party noise → allowlist)
request-failederrorsame-origin request failed or ≥400
decoration-stalledwarnsections never reached data-section-status="loaded" (hanging tags stall EDS decoration)
video-not-playingerroran 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-unreachableerrordesktop 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

dynamics (H, browser; replay of 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).

idsevwhat
parity-missinginfono parity file — the migration never ran the stardust dynamics skill
parity-failederrora 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-limitwarna failed flow whose feature records an environment limit (geo-fenced hand-off target)
parity-uncheckedinfoa feature with a non-final status and no replayable check — an owner item

chrome (L, browser; the header contract)

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.

visual (E, browser)

idsevwhat
baseline-createdinfofirst run on this machine — screenshot saved as baseline (local, not tracked; a clone re-creates it)
visual-diffwarn >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-changedwarnfull-page height moved >2%
screenshot-failedwarncapture failed

metadata (F, delivery — raw fetch = crawler view)

idsevwhat
missing-titleerror · missing-description warn · missing-canonical warn · canonical-mismatch warnhead basics
missing-og-title / -og-type / -og-imagewarn · missing-og-image-alt info · og-image-broken errorsocial cards
noindex-on-liveerrorlive pages excluded from indexing
jsonld-invaliderror · jsonld-no-type warnstructured data must parse server-side
jsonld-visible-as-texterror"@context" in visible copy — JSON-LD row landed outside the metadata block
duplicate-title / duplicate-descriptionwarnfleet-wide duplicates
favicon-brokenerror · favicon-default error · favicon-mismatch warnthe 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

links (G, delivery)

idsevwhat
broken-internal-linkerrorinternal href target ≥400
link-via-redirectinfohref resolves only via redirect
off-inventory-linkinfolive 200 but untracked
broken-anchorwarn#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-unverifiedinfoid absent from server HTML and no browser available to check the rendered DOM
empty-hrefwarn · malformed-mailto / malformed-tel warndead affordances
broken-external-linkwarn (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-skippedinfoexternals not probed this run (the default); count reported so the skip is never silent

a11y (H, browser, desktop, axe-core via CDN)

idsevwhat
axe-<rule>critical/serious → error, moderate → warn, minor → infodeduped 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-unavailableinfoCDN blocked / injection failed

perf (I, browser + CDP; representatives = one page per template + home)

idsevwhat
transfer-over-budgetwarnencoded bytes > budget (default 800KB)
js-over-budgetwarnJS transfer > budget (default 250KB)
lcp-poorwarnlab LCP > 2.5s · cls-poor warn
player-before-paintwarna player document, script or API request (any frame) started before first contentful paint (deploy #157)
player-timing-unknownwarna player request had no browser start time and neither bound placed it — player-before-paint could not judge it
network-degradedinfoneutral-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)
measurementinfoper-page numbers, always recorded
load-timeoutwarnno load event in 60s

editability (J, browser, desktop 1440 — Experience Workspace inline-edit gate)

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).

idsevwhat
dead-texterrora 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-indexwarna text's index survives on several elements (presentational clones) — editable, but the editor may attach to a hidden copy; strip instrumentation from clones (EW4)
summaryinfoper page: authored / editable / dead / duplicated / exempt totals and the per-block breakdown — evidence for the migration ledger
probe-failedwarnnavigation 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.

ai-readability (K, browser + raw fetch — Adobe AI Content Visibility Checker, exact formula)

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.

idsevwhat
ai-readability-poorerrorstrict < 75 — the owner's gauge reads Fair/Poor; the rendered DOM carries hundreds of words the document lacks (clones, index cards, fragments)
ai-readability-lowwarnstrict < 95 or code < 98 — block code adds words the document does not have
ai-readability-served-gapinfo≥ 40 rendered main words never served — non-rendering crawlers miss them (fragment / index / generated text); evidence names the blocks
ai-readability-unmeasuredinfopage could not be fetched or rendered for the check

Cross-cutting

  • <check>/check-crashed (error) — a check module threw; the sweep continues but the failure is visible, never silently dropped.
  • Allowlisted findings keep their severity but don't count toward the exit code or summary totals; they render greyed-out in report.html.

skills

README.md

tile.json