website-design-system SKILL.md skillA

website-design-system from karero/croftweaver is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add karero/croftweaver/website-design-system@git:20261016.8c14a32

Pins git:20261016.8c14a32 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
karero/croftweaver
Path
skills/website-design-system/SKILL.md
Versions recorded
5
Latest version
git:20261016.8c14a32, committed Oct 16, 2026
First version recorded
Oct 12, 2026
Size
6,366 bytes
Repository stars
8
License
MIT

The visual build standards for a new site: mobile-first responsive graphics (WebP/AVIF, sized-to-display, srcset, lazy-load, descriptive alt, no layout shift), dark mode (CSS-variable theme tokens + a no-FOUC script + WCAG AA contrast in BOTH themes), and the brand/theme token block that BRAND.md mirrors. Use when building or reviewing layout, images, theming, or BRAND.md (step 6 of the new-website pipeline). Contrast is enforced by a11y.spec.ts (light+dark). Trigger phrases: "dark mode…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Website design system

Owns the **how it looks and performs visually** layer: mobile graphics, dark
mode, and the theme tokens. Outputs/maintains `BRAND.md` (template: the `new-website`
skill's `templates/brand.md`) and the token block in that skill's
`templates/astro/src/styles/global.css`. Image rules
are below (WebP/AVIF via Astro's `astro:assets`); the `images.spec.ts` test
enforces them. For generating image assets, use the `image` skill.

## Dark mode (first-class)

- **Tokens, not hard-coded colours.** All colour flows through CSS custom
  properties; light is the `:root` default, dark overrides under
  `:root[data-theme="dark"]`, plus a `@media (prefers-color-scheme: dark)` block
  for no-JS visitors. The starter ships this exact structure.
- **No-FOUC script** in `<head>` sets `data-theme` from `localStorage.theme` or
  the system preference *before first paint* (already wired in `Base.astro`).
  The toggle writes `localStorage.theme` (the starter ships none; if you add one,
  say so in the privacy page's section 3).
- **Contrast both themes:** every text/background pair passes WCAG AA (4.5:1
  body, 3:1 large/UI). A colour that passes in light often fails in dark — the
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add karero/croftweaver/website-design-system@sha256:fd8b09fba6fda337

The line at the top of this page pins the label git:20261016.8c14a32, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_nmmbmuq3kndt7cz2.svg)](https://markdownregistry.com/a/art_nmmbmuq3kndt7cz2)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Oct 12, 2026 and Oct 16, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261016.8c14a32 latest2026-10-16 8c14a32 6,366 BA view · diff
git:20261013.693442e2026-10-13 693442e 6,366 BA view · diff
git:20261012.a713a362026-10-12 a713a36 5,961 BA view · diff
git:20261012.92c463e2026-10-12 92c463e 6,383 BA view · diff
git:20261012.452e4382026-10-12 452e438 5,978 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6366 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

karero/croftweaver · 8 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_nmmbmuq3kndt7cz2
GET https://markdownregistry.com/api/v1/resolve?ref=karero/croftweaver/website-design-system
GET https://markdownregistry.com/api/v1/blob/fd8b09fba6fda337e5b2fb44b3cd1b527980e8d318e22caa07fe3bd01f92965a

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from karero/croftweaver

ai-seo SKILL.md skill
karero/croftweaver · skills/ai-seo/SKILL.md · When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers…
v1.2.0 · audit A · 8 stars
astro-i18n-setup SKILL.md skill
karero/croftweaver · skills/astro-i18n-setup/SKILL.md · Turn a new-website scaffold into a turnkey multi-language site: Astro i18n routing (clean default locale + prefixed…
git:20261008.0b58772 · audit A · 8 stars
business-listings-setup SKILL.md skill
karero/croftweaver · skills/business-listings-setup/SKILL.md · Post-launch: claim Google Business Profile, Bing Places, and category directories, then verify the `sameAs` profiles…
git:20260828.45295fb · audit A · 8 stars
copywriting SKILL.md skill
karero/croftweaver · skills/copywriting/SKILL.md · When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages…
v1.1.0 · audit A · 8 stars
customer-research SKILL.md skill
karero/croftweaver · skills/customer-research/SKILL.md · When the user wants to conduct, analyze, or synthesize customer research. Use when the user mentions "customer…
v1.0.0 · audit A · 8 stars
double-knuth SKILL.md skill
karero/croftweaver · skills/double-knuth/SKILL.md · Generic two-pass "Double-Knuth" review for ANY repo or file set: Pass 1 = correctness/bugs on the change (delegates to…
git:20260702.17487d7 · audit A · 8 stars
facts-check SKILL.md skill
karero/croftweaver · skills/facts-check/SKILL.md · Read-only consistency check of any live site, on any stack. FACTS: one approved facts list (value, source, owner)…
git:20261014.7cb141a · audit A · 8 stars
image SKILL.md skill
karero/croftweaver · skills/image/SKILL.md · When the user wants to create, generate, edit, or optimize images for marketing — blog heroes, social graphics, product…
v1.0.0 · audit A · 8 stars
independent-review SKILL.md skill
karero/croftweaver · skills/independent-review/SKILL.md · Domain-agnostic cross-model review gate: run a planning markdown (PLAN gate) or a branch/PR diff (DIFF gate) through…
git:20261020.9205219 · audit A · 8 stars
internal-link-audit SKILL.md skill
karero/croftweaver · skills/internal-link-audit/SKILL.md · Internal-linking tool for an Astro site built with the new-website kit. Builds the site's inbound-link graph from dist/…
git:20260829.3bef4bd · audit A · 8 stars
keystatic-setup SKILL.md skill
karero/croftweaver · skills/keystatic-setup/SKILL.md · Add Keystatic — a git-based CMS from the Keystone team — to a new-website Astro scaffold, so a non-technical person can…
git:20260716.5f5e7ec · audit A · 8 stars
new-website SKILL.md skill
karero/croftweaver · skills/new-website/SKILL.md · Orchestrates building a NEW website end-to-end, from insights to launch-ready and handoff-ready. Self-contained: it…
git:20261020.5c900a0 · audit A · 8 stars

Every file in karero/croftweaver

Browse by kind, by grade A, or by owner.