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
#!/usr/bin/env node
/**
* spec-links.mjs — S4 link check: every same-origin link found by spec-parse that is not a fetched page —
* pages are fetched like S2 (redirect chain, template, HTML kept for parsing), assets (/content/dam, files)
* get HEAD then GET. Records status, final URL and target status; a bot wall or refusal is recorded as `blocked`,
* not as a broken link. Resumable.
*
* node spec-links.mjs [--config <file>] [--links <links.jsonl>] [--workers 6] [--max 20000]
*
* Writes <work>/links/assets.jsonl and <work>/links/pages.txt (then run spec-fetch with
* --urls <work>/links/pages.txt --out <work>/links/pages.jsonl to fetch the discovered pages).
*/
import { existsSync } from 'node:fs';
import { appendJSONL, arg, blockedBy, helpAndExit, loadConfig, log, pool, readJSONL, writeText } from './lib.mjs';
helpAndExit(import.meta.url);
const UA = 'Mozilla/5.0 (Macintosh) stardust-spec/1.0';
const ASSET = /\/content\/dam\/|\.(pdf|docx?|xlsx?|pptx?|zip|jpe?g|png|gif|webp|svg|mp4|mov)(\?|$)/i;
/** Split discovered same-origin links into pages and assets, skipping known pages. Pure. */
export function splitLinks(linkRows, origin, known) {
const pages = new Set(); const assets = new Set();
for (const r of linkRows) {
for (const u of Object.keys(r.links || {})) {
let x; try { x = new URL(u); } catch { continue; }
if (x.origin !== origin || known.has(u)) continue;
(ASSET.test(x.pathname) ? assets : pages).add(u);
}
}
return { pages: [...pages].sort(), assets: [...assets].sort() };
}
async function check(url) {
const chain = []; let cur = url;
for (let hop = 0; hop < 8; hop += 1) {
let res;
try {
res = await fetch(cur, { method: 'HEAD', redirect: 'manual', headers: { 'user-agent': UA } });
if ([403, 405, 501].includes(res.status)) res = await fetch(cur, { method: 'GET', redirect: 'manual', headers: { 'user-agent': UA, range: 'bytes=0-1023' } });
} catch (e) { return { url, error: String(e.message || e).slice(0, 200), chain }; }
if ([301, 302, 303, 307, 308].includes(res.status) && res.headers.get('location')) { const next = new URL(res.headers.get('location'), cur).href; chain.push({ url: cur, status: res.status, location: next }); cur = next; continue; }
// a bot wall or refusal is not a broken link: recorded as blocked, left out of the 404s
const why = blockedBy(res.status, Object.fromEntries(res.headers), '', cur);
if (why) return { url, blocked: why, status: res.status, chain };
return { url, status: chain.length ? chain[0].status : res.status, final_url: cur, final_status: res.status, chain, content_type: res.headers.get('content-type') || '', bytes: Number(res.headers.get('content-length')) || null };
}
return { url, error: 'redirect loop', chain };
}
async function main() {
const cfg = loadConfig();
const fetched = readJSONL(cfg.w('fetch', 'fetch.jsonl'));
const known = new Set(fetched.flatMap((r) => [r.url, r.final_url]).filter(Boolean));
const { pages, assets } = splitLinks(readJSONL(arg('links', cfg.w('parse', 'links.jsonl'))), cfg.origin, known);
writeText(cfg.w('links', 'pages.txt'), pages.join('\n'));
const out = cfg.w('links', 'assets.jsonl');
const done = new Set(existsSync(out) ? readJSONL(out).map((r) => r.url) : []);
const todo = assets.filter((u) => !done.has(u)).slice(0, Number(arg('max', 20000)));
log(`${pages.length} discovered pages (→ links/pages.txt), ${assets.length} assets, ${todo.length} to check`);
await pool(todo, Number(arg('workers', 6)), async (u) => appendJSONL(out, await check(u)), (d, n) => { if (d % 500 === 0 || d === n) log(`${d}/${n}`); });
if (existsSync(out)) {
const rows = readJSONL(out); const blocked = rows.filter((r) => r.blocked).length;
log(`${rows.length} assets checked${blocked ? `; ${blocked} turned away (blocked, not counted as broken)` : ''}`);
}
}
if (import.meta.url === `file://${process.argv[1]}`) main().catch((e) => { console.error(e.message); process.exit(1); });.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