Skip to content

MustafaKucukcoskun/Refine-agent-kit / .agents/skills/frontend-design

frontend-design

Verified

FileKindSize
SKILL.mdskill md13.0 KB
animation-guide.mdmarkdown7.9 KB
color-system.mdmarkdown7.3 KB
decision-trees.mdmarkdown16.9 KB
motion-graphics.mdmarkdown7.8 KB
scripts/accessibility_checker.pyscript5.8 KB
scripts/ux_audit.pyscript38.5 KB
typography-system.mdmarkdown8.3 KB
ux-psychology.mdmarkdown4.1 KB
visual-effects.mdmarkdown8.2 KB

color-system.md

View on GitHub
# Color System Reference

> Color theory principles, selection process, and decision-making guidelines.
> **No memorized hex codes - learn to THINK about color.**

---

## 1. Color Theory Fundamentals

### Color Relationships

| Scheme                  | How to Create                      | When to Use            |
| ----------------------- | ---------------------------------- | ---------------------- |
| **Monochromatic**       | ONE hue, vary lightness/saturation | Minimal, professional  |
| **Analogous**           | 2-3 ADJACENT hues                  | Harmonious, calm       |
| **Complementary**       | OPPOSITE hues                      | High contrast, vibrant |
| **Split-Complementary** | Base + 2 adjacent to complement    | Dynamic but balanced   |
| **Triadic**             | 3 EQUIDISTANT hues                 | Vibrant, playful       |

**Choose by:** Mood (calm→analogous, bold→complementary) · Count (minimal→mono) · Audience (conservative→mono, young→triadic)

---

## 2. The 60-30-10 Rule

- **60% PRIMARY** — Background, large areas (neutral/calming)
- **30% SECONDARY** — Cards, sections, headers (supports)
- **10% ACCENT** — CTAs, highlights (attention-grabbing)

```css
:root {
  --color-bg: /* 60% neutral */;
  --color-surface: /* slightly different from bg */;
  --color-secondary: /* 30% muted */;
  --color-accent: /* 10% vibrant */;
}
```

---

## 3. Color Selection by Context

| Project Type            | Hues                   | Why                |
| ----------------------- | ---------------------- | ------------------ |
| Finance/Tech/Healthcare | Blues, Teals           | Trust, stability   |
| Eco/Wellness            | Greens, Earth          | Growth, organic    |
| Food/Energy/Youth       | Orange, Yellow         | Warmth, excitement |
| Luxury/Beauty           | Deep Teal, Gold, Black | Premium            |
| Urgency/Sales           | Red, Orange            | Action, attention  |

> ⚠️ **Purple — AI default, use with caution.** Do not choose without explicit user request: as AI's #1 default color, it signals "AI-generated output." However, if intentionally chosen as a brand color (Twitch, Figma, GitHub etc.) it's fine.

**Selection:** Industry → Hue family → Light/dark mode → ASK USER → Confirm

---

## 4. Palette Generation Principles

### From a Single Color (HSL Method)

Instead of memorizing hex codes, learn to **manipulate HSL**:

```
HSL = Hue, Saturation, Lightness

Hue (0-360): The color family
  0/360 = Red
  60 = Yellow
  120 = Green
  180 = Cyan
  240 = Blue
  300 = Purple

Saturation (0-100%): Color intensity
  Low = Muted, sophisticated
  High = Vibrant, energetic

Lightness (0-100%): Brightness
  0% = Black
  50% = Pure color
  100% = White
```

### Generating a Full Palette

Given ANY base color, create a scale:

```
Lightness Scale:
  50  (lightest) → L: 97%
  100            → L: 94%
  200            → L: 86%
  300            → L: 74%
  400            → L: 66%
  500 (base)     → L: 50-60%
  600            → L: 48%
  700            → L: 38%
  800            → L: 30%
  900 (darkest)  → L: 20%
```

### Saturation Adjustments

| Context                    | Saturation Level                     |
| -------------------------- | ------------------------------------ |
| **Professional/Corporate** | Lower (40-60%)                       |
| **Playful/Youth**          | Higher (70-90%)                      |
| **Dark Mode**              | Reduce by 10-20%                     |
| **Accessibility**          | Ensure contrast, may need adjustment |

---

## 5. Context-Based Selection Guide

### Instead of Copying Palettes, Follow This Process:

**Step 1: Identify the Context**

```
What type of project?
├── E-commerce → Need trust + urgency balance
├── SaaS/Dashboard → Need low-fatigue, data focus
├── Health/Wellness → Need calming, natural feel
├── Luxury/Premium → Need understated elegance
├── Creative/Portfolio → Need personality, memorable
└── Other → ASK the user
```

**Step 2: Select Primary Hue Family**

```
Based on context, pick ONE:
- Blue family (trust)
- Green family (growth)
- Warm family (energy)
- Neutral family (elegant)
- OR ask user preference
```

**Step 3: Decide Light/Dark Mode**

```
Consider:
- User preference?
- Industry standard?
- Content type? (text-heavy = light preferred)
- Time of use? (evening app = dark option)
```

**Step 4: Generate Palette Using Principles**

- Use HSL manipulation
- Follow 60-30-10 rule
- Check contrast (WCAG)
- Test with actual content

---

## 6. Dark Mode Principles

### Key Rules (No Fixed Codes)

1. **Never pure black** → Use very dark gray with slight hue
2. **Never pure white text** → Use 87-92% lightness
3. **Reduce saturation** → Vibrant colors strain eyes in dark mode
4. **Elevation = brightness** → Higher elements slightly lighter

### Contrast in Dark Mode

```
Background layers (darker → lighter as elevation increases):
Layer 0 (base)    → Darkest
Layer 1 (cards)   → Slightly lighter
Layer 2 (modals)  → Even lighter
Layer 3 (popups)  → Lightest dark
```

### Adapting Colors for Dark Mode

| Light Mode             | Dark Mode Adjustment          |
| ---------------------- | ----------------------------- |
| High saturation accent | Reduce saturation 10-20%      |
| Pure white background  | Dark gray with brand hue tint |
| Black text             | Light gray (not pure white)   |
| Colorful backgrounds   | Desaturated, darker versions  |

---

## 7. Accessibility Guidelines

### Contrast Requirements (WCAG)

| Level          | Normal Text | Large Text |
| -------------- | ----------- | ---------- |
| AA (minimum)   | 4.5:1       | 3:1        |
| AAA (enhanced) | 7:1         | 4.5:1      |

### How to Check Contrast

1. **Convert colors to luminance**
2. **Calculate ratio**: (lighter + 0.05) / (darker + 0.05)
3. **Adjust until ratio meets requirement**

### Safe Patterns

| Use Case             | Guideline                         |
| -------------------- | --------------------------------- |
| **Text on light bg** | Use lightness 35% or less         |
| **Text on dark bg**  | Use lightness 85% or more         |
| **Primary on white** | Ensure dark enough variant        |
| **Buttons**          | High contrast between bg and text |

---

## 8. Color Selection Checklist

Before finalizing any color choice, verify:

- [ ] **Asked user preference?** (if not specified)
- [ ] **Matches project context?** (industry, audience)
- [ ] **Follows 60-30-10?** (proper distribution)
- [ ] **WCAG compliant?** (contrast checked)
- [ ] **Works in both modes?** (if dark mode needed)
- [ ] **NOT your default/favorite?** (variety check)
- [ ] **Different from last project?** (avoid repetition)

---

## 9. Anti-Patterns to Avoid

### ❌ DON'T:

- Copy the same hex codes every project
- Default to purple/violet (AI tendency)
- Default to dark mode + neon (AI tendency)
- Use pure black (#000000) backgrounds
- Use pure white (#FFFFFF) text on dark
- Ignore user's industry context
- Skip asking user preference

### ✅ DO:

- Generate fresh palette per project
- Ask user about color preferences
- Consider industry and audience
- Use HSL for flexible manipulation
- Test contrast and accessibility
- Offer light AND dark options

---

> **Remember**: Colors are decisions, not defaults. Every project deserves thoughtful selection based on its unique context.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall