# Web Design Reasoning
Global Codex skill for content-first web design decisions.
This skill turns the lessons from **Web Design in 4 Minutes** into a reusable reasoning and routing layer for landing pages, portfolios, documentation, tutorials, static sites, redesigns, and design audits.
It is an independent, normalized knowledge pack. It is not affiliated with or an official package of the original project.
## What it does
- Starts with content and readability before visual polish.
- Routes each task through one primary playbook.
- Adds only the specialist domains required by the request or a verified risk.
- Preserves the user's framework, brand, dependencies, and scope.
- Separates facts, inferences, assumptions, evidence, and unknowns.
- Keeps detailed knowledge local so normal work does not depend on internet access.
## Routing model
```text
SKILL.md
-> references/core.md
-> one primary playbook
-> optional specialist routes required by the task
```
Available specialist routes include frontend design, accessibility, SEO, performance, frontend architecture, and copywriting. For each domain, the skill chooses either the installed specialist workflow or the local fallback snapshot, not both by default.
## Knowledge layout
- `SKILL.md` — entrypoint, routing, authority boundaries, and reporting contract.
- `references/core.md` — compact principles used for every relevant task.
- `references/playbooks/` — task-specific workflows with inputs, sequence, verification, fallback, and output contracts.
- `references/deep/web-design-lessons.md` — the 11 lessons and derived mindset.
- `references/deep/web-design-system-and-runtime.md` — source structure, runtime, responsive behavior, design system, and product/distribution inferences.
- `references/deep/web-design-application.md` — practical implementation and review process.
- `references/deep/web-design-evidence.md` — source evidence and pinned comparison data.
- `references/deep/frontend-design/` — sliced frontend-design fallback references.
- `references/deep/copywriting/` — sliced copywriting fallback references and dedicated distribution templates.
The source study is split by use case so an agent can load only the relevant slice. The original A-Z content remains available through the evidence router.
## Install as a global Codex skill
Copy this directory to:
```text
~/.codex/skills/web-design-reasoning/
```
`agents/openai.yaml` enables implicit invocation. No hook is required. If the skill list is cached, start a new task or refresh the Codex app after installation.
## Source and attribution
Primary source studied:
- Repository: [jgthms/web-design-in-4-minutes](https://github.com/jgthms/web-design-in-4-minutes)
- Live tutorial: [jgthms.com/web-design-in-4-minutes](https://jgthms.com/web-design-in-4-minutes/)
- Pinned comparison commit: [`633a949bd6ba3d6b97a295303dc0ac61e61d197b`](https://github.com/jgthms/web-design-in-4-minutes/tree/633a949bd6ba3d6b97a295303dc0ac61e61d197b)
The local study records which claims are source facts, runtime observations, or agent inferences. Source links are provenance; they do not replace the local knowledge needed for normal operation.
## Scope boundary
The Web Design in 4 Minutes research is embedded as the core subject of this skill. Specialist references are normalized fallbacks with provenance hashes. When a task needs the full current workflow, scripts, or tooling of a specialist, use that installed specialist skill and verify the target project directly.