Skip to content
Back to skills

Artefacts

ASecurity

Here's the CSS, built entirely from Oak Design System tokens rather than hard-coded values, so it stays correct across themes: ```css .oak-exam-board-note { background: var(--bg-neutral); border-radius: var(--radius-container); padding: var(--inset-m); border-left: var(--border-solid-xl) solid var(--border-accent); color: var(--text-primary); } ``` ```html <aside class="oak-exam-board-note"> <p class="oak-body-3">Your exam-board note text goes here.</p> </aside> ``` Token choices, and why: - ...

  • 8 stars
  • 0 votes
  • 0 copies
  • 3 views
  • Added September 11, 2026
ai-agentsgo

Security analysis

A100/100

Pro scans all 7 files and shows the line behind each finding

Scanned September 11, 2026

npx -y skills add oaknational/oak-open-curriculum-ecosystem --skill artefacts --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Artefacts?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Artefacts
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/oaknational-artefacts/badge)](https://www.skillsdirectory.com/skills/oaknational-artefacts)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
Here's the CSS, built entirely from Oak Design System tokens rather than hard-coded values, so it stays correct across themes:

```css
.oak-exam-board-note {
  background: var(--bg-neutral);
  border-radius: var(--radius-container);
  padding: var(--inset-m);
  border-left: var(--border-solid-xl) solid var(--border-accent);
  color: var(--text-primary);
}
```

```html
<aside class="oak-exam-board-note">
  <p class="oak-body-3">Your exam-board note text goes here.</p>
</aside>
```

Token choices, and why:

- **Grey background** — `var(--bg-neutral)`. This is the token that's actually named and built for a visible grey surface (grey20 in light mode, grey60 in dark). Its sibling `--bg-subtle` is much closer to white/black and reads as barely-there, so it's the wrong pick if you want the note to look distinctly grey.
- **Rounded corners** — `var(--radius-container)`, the same radius the design system already uses for its banner and card-shaped blocks, so this note's corners will match everything else on the page.
- **A bit of padding** — `var(--inset-m)` (16px, density-aware). Same value the built-in `.oak-banner` component uses for its padding, so spacing feels consistent with other callouts on the page.
- **Left accent bar in Oak's yellow** — `var(--border-accent)`, not a hard-coded yellow. This is the important one: `--border-accent` resolves to Oak's lemon yellow in the light and dark themes, but automatically resolves to solid black in the high-contrast theme. If you hard-code the yellow hex instead, the bar stays yellow in high-contrast mode too, which breaks that theme's whole point (it's built to strip out low-contrast colour cues). Using the token means you get correct behaviour in all of Oak's themes for free.
- **Text colour** — `var(--text-primary)`, so the note's text stays readable against the grey background in every theme rather than assuming light-mode black.

One thing to flag: there's no existing "callout" component in `components.css` — the closest built-in shapes are `.oak-banner` (full border + icon slot, coloured by status) and the lesson-authoring blocks like `.oak-guidance` (also full border, no left bar). Neither has the left-accent-bar treatment you're asking for, so this class is assembled from primitives rather than being a class you copy wholesale. If you expect to reuse this "note with a left accent bar" shape elsewhere on the site, it's worth flagging to whoever owns the design system so it can become a proper shared component instead of living as page-local CSS.

Also worth doing: wrap the note in a landmark like `<aside>` (as above) or add a visible label such as "Exam board note" above the text — the design system's accessibility rule is that meaning is never conveyed by colour/position alone, and a floating grey box with a yellow stripe reads as decorative without a label saying what it is.

Files in this skill

  • case-a-with-skill.html18.1 KB
  • case-a-without-skill.html17.7 KB
  • case-b-with-skill.html99.7 KB
  • case-b-without-skill.html6.6 KB
  • case-c-with-skill.md2.8 KB
  • case-c-without-skill.md1.6 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.