Agent skill

Website Design System

by macalbert in macalbert/envilder

Envilder website design system: themes, CSS variables, breakpoints, spacing, typography, and component patterns.

MITAuto-check passedFrontend & Design

Install Website Design System

skills CLI
$ npx skills add macalbert/envilder --skill website-design-system -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install macalbert/envilder website-design-system --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/macalbert/envilder.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/website-design-system .claude/skills/website-design-system && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
website-design-system
GitHub stars
138
Token cost
~839 tokens
SKILL.md length
335 words
Files
1
Skills in repo
30
Repo updated
First seen
Licence
MIT

At a glance

Envilder website design system: themes, CSS variables, breakpoints, spacing, typography, and component patterns.

  • Editing Astro components
  • SKILL.md covers When to Use, Themes, Responsive Breakpoints and Spacing & Layout, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Styling website pages

What it does

Website Design System is an agent skill from macalbert/envilder. Envilder website design system: themes, CSS variables, breakpoints, spacing, typography, and component patterns. Use when creating or editing Astro components, adding CSS, or styling website pages. Ensures visual consistency across retro and light themes.

Its SKILL.md is about 840 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering Design systems, Responsive design and Design tokens. It works with Astro. The repository describes itself as: One secret mapping for local dev, CI/CD, and runtime. Envilder resolves cloud secrets from your own vaults without SaaS middlemen, duplicated config, or .env drift. The licence is MIT.

When your agent uses it

  • Editing Astro components
  • Styling website pages

Example prompts

  • “/website-design-system”

What it can do on your machine

Read from SKILL.md and the folder at commit b6a0327. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are css).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Website Design System loads about 839 tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 335 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~69
When it runs · the whole SKILL.md, loaded when a task matches
~839

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from macalbert/envilder at commit b6a0327, republished under its MIT licence (© macalbert). 335 words, ~839 tokens.

Download SKILL.mdSave it as .claude/skills/website-design-system/SKILL.md (or your agent's skills folder).
name
website-design-system
description
Envilder website design system: themes, CSS variables, breakpoints, spacing, typography, and component patterns. Use when creating or editing Astro components, adding CSS, or styling website pages. Ensures visual consistency across retro and light themes.

Website Design System

Rules and patterns for the Envilder website's pure CSS design system.

When to Use

  • Creating new Astro components or page sections
  • Adding or modifying CSS (global or scoped)
  • Choosing between existing utility classes
  • Defining new CSS variables
  • Reviewing PRs that touch website styling

Themes

The site uses data-theme attribute on <html>. Two themes are supported:

ThemeSelectorPalette
Retro (default):rootGame Boy green
Light[data-theme="light"]Warm neutrals
Rules
  • All colors MUST use CSS variables: never hardcode hex values
  • New variables MUST be defined in both :root (retro) and [data-theme="light"] blocks in global.css
  • Never modify the theme switcher mechanism or its localStorage key
css
/* ✓ Correct */
color: var(--color-text);
background: var(--color-bg);

/* ✗ NEVER */
color: #8bac0f;
background: #1a1a2e;

Responsive Breakpoints

Mobile-first approach. Default styles target mobile; expand with min-width.

BreakpointTargetPattern
DefaultMobileSingle column, compact spacing
min-width: 640pxTablet2-column grids, expanded spacing
min-width: 1024pxDesktop3-4 column grids, full layout
Grid Utilities

Use existing grid classes: .grid-2, .grid-3, .grid-4.

Spacing & Layout

Use the spacing scale defined in global.css:

  • Variables: --space-xs through --space-4xl
  • Container max-width: --max-width (1200px)

Typography

UseFontAccess
Section titles / pixel stylePress Start 2PVia .pixel-card h3 or custom class
Body textInterDefault (inherited)
Code / terminalJetBrains Mono<code>, <pre>, or mono class
  • Use clamp() for fluid typography
  • Never use fixed px font sizes

Component Patterns

Reuse existing CSS classes for visual consistency:

ClassPurpose
.pixel-cardBordered cards with pixel corner notches
.pixel-iconEmoji with pixelated filter
.pixel-shadow4px offset retro shadow
.badgeSmall label badges
.pixel-dividerSection separator
.scanlinesCRT overlay effect (use sparingly)
.sectionStandard section wrapper with vertical padding

File Locations

WhatWhere
Global CSSsrc/website/src/styles/global.css
Componentssrc/website/src/components/*.astro
Layoutsrc/website/src/layouts/BaseLayout.astro

Constraints

  • DO NOT install CSS frameworks or UI libraries: use existing pure CSS
  • DO NOT hardcode colors: always CSS variables from global.css
  • DO NOT use fixed pixel font sizes: use clamp() or relative units
  • DO NOT break existing responsive layouts when adding new sections
  • DO NOT add JavaScript frameworks (React, Vue): Astro components + <script> tags only
  • ONLY add new CSS variables if defined in both theme blocks

© macalbert, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .github/skills/website-design-system of macalbert/envilder.

Open the folder on GitHubat commit b6a0327

Compare with similar skills

Website Design System next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Website Design System compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Website Design System this skillmacalbert/envilder138—~839Automated safety check: PassMIT
Using Ouds Web Version Major MinorOrange-OpenSource/Orange-Boosted-Bootstrap222—~4.1kAutomated safety check: PassMIT
Extract Design Systemespennilsen/pi122—~2kAutomated safety check: PassMIT
Design SystemOhh-889/skyroc79511 repos~1.7kAutomated safety check: PassMIT
Scalar Design Systemscalar/scalar16k—~2.7kAutomated safety check: PassMIT
Stitch Taste Design Systemgoogle-labs-code/stitch-skills8.4k15 repos~3.1kAutomated safety check: PassApache-2.0

Similar skills

  • Using Ouds Web Version Major Minor

    Orange-OpenSource/Orange-Boosted-Bootstrap

    Provides comprehensive knowledge of the OUDS Web library (Orange Unified Design System for Web), a Bootstrap-based CSS/JS framework for building Orange-branded web interfaces.

    222 GitHub stars~4.1k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Extract Design System

    espennilsen/pi

    Reverse-engineer a design system from a live website (public URL or localhost).

    122 GitHub stars~2k tokensUpdated 15 days ago
    Frontend & DesignAuto-check passed
  • Design System

    Ohh-889/skyroc

    Token architecture, component specifications, and slide generation.

    795 GitHub starsUsed in 11 repos~1.7k tokens
    Frontend & DesignAuto-check passed
  • Scalar's design system — design tokens, theming (@scalar/themes), CSS variables, and the @scalar/components library.

    16k GitHub stars~2.7k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Stitch Taste Design System

    google-labs-code/stitch-skills

    Official

    Generates a DESIGN.md design-language file for Google Stitch that encodes color, typography, layout, component behavior and motion rules to avoid generic AI-looking UI.

    8.4k GitHub starsUsed in 15 repos~3.1k tokens
    Frontend & DesignAuto-check passed
  • UI Upstream Sync

    fulldotdev/ui

    Audit and update the existing Fulldev Astro UI registry against current data-slot and shadcn/ui Base UI Vega.

    610 GitHub stars~1.3k tokensUpdated today
    Frontend & DesignAuto-check passed

More from macalbert/envilder

All 30 skills in this repo
  • Code Review Perspectives

    macalbert/envilder

    Five independent analysis perspectives for code review: correctness, architecture, security, conventions, and complexity.

    138 GitHub stars~1k tokensUpdated 2 days ago
    Auto-check passed
  • Index of Architecture Decision Records (ADRs) for cross-cutting technical decisions.

    138 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed
  • Common Git

    macalbert/envilder

    Git commit messages, PR workflow, and branching strategy using Conventional Commits and Semantic Versioning.

    138 GitHub stars~991 tokensUpdated 2 days ago
    Auto-check passed
  • Common Testing Conventions

    macalbert/envilder

    Mandatory testing conventions including the narrow diagnostic exception for testing test-only code, AAA pattern, test naming, and assertions across all stacks (.NET, TypeScript, Python).

    138 GitHub stars~1.9k tokensUpdated 2 days ago
    Auto-check passed
  • Doc Maintenance

    macalbert/envilder

    Workflow for maintaining changelogs, READMEs, and documentation files.

    138 GitHub stars~904 tokensUpdated 2 days ago
    Auto-check passed
  • Doc Sync

    macalbert/envilder

    Audit and synchronize documentation across website, READMEs, and docs/.

    138 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Website Design System

What does Website Design System do?

Envilder website design system: themes, CSS variables, breakpoints, spacing, typography, and component patterns. Website Design System is an agent skill from macalbert/envilder. Envilder website design system: themes, CSS variables, breakpoints, spacing, typography, and component patterns.

When should I use Website Design System?

Website Design System fits situations like: editing Astro components; styling website pages.

How do I install Website Design System in Claude Code?

Run `npx skills add macalbert/envilder --skill website-design-system -a claude-code`. Or copy the skill folder (.github/skills/website-design-system in macalbert/envilder) into .claude/skills/website-design-system in your project. Claude Code loads it when a task matches its description.

How do I install Website Design System in Codex?

Run `npx skills add macalbert/envilder --skill website-design-system -a codex`. Or copy the skill folder (.github/skills/website-design-system in macalbert/envilder) into .agents/skills/website-design-system in your project. Codex loads it when a task matches its description.

Can I use Website Design System in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add macalbert/envilder --skill website-design-system -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/website-design-system, .gemini/skills/website-design-system, .github/skills/website-design-system and .opencode/skills/website-design-system in your project.

What does Website Design System need to run?

SKILL.md names no scripts, command-line tools or credentials: Website Design System is instructions for the agent only.

Does Website Design System access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Website Design System safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Website Design System use?

Website Design System is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Website Design System use?

About 839 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Website Design System?

Skills that share tags, products or a category with Website Design System: Using Ouds Web Version Major Minor (Orange-OpenSource/Orange-Boosted-Bootstrap, 222 stars), Extract Design System (espennilsen/pi, 122 stars), Design System (Ohh-889/skyroc, 795 stars) and Scalar Design System (scalar/scalar, 16k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Website Design System?

macalbert (a GitHub user) maintains it in macalbert/envilder, which has 138 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on October 5, 2026.

Source: macalbert/envilder on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.