AGENTS.md ยท diff
git:20260914.5b2728d to git:20260914.a027241
17 added, 2 removed. Audit A to A.
# ultimate-frontend-skills
This repo is a plugin for Claude Code and Codex. It teaches a coding agent one
art direction for websites and ships the code that produces it.
## If you are building a website
Read `skills/ultimate-frontend-skills/SKILL.md` and follow it. That is the whole entry point.
It is written for agents that do not load skills automatically, so it stands on
its own.
The two rules that matter most, restated here in case you read no further:
1. **Nothing about the design goes in your reply.** No palette, no type scale, no
rationale. Build the files, then say what you made in one or two sentences
with the paths.
2. **No emoji anywhere** - not in the page, the copy, the commit, or the reply.
Icons are inline SVG.
## If you are working ON this repo
Layout:
```
.claude-plugin/plugin.json Claude Code manifest
.claude-plugin/marketplace.json Claude Code catalogue (Codex reads this too)
.codex-plugin/plugin.json Codex manifest
skills/ultimate-frontend-skills/SKILL.md the doctrine
skills/ultimate-frontend-skills/assets/ core.css, motion.js, sections.html
- skills/ultimate-frontend-skills/references/ loaded on demand
- scripts/webdesign.mjs new / sections / add / audit / look / serve / parity / verify
+ skills/ultimate-frontend-skills/references/ loaded on demand; pipeline.md is the entry
+ skills/ultimate-frontend-skills/data/awards.json merged corpus; data/awards/*.json are its chunks
+ scripts/webdesign.mjs new / sections / add / audit / look / study / awards /
+ blender / assets / tools / serve / parity / verify
+ scripts/awards.mjs the reference corpus: query, pick three that disagree, rebuild
+ scripts/blender.mjs Blender headless: probe / run / glb / bake / frames
+ scripts/blender/*.py the bpy templates it drives
+ scripts/assets.mjs CC0 PBR textures, HDRI lighting, image generation with detection
+ scripts/tools.mjs what else is installed on this bench, and what changes because of it
scripts/inspect.mjs headless-browser render check, over CDP
scripts/parity.mjs built page vs its Claude Design artboards, same probes both sides
scripts/design.mjs which Claude Design route exists here - reports, never enrols
scripts/cut.py photograph -> parallax planes via rembg
scripts/install.mjs registers with both CLIs
commands/webdesign.md the /ultimate-frontend-skills:webdesign slash command
commands/debug-website.md /ultimate-frontend-skills:debug-website
commands/design-handoff.md /ultimate-frontend-skills:design-handoff
+ commands/awards.md /ultimate-frontend-skills:awards
commands/atelier.md the compatibility alias for the old name
hooks/ UserPromptSubmit nudge
```
Constraints:
- **Zero dependencies.** Node 18+, built-ins only. Do not add a package.json
dependency block.
- `core.css` and `motion.js` are copied verbatim into user projects. A change
there lands in every site built afterwards, so treat them as public API.
- `inspect.mjs` talks to Chrome/Edge/Chromium over the DevTools protocol using
Node 22's built-in `WebSocket` and `fetch`. Do not add puppeteer.
- Every change to `assets/` or `scripts/` must keep
`node scripts/webdesign.mjs audit` passing on a fresh scaffold:
```
node scripts/webdesign.mjs new /tmp/t --name "T" && node scripts/webdesign.mjs audit /tmp/t
```
A fresh scaffold is *expected* to fail on scaffold copy (and to warn about
the placeholder images it cannot find) - that is the audit doing its job.
Everything else must be clean.
+ - The corpus is data. `data/awards.json` is generated by `awards --build` from
+ `data/awards/*.json`; edit a chunk and rebuild rather than hand-editing the
+ merged file. A fabricated URL in there would poison every `study` run that
+ followed, so entries carry a `verified` flag and the merge drops rows without
+ a usable URL.
+ - `blender.mjs` and `assets.mjs` reach outside the machine. Neither may invent a
+ key, and `tools.mjs` reports the presence of a credential, never its value.
- Keep `SKILL.md` short. Depth belongs in `references/`, which is only read when
needed. Frontmatter is loaded into every session; the body is not.