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, andwebsite/architecture.md. - If the change touches examples or authoring structure, read the relevant website ADRs before finalizing the change.
- If files under
website/changed, runscripts/website-verify.sh --alland 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 thebrowser/*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,
_datamodule, 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 entrypointswebsite/src/_data/for structured page content and navigationwebsite/src/_includes/for shared layouts, components, and partialswebsite/src/examples/for interactive example fragmentswebsite/src/styles/,website/src/style.css, andwebsite/src/site-assets/for shared presentation and behavior
- For each changed page, verify:
- Alignment with
website/README.md,website/specification.md, andwebsite/architecture.md - Link/navigation sanity
- Accessibility basics
- Alignment with
- 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.
More from oocx/tfplan2md
arc42-documentation
Create comprehensive architecture documentation using the arc42 template structure (12 sections covering introduction, constraints, context, solution strategy, building blocks, runtime, deployment, concepts, decisions, quality, risks, and glossary).
83git-rebase-main
Safely rebase the current feature branch on top of the latest origin/main. Use when preparing a branch for PR, UAT, or release.
24analyze-chat-export
Export and analyze VS Code Copilot chat logs for retrospective metrics. Extracts model usage, tool invocations, approval patterns, and timing data.
18create-pr-azdo
Create an Azure DevOps pull request using az devops tooling; include the repo’s linear-history merge preference and ask the Maintainer if merge options differ.
17website-devtools
Use browser tools to inspect rendering and troubleshoot website issues with the Maintainer.
17agent-tool-selection
Guide for selecting appropriate VS Code Copilot tools when configuring agents, including environment-specific considerations.
17