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
The text of this part of skills/deploy/SKILL.md, which keeps the heading and points here. "Above" and "below" refer to the order of the sections in that file.
<main> has a corresponding section in the content page — a block for pattern sections, default content for prose sections, a lone /widgets/<path>/<name>.html link for code-driven UI with no authored content (D1, Step 2 triage recorded in the conversion log).davids-model-lint clean — node skills/deploy/scripts/davids-model-lint.mjs content/ exits 0 (0 🔴; 🟡 advisories reviewed and either fixed or justified in the conversion log).<body>, no <!DOCTYPE>/<html>/<head> — EDS injects the project head.html at delivery. (Only the mount deploy tolerates a full doc.)node skills/deploy/scripts/sanitise.js on the content before any DA write (non-ASCII → entities).style-fingerprint.mjs on the prototype BEFORE block code; every group with >1 style/structural cluster (active chip, accent CTA, image vs image-less card) is reproduced by its block, not flattened.var(--x) referenced in blocks/**/*.css is defined in styles.css :root (the comm -23 grep prints nothing); no undefined-var-dropped background/color.content-diff summary reviewed (advisory) for the first page of each template — per-role/img count deltas checked; per-node 🔴 confirmed on the deployed page (§ Reading content-diff).stardust/eds-schema/<page>.json exists; authored rows follow its order/units; each block's JSDoc cites its section's schema; deliberate drops recorded in the conversion log.block-roundtrip BEFORE deploy (#94) — exit 0 (0 structural 🔴) per block against its prototype section, plus one whole-page run (no --blocks) clean before the DA push.block-roundtrip --ew (default) / ew-editability-probe.mjs: dead = 0 outside declared @ew-exempt tags, duplicated = 0; every exemption is one of the three declared categories (metadata / derived / index-driven) and is written in the block JSDoc, never implied.ew-editability-probe.mjs --simulate-editor: no font/colour/line-height drift on any text, block height Δ ≤ 2 px; the foundation ships the edit-mode CTA repaint, the card-as-link inner-anchor rule and :where() wrapper variants for every styled-text-link utility (Step 3).textContent =/innerHTML =/${…} interpolation producing displayed text from an authored element; no cloneNode of an indexed element without stripInstrumentation(); no >/:first-child/:nth-child between a wrapper class and an authored element; no class added to an authored h*/p/ul/a (wrappers carry classes); no <button>/<summary> hosting authored text (EW7).ai-readability.mjs code score ≥ 98 on the published page; no block generates visible text; carousel clones carry no text; index-backed listings ship authored rows (reference/ai-readability.md).pixelmatch = 0 per block instance.<header></header> and <footer></footer> are EMPTY (the header/footer blocks load /nav and /footer automatically); content/nav.html + content/footer.html exist, follow the section contract (brand / links / tools), and are on the publish roster.metadata block (#34): real Title (≤60 chars, from the <h1>, never a block name) + Description (~155 chars). nav / footer path overrides / Robots rows go in the same block when needed.<h1> per page (#35): the hero/lead headline is <h1>; section titles are <h2>/<h3>; no headline left as a bare <div> (interactive blocks included — the lead title is <h1> in server-visible markup)./media, authored as content.da.live <img> with alt (NOT repo-relative /img/, NOT baked into block JS by index). Hero/feature/CTA-band backgrounds count as editorial. Decorative image-less treatments (gradients/scrims/washes) and fixed brand assets stay CSS background. Verify: the delivered .plain.html carries the expected <img>+alt count (CSS-background images are absent from it). <image-slot> placeholders → empty cells with a CSS background fallback.<strong>/<code> tag, not an invented ::/| delimiter; accents <em> not <span class="em">; no <sup>/layout-<br> in content; no <hr> ever (#119 — it is the section delimiter and fractures the section)..<name>-container .default-content-wrapper, or (only when it must live inside the block's layout) reabsorbed via block.parentElement.previousElementSibling matching .default-content-wrapper — decorated DOM byte-identical when reabsorbing (verify: 0 wrappers left, decorated outerHTML unchanged).cards/text/…); only genuinely-unique sections are bespoke (see "The one rule").h2 → h3, never h2 → h4).cap-probe.mjs <live> --against <deployed> --design DESIGN.json prints PASS.crop-compare.mjs) against live on the deployed URL, at least once per template.img reset is display: block; max-width: 100%; height: auto; (#36) — EDS adds width/height attrs; without height: auto images stretch vertically.npm run lint runs lint:breakpoints and passes (#162) — no desktop-first @media in styles/ or blocks/.--nav-height matches the real chrome height per breakpoint (#81); deployed-preview CLS < 0.1.fetchpriority="high", media slot CSS-reserved (#100); CLS probe on the DEPLOYED preview only (#101).aspect-ratio box, from an allow-listed https: URL (#157); qa player-before-paint empty.qa-gate.mjs run against the harness (advisory smoke test) — stock script + the page's eds-schema, no hand-rolled probe (#101). Its unique pre-deploy value is the schema unit-counts + one-<h1>; decoration/broken-img/grid checks are superseded by the DEPLOYED computed-style guard (chrome-empty / auth-gated DA image failures are harness limitations — see its --help). The advisory content-diff was run against the DEPLOYED URL only.<span>/class INSIDE a block cell is re-created in decorate() (#39) — EDS strips <span> in block cells (e.g. wrap a .stars run in JS, don't author it).cell.textContent for the decision, #79) but DISPLAYS them by MOVING the cell's element (EW1) — wrapTextNodes (#104) and the workspace both deliver a <p>, so the element to move exists in both worlds; a p-only read still drops content on older runtimes. Verify against the decorated live/preview render, and assert each text field is present AND editable (counts alone don't catch it).<style> or <script> tags in the content page, and no code visible as text in any cell (D15).@variants words (ENCODE contract). Code side: grep -rnE "\.style\.[a-zA-Z]+\s*=|setProperty\(|style\.cssText|setAttribute\('style'" blocks/ lists only lines that do NOT take their value from authored text (image src/href-derived values are fine; cell.textContent is not).style values from the Step-3 closed set (never on block sections — anti-pattern 2).closing block.localize-links.mjs --source-host <live-host> --check exits 0 over the content tree: no source-host <a href> whose path exists locally, no .html/trailing-slash internal hrefs (the one sanctioned .html href is a /widgets/ link — no content page sits at that path, so the pass leaves it alone); the listed KEPT absolutes are genuinely external or not-yet-migrated. Re-run the plain pass after every wave.<strong> (primary), <em> (secondary), <em><strong> (accent, sparingly — D6). Text links and tile-card anchors are plain <a>.default async function decorate(block) with JSDoc describing rows and noting any button conventions..block-name.prefers-reduced-motion: reduce honored on any animation.opacity:0 reveal lifted from the prototype — content renders visible (prototype scroll-reveal script doesn't run in EDS).section, block, wrap, button, widget, or a name ending -wrapper/-container).head.html is untouched except the single favicon <link rel="icon"> line (Step 3 § Favicon; anti-pattern 10 lists what never goes there). Brand woff2(s) live in fonts/.favicon.<ext> or _eds/code/favicon.<ext> in sandboxed runs) when extract captured one; when none was captured, the deploy log records a loud WARN (likely a bounded extract — recover the icon rather than shipping the default silently)..otf/.ttf from the prototype were converted to woff2 with fontTools. If any proprietary face is shipped, the licensing alert exists in all three places (styles.css banner + fonts/LICENSING.md + conversion log) and the hand-off message flags "license required before aem.live"."<Brand>", "Arial Narrow", arial, … (or a self-hosted free condensed analog). Width-class is part of classification.-fallback face second ("<Brand>", "<brand>-fallback", sans-serif) — first paint renders the fallback until loadFonts() lands fonts.css.<brand>-fallback @font-face declares size-adjust / ascent-override / descent-override (calibration per anti-pattern 11) — zero CLS on font swap.font-family: var(--body-font-family) declarations. Brand font flows from body via inheritance. Only display/mono/serif families are explicitly set per-block via their :root tokens.body { display: none } / body.appear gate and the header { height: var(--nav-height) } reservation from the stock styles.css are INTACT (never removed by the foundation rebrand)..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