Skip to main content
skill CX Codex

generic-static-design-system — Claude Code skill: how to install

generic-static-design-system — a design system skill for static sites built purely with HTML, CSS, and vanilla JS. Guides the agent to build lightweight interfaces without Tailwind or build tools.

MIT 168 installs ★ 114 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add travisjneuman/.claude --skill generic-static-design-system -a claude-code
Open on GitHub

What generic-static-design-system does

This skill establishes pure CSS patterns for static web pages without build steps, preprocessors, or utility frameworks. It provides custom properties for minimalist palettes and spacing, fluid sizing via clamp(), and system font declarations that eliminate web font downloads.

Interactive patterns are kept strictly CSS-driven where possible: collapsible containers via max-height, icon transformations, and accessible :focus-visible outlines. The skill sets strict file budgets: HTML under 5KB, CSS under 10KB, and total weight under 50KB to maintain Lighthouse scores above 90.

Projects dependent on Tailwind or bundlers will clash directly with these rules, because the skill explicitly forbids build tools.

What it helps with

  • set up fluid typography without media queries
  • create CSS custom properties for spacing and theme colors
  • build accessible buttons and navigation without JavaScript
  • keep total static page size under 50KB

Example prompts for the agent

  • Build a static landing page following generic-static-design-system without web fonts
  • Create an accessible button and navbar using pure CSS tokens from the design system
  • Implement a CSS-only toggle and check that total styles stay under 10KB

How to install generic-static-design-system

1Skills CLI (Vercel)

npx skills add travisjneuman/.claude --skill generic-static-design-system -a claude-code

2Manually: put the files in place

~/.claude/skills/generic-static-design-system/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/generic-static-design-system/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about generic-static-design-system

How to install generic-static-design-system in Claude Code?

Run npx skills add travisjneuman/.claude --skill generic-static-design-system -a claude-code.

What does generic-static-design-system do?

It instructs your coding agent to build lightweight static sites using pure CSS, system font stacks, fluid scaling, and strict performance limits.

Does this skill work with CSS preprocessors or Tailwind?

No. The skill explicitly rules out preprocessors, Tailwind, and build tools in favor of vanilla CSS.

Source text

SKILL.md · MIT
---
name: generic-static-design-system
description: Complete design system reference for static HTML/CSS/JS sites. Covers colors, typography, component patterns, animations, and accessibility. Use when implementing UI, choosing colors, or ensuring brand consistency.
---

# Static Site Design System

Design system patterns for minimalist static sites (pure HTML/CSS/JS).

**Extends:** [Generic Design System](../generic-design-system/SKILL.md) - Read base skill for color theory, typography scale, spacing system, and component states.

## Pure CSS Approach

No preprocessors, no Tailwind, no build tools. Just CSS.

### CSS Custom Properties

```css
:root {
  /* Brand colors - keep palette minimal */
  --bg-primary: #000000;
  --text-primary: #ffffff;
  --accent: #00ff00;

  /* Spacing */
  --space-sm: 0.5rem;
  --space-md: 1rem;
  --space-lg: 2rem;

  /* Timing */
  --transition-fast: 0.15s;
  --transition-base: 0.3s;
}
```

### System Font Stack (No Web Fonts)

```css
/* System fonts = zero load time */
body {
  font-family:
    -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
}

code {
  font-family: "SF Mono", Monaco, "Courier New", monospace;
}
```

### Responsive Typography with clamp()

```css
/* Fluid sizing, no media queries needed */
h1 {
  font-size: clamp(1.5rem, 5vw, 2.5rem);
}

body {
  font-size: clamp(1rem, 3vw, 1.125rem);
}
```

## CSS-Only Animations

### Keyframe Animations

```css
@keyframes pulse {
  0%,
  100% {
    opacity: 1;
  }
  50% {
    opacity: 0.5;
  }
}

.pulse {
  animation: pulse 2s ease-in-out infinite;
}
```

### Transition Patterns

```css
/* Hover effect - GPU accelerated */
.link {
  transition:
    transform var(--transition-base) ease,
    color var(--transition-base) ease;
}

.link:hover {
  transform: translateY(-2px);
  color: var(--accent);
}
```

### Staggered Animation with nth-child

```css
.menu a {
  opacity: 0;
  transform: translateY(-10px);
  transition: all 0.3s ease;
}

.menu.visible a {
  opacity: 1;
  transform: translateY(0);
}
.menu.visible a:nth-child(1) {
  transition-delay: 0.1s;
}
.menu.visible a:nth-child(2) {
  transition-delay: 0.2s;
}
.menu.visible a:nth-child(3) {
  transition-delay: 0.3s;
}
```

## CSS-Only Interactive Patterns

### Hidden/Visible Toggle

```css
.hidden {
  max-height: 0;
  overflow: hidden;
  transition: max-height 0.3s ease;
}

.visible {
  max-height: 300px; /* Must be > content height */
}
```

### Icon Rotation

```css
.arrow {
  transition: transform 0.3s ease;
}

.rotated .arrow {
  transform: rotate(180deg);
}
```

### Focus States

```css
a:focus-visible,
button:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: 2px;
}
```

## Component Patterns (No JS)

### Accessible Button

```html
<button class="btn" type="button">Click Me</button>
```

```css
.btn {
  padding: var(--space-sm) var(--space-md);
  background: transparent;
  border: 1px solid var(--text-primary);
  color: var(--text-primary);
  cursor: pointer;
  transition: all var(--transition-base) ease;
}

.btn:hover {
  background: var(--accent);
  border-color: var(--accent);
  color: var(--bg-primary);
}
```

### Navigation

```html
<nav>
  <a href="#section1">Section 1</a>
  <a href="#section2">Section 2</a>
</nav>
```

```css
nav a {
  padding: var(--space-sm);
  text-decoration: none;
  color: var(--text-primary);
}

nav a:hover {
  color: var(--accent);
}
```

## Performance Targets

| File  | Max Size |
| ----- | -------- |
| HTML  | < 5KB    |
| CSS   | < 10KB   |
| JS    | < 5KB    |
| Total | < 50KB   |

| Lighthouse     | Target |
| -------------- | ------ |
| Performance    | 95+    |
| Accessibility  | 90+    |
| Best Practices | 100    |

## See Also

- [Generic Design System](../generic-design-system/SKILL.md) - Token organization, spacing
- [Design Patterns](../_shared/DESIGN_PATTERNS.md) - Core patterns
- [UX Principles](../_shared/UX_PRINCIPLES.md) - Visual hierarchy

© travisjneuman · MIT · travisjneuman/.claude

Similar skills

All skills for Frontend and UI →

From the same set117

The whole set →
websockets-realtime websockets-realtime is a Claude Code skill that guides real-time data setup for chats, live feeds, and collaborative editing. CX Codex +1 172installs risk-management Enterprise risk management guidelines for assessing operational, tech, and vendor risks. Helps build heat maps and business continuity frameworks. CX Codex +1 171installs innovation An innovation-management playbook the agent can consult: horizons, portfolio mix, ideation, Stage-Gate, venture capital and IP. Handy when product bets need sorting. CX Codex +1 170installs api-design api-design is a Claude Code skill with guidelines and templates for REST, gRPC, and tRPC APIs; it helps generate OpenAPI schemas and keep route naming consistent. CX Codex +1 170installs ai-ml-development ai-ml-development — a skill for Claude Code and Codex handling machine learning tasks. Activates when building training pipelines, fine-tuning LLMs, or assembling RAG applications. CX Codex +1 167installs flutter-development flutter-development — a skill for Claude Code provides project structure, Dart 3 patterns, and architecture guides across mobile, desktop, and web. Activates during Flutter app creation and Material Design implementation. CX Codex +1 166installs options-comparator options-comparator — a skill for Claude Code brings structured option comparison using weighted scoring matrices, trade-off analysis, and recommendation templates. Runs during vendor evaluations and strategy reviews. CX Codex +1 162installs accessibility-a11y accessibility-a11y — a skill for Claude Code and Codex guides WCAG 2.2 compliance and interface accessibility checks. Activates during UI component development, accessibility reviews, or CI/CD test integration. CX Codex +1 161installs

Project sponsors

Companies that keep this analytics open