course-style
The shared visual and writing reference for AI Engineering from Scratch pages, figures, and manuals. Use it for light and dark colour tokens, font stacks, FIG_ label formats, and card layout. Use it for the plain technical English rules and the accessibility and reduced motion defaults. Trigger phrases: "course style", "blueprint palette", "course tokens", "FIG label", "plain technical English", "check my prose", "course fonts", "dark mode tokens"
- License 许可
- MIT
- 最近更新
- 2026-10-22
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- course-style
- tags
- [ "design-system", "tokens", "typography", "writing", "accessibility" ]
- version
- 1.0.0
- description
- The shared visual and writing reference for AI Engineering from Scratch pages, figures, and manuals. Use it for light and dark colour tokens, font stacks, FIG_ label formats, and card layout. Use it for the plain technical English rules and the accessibility and reduced motion defaults. Trigger phrases: "course style", "blueprint palette", "course tokens", "FIG label", "plain technical English", "check my prose", "course fonts", "dark mode tokens"
02 资源文件 5
- 参考文档references/accessibility.md4.2 KB
- 参考文档references/labels-and-layout.md5.8 KB
- 参考文档references/plain-english.md8.5 KB
- 参考文档references/tokens.md6.6 KB
- 参考文档references/typography.md3.5 KB
03 SKILL.md 正文
Course style
This skill is the reference layer for the AI Engineering from Scratch look and voice. Other craft skills point here for exact values: blueprint-figure, motion-figure, isometric-explainer, and write-manual. Use it with Claude, Cursor, Codex, OpenClaw, Hermes, or any agent that reads SKILL.md. It holds no drawing method of its own. It tells you which colour, font, label, spacing, and word to use, and how to check each one.
When to use
- You write or review a page, a card, a figure, or a manual for the course.
- You need a token value for light or dark mode.
- You need the label format for a figure, a sub-figure, or a widget.
- You need to check prose against the plain technical English rules.
- You add motion and need the timing, the easing, and the reduced motion behaviour.
When not to use
- You draw a static SVG figure. Use blueprint-figure, which cites this skill.
- You build an animated or slider figure. Use motion-figure.
- You build an isometric machine explainer. Use isometric-explainer.
- You write a full manual. Use write-manual for the structure and the audit.
- The page belongs to a different product with its own brand.
Method
- Set the theme. Put the light tokens on
:rootand the dark tokens on[data-theme="dark"]. Copy them fromreferences/tokens.md. - Pick the token set. Pages use the site tokens. Manual figures use the
--m-tokens. - Load the three fonts with the exact link in
references/typography.md. Use the stacks as given. - Give each figure a label in the format from
references/labels-and-layout.md. - Build cards and figure frames with the measurements in
references/labels-and-layout.md. - Add motion only with the motion tokens. Add the reduced motion block from
references/accessibility.md. - Write the prose. Then check every line against
references/plain-english.md. - Run the checklist below. Fix each failure before you finish.
Rules
Colour
- Use one accent per page:
--blueprint(#3553fflight,#6b8effdark). Status tokens and manual figure hues are the only other colours. - Write every colour as a CSS variable. A hex value is allowed only as the default inside
var(). - Define every token in both themes. A token without a dark value is a defect.
- Put body text in
--inkor--ink-softonly. - Do not use
--ink-muteor--warnfor body text. Their contrast on the paper is below 4.5:1. - Keep the four fixed figure hues: rose for failure, grey for outside, amber for lifecycle, teal for durable state.
- Use no gradients except the paper dot grid and the dashed rule. Use no rounded corners on cards or frames.
Type
- Headings use the display font, weight 400, uppercase, letter spacing 0.02em, colour
--blueprint. - Body text uses the serif at 18px with line height 1.62.
- Labels, meta lines, and code use the mono font, uppercase for labels, letter spacing 0.06em to 0.16em.
- Figure text is at least 11 units at a 640-unit width.
Labels
- A course figure number is
FIG_plus three digits, such asFIG_005. Numbers are never reused. - A sub-figure adds a dot and a capital letter:
FIG_005.A. - Separate label parts with a middle dot and one space on each side:
FIG_001 · FORWARD PASS. - A manual figure is
Fig. <part>.<n>, such asFig. 4.1. Its id isfig-4-1.
Prose
- Sentences have at most 25 words. Instructions have at most 20 words and use the imperative.
- A paragraph has one topic and at most six sentences.
- Use no em dashes, no en dashes, no semicolons, and no contractions.
- Never write "may". Write "can", or state the condition.
- Use none of the banned words in
references/plain-english.md. - Code spans, fenced code, quotes, and citations are exempt.
Motion and access
- Use only the four durations: 160, 180, 220, and 250 ms.
- Page reveals start 8px away at opacity 0 and use
--ease-out. Modals start 14px lower at scale 0.985. - Pressed buttons scale to 0.97.
- Under
prefers-reduced-motion: reduce, remove transitions and animations and show the final state. - Every focusable control shows a 2px solid
--blueprintoutline at a 2px offset. - Touch targets in menus and figure controls are at least 44px tall.
Check before you finish
- [ ] Every colour is a
var(--token), and each token has a light and a dark value. - [ ] The page uses one accent colour.
- [ ] No body text uses
--ink-muteor--warn. - [ ] Fonts load from the one Google Fonts link, and the stacks match
references/typography.md. - [ ] Every figure has a label in a format from
references/labels-and-layout.md. - [ ] No label uses an em dash as a separator.
- [ ] Every transition uses a motion token, and a reduced motion block exists.
- [ ] Every control has a visible focus outline. Menu rows and figure controls are 44px tall or more.
- [ ] The prose check in
references/plain-english.mdreports zero hits. - [ ] You switched the theme to dark and read the page again.
Files
references/tokens.md: site and figure tokens for light and dark, hue meanings, motion tokens, measured contrast.references/typography.md: font stacks, the font link, type scale, and label styles.references/labels-and-layout.md: FIG_ formats, file names, card layout, and figure frames.references/plain-english.md: the full prose rule list, the banned words, and a checker.references/accessibility.md: focus, targets, figure markup, theme start-up, and reduced motion.
Inside the AI Engineering from Scratch repo, the source values live in site/style.css, manuals/_shared/tokens.css, and scripts/audit_manuals.js.
04 同仓库更多 Skills
write-manual
Writes a long technical manual that explains one subject at one pinned version, from its purpose to each request and response. Every listing comes from an offline capture, every claim traces to a ranked source, and an audit must report TOTAL 0. Use it for "write a manual", "write a 101 manual for <subject>", "manual.json", "add a manual section", "build a capture kit", "audit the manual", or "pin a spec version and document it".
start-learning
One-time onboarding for the AI Engineering from Scratch curriculum (523 lessons, 20 phases). Interviews the learner, runs the placement quiz, and writes LEARNING.md, a persistent study plan the learn skill drives. Trigger phrases: "start learning", "set up the course", "begin the curriculum", "onboard me", "create my learning plan"
motion-figure
Builds figures that move or respond to the reader, in three tiers: SMIL animations and slider widgets inside lessons, interactive mechanism figures that show the named parts of a real system with a computed verdict, and ordered dither bands in the course palette. Triggers: "animated figure", "add a slider widget", "interactive figure", "show how this system works", "make this diagram move", "dither masthead", "mechanism figure", "figure fence".
mcpa-certification
AI-native tutor and onboarding workflow for the MCPA (Model Context Protocol Associate) certification in AI Engineering from Scratch. Use when a learner wants to prepare for the MCPA, resume their certification path, learn the next lesson interactively, run and verify practical labs, take the diagnostic or a full mock, or remediate weak exam domains from GitHub with Claude Code, Codex, ChatGPT, Cursor, or another agent.
learn
Interactive lesson tutor for the AI Engineering from Scratch curriculum. Reads LEARNING.md, fetches the next lesson, teaches it section by section in the terminal, quizzes at the end, and records progress. Works cloned or entirely over raw.githubusercontent.com — no setup required. Trigger phrases: "next lesson", "teach me", "continue the course", "let's learn", "resume learning"
learn-reverse-engineering
Focused interactive tutor for the Reverse Engineering path in AI Engineering from Scratch. Start or resume this route when a learner wants to read a compiled program: file formats, disassembly, control flow, lifting, evidence, proof, calling conventions, compiler idioms, linking, types, debugging, bytecode, diffing, symbolic execution, and AI-assisted analysis. Teaches one lesson per invocation and records evidence in REVERSE-ENGINEERING-LEARNING.md.