origin-web-design

Generates accessible HTML pages, landing pages, and dashboards using brand design tokens and media rules.

Updated Dec 9, 2025
One-click install
npx skills add https://github.com/Aki2022/skills --skill origin-web-design-aki2022
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: origin-web-design
Source: https://github.com/Aki2022/skills/tree/main/origin-web-design
Command: npx skills add https://github.com/Aki2022/skills --skill origin-web-design-aki2022

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Building web deliverables (HTML pages, landing pages, components, dashboards) that consistently follow brand design systems and accessibility constraints is error-prone. This Skill acts as a web artifact factory: it composes brand design tokens from a brand repository with media-specific rules, enforces mandatory HTML authoring checks (lang, viewport, landmarks, SVG labels, focus-visible, contrast), and optionally validates output with static or browser-based audits. ## Core Features & Use Cases - Media-aware generation: Resolves the target medium (html or dashboard) and applies its constraint/recommendation rules from media.yaml files; slide and PPTX requests are handed off to a separate skill. - Brand token composition: Queries the origin-brand repository for resolved design tokens with license gating, then merges them with media rules using a documented priority algorithm (context-composer). - Mandatory HTML checklist: Every HTML output must include lang attribute, viewport meta, semantic landmarks, labeled SVGs, focus-visible styling, and 4.5:1 contrast. - Tiered validation: Offers static auditing via scripts/audit_html.py (structure and literal-color contrast, including linked CSS) and optional Playwright-based rendered measurement, only after user approval. - Use Case: Ask for a dashboard for municipal population and finance data; the Skill selects the dashboard media, applies brand tokens, generates the HTML, and asks whether to run static or rendered validation. ## Quick Start Ask the AI to build a brand-aligned responsive landing page in HTML and then choose whether to run the static audit or full browser validation.

Frequently Asked Questions about origin-web-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an accessible HTML landing page with brand design tokens?

Request the page and specify the brand context; the Skill queries the origin-brand repository for resolved design tokens, composes them with HTML media rules by priority, and generates output that satisfies the mandatory checklist including lang, viewport, landmarks, and 4.5:1 contrast.

How do I validate generated HTML for accessibility and contrast?

Run python3 scripts/audit_html.py on the generated file for a static check of lang, viewport, landmarks, alt text, focus-visible, and literal color contrast, including linked local CSS. For computed styles and theme switching, request the Playwright-based rendered validation after approving the cost.

Can this Skill create PowerPoint slides or pitch decks?

No. Slide, PPTX, and proposal document requests are explicitly out of scope and are handed off to the origin-pptx skill. This Skill only holds media rules for html and dashboard, and stops after routing non-web requests.

Does the HTML audit script require external Python packages?

No. The audit_html.py script uses only the Python standard library and runs on the system python3 without installing dependencies. It parses HTML and linked local stylesheets directly to evaluate structural constraints and contrast ratios.

What happens when brand tokens are not license-approved?

The license gate is owned by the origin-brand repository. When a plugin's license_gate_approved is false, the Skill uses only its principle-level prose and fills concrete asset values with runtime defaults, explicitly noting this in the output report.

Why does validation not run automatically after generating a site?

Rendered browser validation has real cost, so the Skill asks the user first and offers three options: lightweight static audit, full Playwright rendered measurement, or skip. Automatic validation only happens if the user explicitly requests it every time.