website-quality-check

Provide a lightweight, repeatable quality checklist for website changes in the Eleventy site under website/ .

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "website-quality-check" with this command: npx skills add oocx/tfplan2md/oocx-tfplan2md-website-quality-check

Skill Instructions

Purpose

Provide a lightweight, repeatable quality checklist for website changes in the Eleventy site under website/ .

Hard Rules

Must

  • Verify the change follows website/README.md , website/specification.md , and website/architecture.md .

  • If the change touches examples or authoring structure, read the relevant website ADRs before finalizing the change.

  • If files under website/ changed, run scripts/website-verify.sh --all and fix failures.

  • If local preview is available, open the changed pages via the VS Code preview server (http://127.0.0.1:3000/website/dist/ ) and use the browser/* tools to ensure the rendered page and browser console are sane.

  • Do quick link/navigation sanity checks on changed pages.

  • Do basic accessibility spot checks (headings, landmarks, labels, keyboard navigation where relevant).

  • Validate the authored source, not only the rendered output: when a shared layout, component, partial, _data module, or example directory changes, verify at least one representative page that consumes it.

Must Not

  • Do not hand off or claim completion without completing the checklist for the changed pages and any affected shared building blocks.

Golden Example

Checklist (per changed page):

  • Shared docs: README/specification/architecture still match the implementation
  • Content model: page entrypoints, _data modules, includes, and examples are updated in the correct source files
  • Links: no broken relative links introduced
  • Browser preview: verify layout, interaction, and console are clean

Actions

  • Identify which authored sources changed under website/ :

  • website/src/pages/ for page entrypoints

  • website/src/_data/ for structured page content and navigation

  • website/src/_includes/ for shared layouts, components, and partials

  • website/src/examples/ for interactive example fragments

  • website/src/styles/ , website/src/style.css , and website/src/site-assets/ for shared presentation and behavior

  • For each changed page, verify:

  • Alignment with website/README.md , website/specification.md , and website/architecture.md

  • Link/navigation sanity

  • Accessibility basics

  • If a shared authored source changed, verify representative consuming pages in website/dist/ .

  • If issues are found, fix them or record them with a clear plan.

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open in GitHubOpen in ClawHub

Related Skills

Related by shared tags or category signals.

General

arc42-documentation

No summary provided by upstream source.

Repository SourceNeeds Review
-51
oocx
General

git-rebase-main

No summary provided by upstream source.

Repository SourceNeeds Review
-20
oocx
General

watch-uat-azdo-pr

No summary provided by upstream source.

Repository SourceNeeds Review
-14
oocx