bryllim GitHub avatar

bryl-minimal-design

bryllim

A design language packaged as an AI coding agent skill, encoding a monochrome, Geist-font-based minimal aesthetic with halftone dots, numbered sections, and light/dark theming.

Stars

91

7-day growth

No data

Forks

15

Open issues

0

License

MIT

Last updated

2026-07-11

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It turns a hand-tuned personal portfolio design into a reusable, framework-agnostic spec that any SKILL.md-supporting AI agent can apply to new or existing projects, with built-in evaluation prompts to ensure fidelity.

Who it is for

  • AI coding agent users (e.g., Claude Code) wanting consistent minimal design
  • Developers building side projects who need a polished look quickly
  • Designers interested in sharing their aesthetic as a portable skill
  • Teams standardizing on a minimal design language across multiple projects

Use cases

  • Generate a landing page with the bryl-minimal design language
  • Restyle an existing dashboard or prototype to match the monochrome minimal aesthetic
  • Quickly apply a consistent minimal theme to a new React, Vue, or plain HTML project
  • Test and validate AI-generated designs against a known visual spec

Strengths

  • Framework-agnostic: works with plain HTML, Tailwind, React, Vue, etc.
  • Based on a real, refined portfolio design (proven aesthetic)
  • Includes evaluation prompts to catch agent drift from the intended style
  • MIT licensed for free use, remixing, and shipping

Considerations

  • Relies on AI agent’s ability to accurately interpret the plain-text spec (results may vary)
  • Requires fonts (Geist, Source Serif 4) to be available in the project; not auto-included
  • Only covers one specific minimal monochrome aesthetic — not a general design system

README quick start

bryl-minimal-design

hi, I'm Bryl. I spent way too long fine-tuning the design of my portfolio — the monochrome palette, the tiny uppercase mono labels, the halftone dots, the little fade-up on page load — so I turned the whole thing into an agent skill that anyone can use.

Install it, and your AI coding agent (Claude Code or anything that reads SKILL.md) learns my design language and applies it to whatever you're building. True black on white, no accent color, Geist everywhere, numbered section headers like 01 — about, soft shadows, proper light/dark theming. The stuff I'd nitpick in a PR, basically.

It's written as a spec in plain words — values and intent, zero framework code — so it works the same whether your project is plain HTML, Tailwind, React, Vue, or something weirder. Your agent implements it in whatever your project already uses.

install

Claude Code:

# for all your projects
git clone https://github.com/bryllim/bryl-minimal-design ~/.claude/skills/bryl-minimal-design

# or just one project
git clone https://github.com/bryllim/bryl-minimal-design .claude/skills/bryl-minimal-design

other agents: anything that supports the SKILL.md format can use this repo as-is — just point it at SKILL.md.

use

Ask for something minimal and it should kick in on its own, or name it directly:

build a landing page for my side project, use the bryl-minimal design language

restyle this dashboard with bryl-minimal

If the result doesn't look like my site, something went wrong — open an issue, I'd genuinely like to know.

what's inside

  • SKILL.md — the whole design language: philosophy, the color ramp (light + dark values), the four font roles, layout, component recipes, the halftone motif, motion timing, and a step-by-step order for restyling existing projects.
  • evals/ — the test prompts I used to check that agents actually reproduce the aesthetic instead of drifting off into beige-and-serif land (they do drift, badly, without the skill).

fonts

The system leans on Geist & Geist Mono and Geist Pixel by Vercel, plus Source Serif 4 for long-form text. All free, all openly licensed.

license

MIT — take it, remix it, s

Related repositories

Similar projects matched by category, topics, and programming language.

MoonshotAI
Featured
MoonshotAI GitHub avatar

Kimi-K3

Kimi K3 is an open-weight, 2.8T-parameter native multimodal agentic model with a 1M-token context window, designed for frontier coding, knowledge work, and reasoning tasks.

AI & Machine LearningAI Agents
3,348
xuchonglang
Featured
xuchonglang GitHub avatar

investing-for-beginners

A structured investing guide for Chinese beginners covering US stocks, options, and cryptocurrency, with focus on foundational concepts and risk awareness.

Blockchain & Web3
2,739
Krishnagangwal
Featured
Krishnagangwal GitHub avatar

CS-Fundamentals

A curated collection of Computer Science fundamentals (PDFs, notes, cheatsheets, interview question banks) for placement preparation, covering seven core subjects plus general resources.

Data & DatabasesDatabases & Storage
2,326