A graphite-toned, calm, Apple-simple design system, packaged as an agent skill. By Olger Chotza — ochotzas.com
One cool graphite hue. Light islands on a soft grey table, dark ink for everything that matters, Figtree set big and tight, and one spring for all motion. Ink carries emphasis; soft colors at graphite's lightness only carry meaning (status, links, focus, categories).
Coding agents load SKILL.md automatically for any UI work, follow its rules and tokens, and run its checklist before they call the work done. It covers web, Tailwind, React, React Native/Expo, SwiftUI, emails and slides.
Inside Claude Code:
/plugin install graphite --marketplace ochotzas/graphite
On versions before 2.1.275, run /plugin marketplace add ochotzas/graphite first, then /plugin install graphite@ochotzas. Updates arrive through /plugin.
git clone https://github.com/ochotzas/graphite ~/.claude/skills/graphiteThe skill is picked up on the next session. To update: git -C ~/.claude/skills/graphite pull.
To make it mandatory in a project, add this to the project's CLAUDE.md:
For all UI work, use the graphite skill and run its checklist before finishing.
SKILL.md follows the open Agent Skills format. Clone the repo into your agent's skills folder as graphite, or, if your agent has no skill support, add this to the project's AGENTS.md (or rules file):
For all UI work, read <path-to-graphite>/SKILL.md and follow it, including its checklist.
Install from GitHub, pinned to a release:
npm install github:ochotzas/graphite#v2.1.0Then @import "@ochotzas/graphite/tokens.css"; in CSS, or import { theme } from "@ochotzas/graphite/tokens"; in TS. Or copy tokens/tokens.css / tokens/tokens.ts into your project. stacks.md shows the setup for each stack.
Live at ochotzas.com/skills/graphite, with the components and motion demos.
| Path | Contents |
|---|---|
SKILL.md |
Entry point: the 7 rules and which file to read when |
tokens/ |
Colors, type, spacing, radius, motion as CSS and TypeScript |
foundations.md |
Color, type, spacing, radius, layout, icons |
components.md |
Islands, rows, buttons, checks, inputs, navigation, sheets, states |
motion.md |
The spring, gesture physics and 13 signature effects |
stacks.md |
Setup for Tailwind, React, React Native/Expo, SwiftUI |
voice.md |
How UI text is written |
anti-patterns.md |
What agents typically get wrong |
unslop.md |
Audit and fix passes for AI-looking UI, adapted from unslop |
checklist.md |
The review run before UI work is finished |
examples/ |
Reference implementations to copy from |
fonts/ |
Figtree TTFs for native apps |
.claude-plugin/ |
Claude Code plugin and marketplace manifests |
package.json |
Lets projects install it from GitHub with npm |
Changes to a value go in both tokens/tokens.css and tokens/tokens.ts. Mistakes agents keep making go in anti-patterns.md. Keep SKILL.md short.
The version is in three places — the SKILL.md header (metadata.version), .claude-plugin/plugin.json and package.json — bump all three together and tag the commit vX.Y.Z. History is in CHANGELOG.md. Patch for wording fixes, minor for new rules or components, major when existing screens would need to change.
Apache 2.0, © 2026 Olger Chotza (ochotzas.com). See LICENSE and NOTICE.
The Figtree fonts in fonts/ are © The Figtree Project Authors, under the SIL Open Font License (fonts/OFL.txt).
unslop.md is adapted from unslop by Damir Sokolovsky (@heydamir), under CC BY 4.0.