soyl-academy-designlisted
Install: claude install-skill SOYL-AI/soyl-skills-hub
# SOYL Academy design language
Build so an ordinary visitor understands the page at a glance. Every element must earn its place, either as
part of the story or as a reason to act. When creativity gets in the way of reading, cut it.
Read `tokens.css` and `components.css` in this folder before writing any styles. Use their custom properties
and classes rather than new values. `README.md` has the full system with tables.
## 1. Plan before you style
- Write the page as headlines first. Reading only the headlines must tell the whole story.
- Give each section one job and name the principle behind it: clarity first, loss framing, show the mechanism,
experience beats claims, trust through candour, or a small first commitment.
- Give each screen one idea: a headline, one sentence and one action.
- Show the product. The main visual of a section is a real product moment (a student's tries, a hint, the
Evidence Card a teacher reads), drawn in HTML and CSS. Don't use stock art, blobs, gradients or decorative
icons.
- Never invent proof. Don't write made-up testimonials, school names, numbers or logos. Leave the slot empty
and say so.
## 2. Build with the system
- **Grounds:** `--bg` for the page, `--panel` for alternate bands, `--card` for cards. Use at most one
`.section--dark` (`--night`) per page, where the problem is stated.
- **Colour:** text in `--ink` and secondary text in `--muted`. `--blue` is only for things you can act on:
buttons, links, eyebrows. Use `--sun