# elementor-pro-designer-skill

Adopt this skill: https://proskills.md/skills/other/jainshwetank-elementor-pro-designer-skill

Page: https://proskills.md/skills/other/jainshwetank-elementor-pro-designer-skill
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 11259
sha: f84f16fa3d33bb6ef4b0782b0eb949d2f8be5971
upstream: https://github.com/jainshwetank/elementor-pro-designer-skill/blob/HEAD/SKILL.md

````text
---
name: elementor-pro-designer-skill
description: "Use this skill whenever helping someone build, design, or troubleshoot layouts in Elementor Pro V4 using the visual editor. Triggers on ANY mention of Elementor, page builder, Flexbox widget, Div block, section layout, widget configuration, responsive breakpoints, dark mode, scroll animations, Interactions tab, Variables Manager, Class Manager, Custom Code snippets, or any visual design work inside the Elementor panel. Also trigger when someone asks how to position elements, set spacing, apply typography, configure dark mode, prevent FOUC, or build scroll-triggered effects in Elementor. ALWAYS use this skill before suggesting any Elementor V4 implementation — it contains critical V4-specific panel structure, common AI mistakes to avoid, and production-tested patterns."
version: "1.0.0"
elementor_pro: "4.x"
tested_with: "Claude Sonnet, Claude Opus"
---

# Elementor Pro V4 — Visual Builder Skill

## How to Use This Skill

This file covers the V4 panel structure and decision rules. Detailed references are in:

- **references/panel.md** — Full tab/widget/field reference, Variables Manager, Class Manager
- **references/classes.md** — Class system, variable naming, how many to create, state variants
- **references/patterns.md** — Reusable layout patterns with panel instructions
- **references/troubleshooting.md** — Common problems and fixes

Read the relevant reference before giving panel instructions.

---

## V4 vs V3: What Changed

V4 is a breaking change from V3 in several areas. Never suggest V3 patterns.

| Area | V3 | V4 |
|---|---|---|
| Primary layout widget | Container | **Flexbox** (atomic) |
| Secondary layout widget | Inner Container | **Div block** (atomic) |
| Panel tabs | Content / Style / Advanced | **General / Style / Interactions** — no Advanced tab |
| Class system | Limited | **Class Manager** — global reusable classes with 4 states |
| Design tokens | Not native | **Variables Manager** — CSS custom properties |
| Interactions | Basic | Native per-element, stackable, scroll-triggered |
| Typography | Text Editor widget | **Paragraph** (atomic) replaces Text Editor |

**Critical**: If you catch yourself writing "Advanced tab" or "Container widget" — stop. Those are V3. In V4: Style tab, Flexbox widget, and Interactions tab.

---

## First Questions to Ask

Before giving panel instructions, clarify two things if not already known:

**1. Are you using a dark/light mode theme switcher?**
If yes → all colors must use CSS variables. Hardcoded panel values won't respond to the theme toggle.
If no → colors can be set directly in the panel. Variables are still recommended for global consistency but not required.

**2. Do you have an existing class and variable system, or are we building one?**
If existing → ask for their variable names and class conventions before creating new ones.
If building from scratch → create a logical system together. See references/classes.md for recommended starting sets and naming conventions.

---

## Decision Hierarchy

Before suggesting ANY implementation, work through this order:

1. Can existing classes handle it? Stack them. (`t-h2 + is-accent`)
2. Can panel Style tab settings handle it? Use them as a LOCAL value.
3. Can a CSS variable handle it? Reference it via the variable picker (ƒ icon).
4. Does it need a new global class? Create in Class Manager, set properties via panel.
5. Does it need a new variable? Create in Variables Manager.
6. Does it absolutely need Custom Code? Stop and rethink — there is almost always a panel-first solution.
7. If Custom Code is truly unavoidable: create a **separate named snippet**. Never add to the Design Tokens snippet.

**Global class vs local**: If a property will be reused on multiple elements → global class. If it's one-off → local.

---

## Common AI Mistakes in Elementor V4

**❌ Referencing the Advanced tab**
V4 has no Advanced tab. Properties live across General, Style, and Interactions tabs only. The Custom CSS field is at the bottom of the Style tab but should always be left empty.

**❌ Suggesting inline CSS or custom CSS per widget**
Classes first, panel settings second. Custom CSS on individual widgets bypasses the class system and creates unmaintainable one-offs.

**❌ Confusing Flexbox with Container**
`Container` is the V3 widget. In V4, use `Flexbox` (in Atomic Elements). Different widgets, different behavior.

**❌ Hardcoding hex colors when using a theme switcher**
If the project uses a dark/light mode toggle, all colors must use CSS variables. Hardcoded hex values won't respond to theme changes. If there is no theme switcher, colors can be set directly in the panel — ask first.

**❌ Using fixed heights for layout**
Use `Flex child > Flex Size: custom (grow: 1)` to fill available space. Fixed heights break responsive behavior.

**❌ Using margins on children for even spacing**
Set gaps on the parent Flexbox. Use margins on specific children only for irregular spacing.

**❌ Suggesting position: absolute for layout problems**
Most layout problems can be solved with Flex child settings. Absolute is a last resort.

**❌ Assuming Laptop is a default breakpoint**
V4 ships with 3 breakpoints: Desktop, Tablet (1024px), Phone (767px). Laptop (1366px) is a custom breakpoint — useful to add, but not present by default.

**❌ Assuming all items start without padding**
Some V4 widgets have a default padding of 10px. Always explicitly set padding to 0 if not needed, rather than assuming it starts at zero.

---

## Instruction Format

Always give instructions in tab order: General → Style → Interactions. Never describe CSS — describe panel field names and values.

```
WIDGET: Flexbox
NAME: "Hero Content"
  (This is what to type in the Structure panel label field)

GENERAL TAB:
  HTML Tag: Section
  ID: hero-content  [only if needed for JS or anchor links]

STYLE TAB:
  Classes: l-stack  ← GLOBAL CLASS

  Layout:
    Display: Flex  ← from class l-stack
    Direction: Column  ← from class l-stack
    Justify: Center  ← LOCAL
    Align: Center  ← LOCAL
    Gap, Row: var(--spacing_md)  ← LOCAL, use variable picker (ƒ)
  Spacing:
    Padding, Top: var(--spacing_xl)  ← LOCAL
    Padding, Bottom: var(--spacing_xl)  ← LOCAL
  Size:
    Height: 90vh  ← LOCAL

INTERACTIONS TAB:
  1: Page load / Fade In / 750ms / delay 0ms
```

**Labels:**
- `← GLOBAL CLASS` — property is set by the class, don't override locally
- `← LOCAL` — set directly in the panel for this element only
- `← NEW CLASS [name]` — create in Class Manager first, then apply
- `use variable picker` — click the ƒ icon in the field, never type hex

**Panel language, not CSS:**

| ❌ CSS | ✅ Panel |
|---|---|
| "Set margin-top to auto" | Spacing > Margin > Top: auto ← LOCAL |
| "Add border-radius: 50%" | Border > Radius: 50px (link all corners) ← LOCAL |
| "Use position: absolute" | Position > Position: Absolute ← LOCAL |
| "Set display: flex" | Layout > Display: Flex ← from class or LOCAL |

---

## Layer Architecture

```
Page
└── Flexbox "Section Wrap"            ← outermost, always Flexbox
    ├── Flexbox "Section Content"     ← primary layout container
    │   ├── Flexbox "Group A"         ← element grouping
    │   │   ├── Heading "..."
    │   │   └── Paragraph "..."
    │   └── Flexbox "Group B"
    │       └── Image "..."
    └── Div block "Transition"        ← decorative, non-structural
```

**Structure panel naming:**
Every layer should be renamed in the Structure panel (right sidebar). Use descriptive names — not the widget default ("Flexbox 3"). The NAME field in instruction format above is what to type in the Structure panel rename field. Good examples: "Hero Wrap", "Nav Row", "Card Group", "Fold Crease". Clear layer names are essential for team collaboration and debugging.

Rules:
- Outermost section = always Flexbox (never Div block)
- Nesting limit: 4 levels maximum
- Space distribution: Flex child > Flex Size (grow), not fixed heights
- Even spacing: gaps on parent Flexbox
- Irregular spacing: margin on specific child only

---

## Responsive System

**Default V4 breakpoints:** Desktop (base), Tablet (1024px), Phone (767px).

Laptop (1366px) is a recommended custom breakpoint — add via Elementor > Site Settings > Layout. Not present by default.

Desktop is always the base. Set all properties at desktop first, then switch the breakpoint selector in the panel header to override at smaller sizes. Overrides cascade down — a Tablet override applies to Phone unless Phone has its own explicit override.

**CSS variables do not change per breakpoint.** For responsive sizing without breakpoint overrides, use `clamp()` in Variables Manager. Example:

```css
/* In Variables Manager — scales fluidly between 16px at 320px viewport and 24px at 1440px */
--spacing_section: clamp(1rem, 3vw, 1.5rem);

/* For font sizes */
--font_h1: clamp(2rem, 5vw, 4rem);
```

Use clamp for: font sizes, section padding, gap values. This reduces the number of breakpoint overrides needed.

Standard Phone overrides (when not using clamp):
- Heading font sizes: −20% from desktop value
- Padding: reduce to smaller spacing variable
- Flex direction: Row → Column for stacking
- Gaps: reduce from large to small spacing variable

---

## Dark Mode

Only implement if the project uses a light/dark theme switcher. If not, skip this section.

The V4 approach uses a `[data-theme="dark"]` attribute on `<html>`, toggled by JavaScript, with CSS variable overrides in the Design Tokens snippet.

1. Define light values on `:root`
2. Define dark overrides under `[data-theme="dark"]`
3. All panel colors set via variables — they swap automatically on toggle
4. Toggle button uses a `data-theme-toggle` custom attribute (General tab → Attributes)

See references/snippets.md for the full implementation.

---

## Interactions

The Interactions tab is Tab 3 on every V4 widget. Multiple animations can be stacked per element.

| Field | Options |
|---|---|
| Trigger | Page load / Scroll into view |
| Effect | Fade / Slide / Scale |
| Type | In / Out |
| Direction | Up / Down / Left / Right |
| Duration | 0 / 100 / 200 / 300 / 400 / 500 / 750 / 1000 / 1250 / 1500 ms |
| Delay | 0 / 100 / 200 / 300 / 400 / 500 / 750 / 1000 / 1250 / 1500 ms |

Above-the-fold elements (visible on page load without scrolling): use **Page load** trigger.
Below-the-fold elements: use **Scroll into view** trigger.

---

## Quality Checklist

Before marking any section done:

- [ ] Structure panel layer names are descriptive (not "Flexbox 3")
- [ ] No custom CSS in any widget's Custom CSS field
- [ ] Decision hierarchy followed (class → panel → variable → code)
- [ ] No more than 4 nesting levels
- [ ] If using theme switcher: all colors use variables, no hardcoded hex
- [ ] Responsive checked at Desktop, Tablet, Phone (+ Laptop if added)
- [ ] Interactions: Page load for above-fold, Scroll into view for below-fold
- [ ] Spacing uses gaps on parents, not margins on children
- [ ] Elements with unexpected spacing: check for default 10px padding
````

## File: README.md
size: 3146
sha: e59ecbcc2f68616d7aab92d000ab8eac5dff662f
upstream: https://github.com/jainshwetank/elementor-pro-designer-skill/blob/HEAD/README.md

````text
# elementor-pro-designer-skill

**A Claude skill for designing in the Elementor Pro V4 visual editor.**

Every existing Elementor skill for Claude is written for PHP developers building addons. This one is for designers and builders working in the visual panel — the actual Elementor interface most people use every day.

---

## What it does

Gives Claude accurate, panel-first knowledge of Elementor Pro V4 so it can:

- Give instructions using correct V4 panel field names (not CSS properties)
- Follow the decision hierarchy: classes → panel settings → variables → code
- Avoid the common AI mistakes that produce unmaintainable builds
- Set up dark mode correctly using `[data-theme]` CSS variable swaps
- Configure responsive behavior at all 4 V4 breakpoints
- Build staggered scroll animations using the native Interactions tab
- Troubleshoot layout, spacing, typography, and dark mode problems

---

## What's different from other Elementor skills

| | peixotorms/elementor-* | this skill |
|---|---|---|
| Target | PHP developer building addons | Designer using the visual editor |
| Covers | Widget_Base API, hooks, PHP | Panel tabs, classes, variables, patterns |
| Design intent | None | Panel-first, class-first, anti-hardcode |
| V4 specifics | Partial | Complete — no V3 contamination |

---

## Install

### Claude.ai (upload)
1. Download `elementor-pro-designer-skill.skill` from [Releases](../../releases)
2. In Claude.ai, start a new chat
3. Upload the `.skill` file
4. Start building

### Claude Code (CLI)
```bash
claude plugin marketplace add [your-github-username]/elementor-pro-designer-skill
claude plugin install elementor-pro-designer-skill
```

### skillfish
```bash
npx skillfish add [your-github-username]/elementor-pro-designer-skill
```

---

## File structure

```
elementor-pro-designer-skill/
├── SKILL.md                     — Main skill: decision hierarchy, V4/V3 delta, common AI mistakes
├── references/
│   ├── panel.md                 — Full panel tab/field reference, widget list, Class Manager, Variables Manager
│   ├── patterns.md              — Reusable layout patterns with complete panel instructions
│   └── troubleshooting.md      — Common problems and fixes
└── examples/
    └── (golden examples — coming in v1.1)
```

---

## Compatibility

- Elementor Pro 4.x
- WordPress 6.x
- Tested with Claude Sonnet (claude.ai and Claude Code)

---

## Contributing

Issues and PRs welcome. Most useful contributions:

- Additional layout patterns from production builds
- New troubleshooting entries (real problems you hit)
- Version-specific notes when Elementor Pro updates break behavior
- Golden examples (complete sections with panel instructions)

---

## Changelog

### v1.0.0
- Initial release
- Panel reference (all 3 tabs, all fields)
- V4 vs V3 delta table
- Common AI mistakes section
- Decision hierarchy
- Layout patterns: hero, two-column, frame, step header, staggered entrance
- Troubleshooting: layout, spacing, typography, dark mode, interactions, custom code
- Responsive system documentation

---

## License

MIT
````

## File: references/classes.md
size: 7620
sha: 4883d92eac40ee78306bb8efe710870f03caa69a
upstream: https://github.com/jainshwetank/elementor-pro-designer-skill/blob/HEAD/references/classes.md

````text
# Class & Variable System — Elementor V4

---

## How Classes Work in V4

A class is a reusable set of Style tab properties applied to multiple elements. Classes are created in Class Manager and applied via the Classes field at the top of the Style tab.

**One class can hold many properties, and each property can reference a variable.**

Example — `t-body` class might contain:
- Typography > Font family: `var(--font_body)`
- Typography > Font size: `var(--size_body)` or `clamp(1rem, 2vw, 1.125rem)`
- Typography > Font weight: 400
- Typography > Line height: 1.55
- Typography > Text color: `var(--color_text-primary)`

Applying `t-body` to a Paragraph sets all five properties at once. To change the body font globally, update the variable — every element using `t-body` updates automatically.

**Four states per class:**
Every class has four state tabs in Class Manager: Normal / Hover / Focus / Active.
- Normal: default appearance
- Hover: on mouse over (most commonly used beyond Normal)
- Focus: keyboard focus (important for accessibility)
- Active: pressed/active state

Set states only as needed. Leave states empty if no change is required.

**Stacking classes:**
Multiple classes can be applied to one element, separated by spaces. They combine — if they set different properties, both apply. If they set the same property, the last class wins.

```
Heading "Step Label"
Classes: t-overline is-accent is-medium
```
This applies: font scale (from `t-overline`) + color accent (from `is-accent`) + weight 500 (from `is-medium`).

---

## Naming Convention

| Prefix | Category | Examples |
|---|---|---|
| `t-` | Typography | `t-h1`, `t-h2`, `t-body`, `t-caption`, `t-overline` |
| `l-` | Layout | `l-stack`, `l-row`, `l-row-between`, `l-center` |
| `c-` | Component | `c-card`, `c-tag`, `c-nav-link` |
| `is-` | Modifier / state | `is-accent`, `is-muted`, `is-border` |
| `u-` | Utility | `u-hide-phone`, `u-hide-tablet` |

---

## How Many Classes to Create

**Start small. Add only what you need.**

For a typical portfolio or landing site, a working system needs approximately:

| Category | Count | Rationale |
|---|---|---|
| Typography (t-) | 5–8 | display, h1, h2, h3, overline, body, body-sm, caption |
| Layout (l-) | 3–5 | stack, row, row-between, center, grid |
| Modifiers (is-) | 4–8 | accent color, muted, border, medium weight, light weight |
| Components (c-) | 2–6 | card, tag, button, nav item (grow as needed) |
| Utilities (u-) | 2–4 | hide-phone, hide-tablet |

**Total: 16–31 classes for a complete site.**

Signs you have too many classes: you have classes that are only used once, classes whose names don't clearly describe what they do, or classes that overlap significantly with others.

Signs you need more classes: you find yourself applying the same combination of local values repeatedly on different elements.

---

## Recommended Typography Classes

Each class sets multiple properties via variables. Adapt values to your type scale.

| Class | Sets | Typical values |
|---|---|---|
| `t-display` | font-family, size, weight, line-height | 72–96px, weight 200–300, lh 1.0 |
| `t-h1` | font-family, size, weight, line-height | 48–64px, weight 400–500, lh 1.1 |
| `t-h2` | font-family, size, weight, line-height | 36–48px, weight 400–500, lh 1.2 |
| `t-h3` | font-family, size, weight, line-height | 24–32px, weight 400–500, lh 1.3 |
| `t-overline` | font-family, size, weight, letter-spacing | 11–13px, weight 500–600, ls 0.1em |
| `t-body` | font-family, size, weight, line-height | 16–18px, weight 400, lh 1.55 |
| `t-body-sm` | font-family, size, weight, line-height | 14–15px, weight 400, lh 1.5 |
| `t-caption` | font-family, size, weight, line-height | 11–13px, weight 400, lh 1.4 |

Typography classes do **not** set color — use `is-` modifier classes for that.

---

## Recommended Layout Classes

| Class | Properties |
|---|---|
| `l-stack` | Display: Flex, Direction: Column, Align items: stretch |
| `l-row` | Display: Flex, Direction: Row, Align items: center |
| `l-row-between` | Display: Flex, Direction: Row, Justify: space-between, Align: center |
| `l-center` | Display: Flex, Justify: center, Align: center |

---

## Recommended Modifier Classes

Each modifier class sets a single property so it can stack cleanly with others.

| Class | Property | Value |
|---|---|---|
| `is-accent` | Text color | `var(--color_accent)` |
| `is-muted` | Text color | `var(--color_text-tertiary)` |
| `is-primary` | Text color | `var(--color_text-primary)` |
| `is-medium` | Font weight | 500 |
| `is-light` | Font weight | 300 |
| `is-border` | Border | 1px solid `var(--color_border)` |

---

## Variable System

### How Many Variables to Create

For a typical site, aim for 15–25 variables total. More than that becomes hard to maintain.

| Category | Count | Examples |
|---|---|---|
| Colors | 8–12 | bg-primary, bg-secondary, text-primary, text-secondary, text-tertiary, accent, accent-light, border |
| Spacing | 5–7 | spacing_xs, sm, md, lg, xl, section-pad, page-pad |
| Typography | 3–5 | font_heading, font_body, font_mono + 1–2 size variables |

**Signs you have too many variables:** you have variables that are only used in one place, or variables whose values are identical.

### Naming Convention

Use underscores as separators. Elementor stores them with `--` prefix in CSS.

```
color_[role]        color_bg-primary, color_text-secondary, color_accent
spacing_[size]      spacing_xs, spacing_sm, spacing_md, spacing_lg, spacing_xl
font_[role]         font_heading, font_body, font_mono
size_[name]         size_section-pad, size_max-width
```

In panel fields: use the variable picker (ƒ icon).
In Custom Code snippets: `var(--color_accent)` — note the `--` prefix.

### Using clamp() for Fluid Responsiveness

Enter clamp expressions directly as variable values in Variables Manager. This handles responsiveness without per-breakpoint panel overrides.

```css
/* Syntax: clamp(minimum, preferred, maximum) */

/* Font sizes */
--font_h1:       clamp(2rem, 5vw, 4rem)
--font_body:     clamp(1rem, 2vw, 1.125rem)

/* Spacing */
--spacing_section: clamp(3rem, 8vw, 7rem)
--spacing_md:      clamp(1rem, 3vw, 1.5rem)
```

Use clamp for: all font sizes, section padding top/bottom, gap values between major layout elements.
Do not use clamp for: pixel-precise values that should not scale (border widths, icon sizes, border radii).

---

## How to Create a Variable

1. In any Style tab field that accepts a variable (color, size, spacing), click the **ƒ** icon
2. Click the **+** button to create a new variable
3. Name it (underscore convention), enter the value or clamp expression
4. The variable is now available globally across all elements via the ƒ picker
5. To edit all variables: ƒ icon → **gear icon** (⚙) to open full Variables Manager

## How to Create a Class

1. Style tab → Classes field at the top
2. Type a new class name (follow prefix convention: `t-`, `l-`, `is-`, `c-`, `u-`)
3. Press Enter to create it — it now exists in Class Manager
4. Set properties in the panel (Layout, Spacing, Size, Typography, Background, Border)
5. These properties are now global — applied to every element that uses this class
6. Switch between Normal / Hover / Focus / Active state tabs to define state variations
7. To edit later: Classes field → "Manage Classes" link, or via Elementor site settings

**To override a class property for one element only:** change the value in the panel after applying the class. It shows a "local" badge — the class itself is not modified.
````

## File: references/panel.md
size: 7111
sha: 30949ac1262e1e1cf9ba6a2a64cf6b29920b21e7
upstream: https://github.com/jainshwetank/elementor-pro-designer-skill/blob/HEAD/references/panel.md

````text
# Panel Reference — Elementor V4

## Widget Panel: 3 Tabs

Every widget in V4 has exactly three tabs: **General**, **Style**, **Interactions**.

---

### Tab 1: General

- **HTML Tag** — Div / Section / Header / Footer / Main / Article / Nav / Aside
- **Link** — (+) button to add
- **ID** — text field (use for anchor links or JS hooks; leave blank otherwise)
- **Attributes** — (+) button to add custom `data-*` attributes (e.g., `data-theme-toggle`)
- **Display Conditions** — Elementor Pro only; show/hide by user role, URL, date, etc.

---

### Tab 2: Style

Properties listed top to bottom as they appear in the panel.

**Classes**
At the top of the Style tab. Type a class name to apply from Class Manager. Multiple classes stack — separate with spaces. "local" badge = instance override. Class badge = global class property.

**Layout**
- Display: `Block` / `Flex` (default) / `In-blk` / `None` / `Inline-flex`
- Direction (Flex only): `Row` (default) / `Column` / `Row reversed` / `Column reversed`
- Justify content: flex-start / center / flex-end / space-between / space-around / space-evenly
- Align items: flex-start / center / flex-end / stretch
- Gap: Column gap (px) + Row gap (px), link toggle to sync
- Wrap: nowrap / wrap / wrap-reverse

Flex child sub-section (visible when element is inside a Flex parent):
- Align self: auto / flex-start / center / flex-end / stretch
- Order: integer
- Flex Size: Fill space (grow 1) / Fit content / Fixed / Custom (grow + shrink + basis)

**Spacing**
- Margin: T / R / B / L, link toggle, units: px / % / vw / vh / em / rem
- Padding: T / R / B / L, link toggle, same units
- Note: some V4 widgets have a **default padding of 10px**. Always check and set to 0 if not needed.

**Size**
- Width, Height, Min width, Min height, Max width, Max height
- Units: px / % / vw / vh / em / rem
- Overflow: visible / hidden / auto / scroll
- (Show more): Aspect Ratio, Object fit (cover / contain / fill / none)

**Position**
- Position: default / relative / absolute / fixed / sticky
- Inset (top / right / bottom / left) appears when non-default
- Z-index
- Anchor offset (for sticky)

**Typography**
- Font family — picker; use variable picker (ƒ) to reference a font variable
- Font weight: 100 / 200 / 300 / 400 / 500 / 600 / 700 / 800 / 900
- Font size + unit — use variable picker (ƒ) for a size variable or clamp value
- Text align: left / center / right / justify
- Text color — picker; use variable picker (ƒ) to reference a color variable
- (Show more): Line height, Letter spacing, Word spacing, Text decoration, Text transform, Direction (LTR/RTL), Font style (italic), Text stroke

**Background**
- Color — picker; use variable picker (ƒ) to reference a background variable
- Overlay (+): add gradient or image overlays
- Clipping: text / content-box / border-box / padding-box

**Border**
- Width: T / R / B / L or all, link toggle
- Color — picker; use variable picker (ƒ)
- Type: none / solid / dashed / dotted / double / groove / ridge
- Radius: TL / TR / BR / BL, link toggle

**Effects**
- Blend mode
- Opacity: 0–100%
- Box shadow (+): color, X, Y, blur, spread, inset toggle
- Transform (+): rotate, scale, translate, skew
- Transitions (+): property, duration, timing, delay
- Filters (+): blur, brightness, contrast, grayscale, hue-rotate, invert, saturate, sepia
- Backdrop filters (+): same options, apply to background behind element

**Custom CSS**
Code editor at the very bottom of the Style tab. **Always leave this empty.** Use classes and panel settings instead.

---

### Tab 3: Interactions

Add (+) button at the top. Multiple interactions can be stacked on one element.

- **Trigger**: Page load / Scroll into view
- **Effect**: Fade / Slide / Scale
- **Type**: In / Out
- **Direction**: Up / Down / Left / Right
- **Duration**: 0 / 100 / 200 / 300 / 400 / 500 / 750 / 1000 / 1250 / 1500 ms
- **Delay**: 0 / 100 / 200 / 300 / 400 / 500 / 750 / 1000 / 1250 / 1500 ms
- **Preview**: ▶ play button
- **Delete**: ✕

---

## Atomic Widgets (V4 — use these)

| Widget | Purpose | Replaces (V3) |
|---|---|---|
| Flexbox | Layout container with flex | Container |
| Div block | Generic non-flex block | Inner Container |
| Heading | `<h1>`–`<h6>` text | Heading (Basic) |
| Paragraph | Body / rich text | Text Editor (Basic) |
| Image | Image with object-fit | Image (Basic) |
| Button | CTA button | Button (Basic) |
| SVG | Inline SVG | — |
| Divider | `<hr>` line separator | Divider (Basic) |
| YouTube | Embedded video | Video (Basic) |
| Tabs | Tabbed content | — |

## Legacy Widgets (V3 — avoid in new V4 builds)

Container, Inner Container, Text Editor, Spacer, Google Maps.

These still exist for backward compatibility. Do not use in new V4 builds.

---

## Variables Manager

**How to access:**
- When editing a color/size field in the Style tab: click the ƒ variable icon in the field, then the **+** button to create a new variable
- Direct access: ƒ icon → **gear icon** (⚙) to open the full Variables Manager

Variables are CSS custom properties. Elementor stores them with a `--` prefix, so a variable named `color_accent` is referenced in code as `var(--color_accent)`.

**Naming convention:** Use underscores as separators.
```
color_accent        → brand accent color
color_primary       → primary text or brand color
color_bg-primary    → background colors, text colors, border colors
spacing_md          → padding, margin, gap values
font_heading        → font family
size_section-pad    → composite spacing for sections
```

**Using clamp() for responsive variables:**
Define fluid values in Variables Manager so they scale without per-breakpoint overrides.
```css
/* Font size that scales from 2rem at mobile to 4rem at desktop */
clamp(2rem, 5vw, 4rem)

/* Spacing that scales from 1rem to 2rem */
clamp(1rem, 3vw, 2rem)
```
Enter the clamp expression directly as the variable value. Apply to font sizes, section padding, and gap values to handle most responsiveness in one place.

---

## Class Manager

**How to access:** Style tab → Classes field → type a class name → "Manage Classes" link, or via Elementor site settings.

**What a class stores:**
A class can hold multiple properties, and each property can reference a variable. Example: a `t-body` class might set font-family (via `var(--font_body)`), font-size (via `var(--size_body)`), line-height (1.55), and color (via `var(--color_text-primary)`) — all in one class.

**Four states per class:**
Every class in V4 has four state tabs:
1. **Normal** — default appearance
2. **Hover** — on mouse over
3. **Focus** — keyboard focus
4. **Active** — active/pressed state

Set each state as needed. Hover is the most commonly used beyond Normal. Leave states empty if no change is needed for that state.

**Class badge vs local badge:**
When a class property is applied and not overridden: shows the class badge (class name).
When you override a class property for one specific element: shows "local" badge. This does not modify the class itself — it's an instance override.
````

## File: references/patterns.md
size: 4517
sha: 551b0b9a4e50bb4a2f8356bee57b1402c1fd2913
upstream: https://github.com/jainshwetank/elementor-pro-designer-skill/blob/HEAD/references/patterns.md

````text
# Layout Patterns — Elementor V4

Production-tested panel instruction sequences. Copy and adapt.

---

## Pattern: Full-height section with bottom-pinned element

Use case: Hero sections, opening screens with a scroll cue pinned to the bottom.

```
Flexbox "Section Wrap"
  CLASSES: [your section class]
  STYLE > Layout > Direction: Column
  STYLE > Layout > Align items: center
  STYLE > Size > Height: 100vh or 90vh ← LOCAL

  ├── Flexbox "Content"
  │     STYLE > Layout > Justify: center
  │     STYLE > Layout > Align: center
  │     STYLE > Flex child > Flex Size: custom (grow 1) ← LOCAL
  │     └── [Headings, CTAs, etc.]
  │
  └── [Scroll cue or bottom element]
        STYLE > Spacing > Margin bottom: [spacing variable] ← LOCAL
```

Key: Use `Flex child > Flex Size: grow 1` on the content area, not a fixed height.
The bottom element pins naturally because it's the last flex child.

---

## Pattern: Two-column layout

Use case: Image + text, metric + description, any side-by-side arrangement.

```
Flexbox "Row"
  STYLE > Layout > Direction: Row
  STYLE > Layout > Align items: center
  STYLE > Layout > Gap, Column: [spacing variable] ← LOCAL

  ├── Flexbox "Left Column"
  │     STYLE > Flex child > Flex Size: custom (grow 1, shrink 1, basis 0%) ← LOCAL
  │     └── [Content]
  │
  └── Flexbox "Right Column"
        STYLE > Flex child > Flex Size: custom (grow 1, shrink 1, basis 0%) ← LOCAL
        └── [Content]
```

For unequal columns (e.g., 60/40): set basis to `60%` and `40%` respectively.
At Phone breakpoint: change Direction to Column for stacking.

---

## Pattern: Image in a frame

Use case: Screenshots, mockups, any image that needs contained sizing.

```
Flexbox "Frame"
  STYLE > Size > Width: [specific px or %] ← LOCAL
  STYLE > Size > Aspect Ratio: [match content — 16/10, 4/3, etc.] ← LOCAL
  STYLE > Border > Radius: 4px ← LOCAL
  STYLE > Size > Overflow: hidden ← LOCAL

  └── Image
        STYLE > Size > Width: 100% ← LOCAL
        STYLE > Size > Height: 100% ← LOCAL
        STYLE > Size > Object fit: cover ← LOCAL
```

Important: Aspect ratio should serve the content. Don't force landscape framing on portrait content (e.g., phone screenshots, tall app UIs). Let the content dictate the frame shape.

---

## Pattern: Step/section header

Use case: Numbered section headers that communicate hierarchy.

```
Flexbox "Step Header"
  STYLE > Layout > Direction: Column
  STYLE > Layout > Gap, Row: [small spacing variable] ← LOCAL

  ├── Heading "Number" (e.g., "01")
  │     CLASSES: [your display/muted class]
  │     STYLE > Typography > Size: 72px ← LOCAL
  │     STYLE > Typography > Weight: 200 ← LOCAL
  │     STYLE > Effects > Opacity: 6% ← LOCAL
  │
  ├── Heading "Label" (e.g., "Step 1")
  │     CLASSES: [your overline/label class]
  │
  └── Heading "Title" (e.g., "The pattern")
        CLASSES: [your h2 class]
```

The ghost number (6% opacity) creates depth without competing with the headline.

---

## Pattern: Alternating section backgrounds

Use case: Visual rhythm between content sections.

```
Section A: no background (inherits body background)
Section B: STYLE > Background > Color: [secondary bg variable] ← LOCAL
Section C: no background (inherits body background)
```

Never alternate with hardcoded colors — always use variables so dark mode works.

---

## Pattern: Centered section with constrained text width

Use case: Long-form text sections where line length needs limiting for readability.

```
Flexbox "Section"
  STYLE > Layout > Direction: Column
  STYLE > Layout > Align items: center
  STYLE > Spacing > Padding [T/B]: [large spacing variable]

  └── Flexbox "Content"
        STYLE > Size > Max width: 640px ← LOCAL
        STYLE > Layout > Direction: Column
        STYLE > Layout > Gap, Row: [medium spacing variable]
        └── [Paragraphs, headings]
```

Apply max-width on the inner content wrapper, not the section itself. The section stays full-width.

---

## Pattern: Horizontal rule / section divider

Use case: Visual separation within a section (not between sections).

```
Div block "Divider"
  STYLE > Size > Width: 100%, Height: 1px ← LOCAL
  STYLE > Background > Color: [use border/muted variable] ← LOCAL
  STYLE > Spacing > Margin [T/B]: [spacing variable] ← LOCAL
```

Use a Div block, not the Divider widget — more control, consistent class system.
````

## File: references/troubleshooting.md
size: 5501
sha: b07a6de40784a86caf2ab9730b782981c343187a
upstream: https://github.com/jainshwetank/elementor-pro-designer-skill/blob/HEAD/references/troubleshooting.md

```text
# Troubleshooting — Elementor V4

Symptoms, causes, and fixes for common V4 visual builder problems.

---

## Layout problems

**Elements not stacking vertically inside a Flexbox**
- Check Direction. It must be set to ↓ (down/column), not → (right/row).
- If a class is setting the direction, you need to override it locally or check the class.

**Flex child won't fill remaining height**
- Set Flex child > Flex Size: Custom → Grow: 1, Shrink: 0, Basis: 0%.
- The parent must have a defined height (vh, px, or flex itself) for grow to work.
- Never use `height: 100%` on a flex child — use grow instead.

**Two columns stacking vertically on desktop**
- Parent Flexbox Direction must be → right (row), not ↓ down (column).
- If a class forces column direction, override locally at desktop breakpoint.

**Gap not appearing between elements**
- Gap only works on Flexbox parents. If the parent is a Div block (non-flex), gap has no effect.
- Solution: Change parent to Flexbox, or use Spacing > Margin on individual children.

**Element overflowing its parent**
- Set parent: Size > Overflow: hidden.
- Check if a fixed width or min-width on the child exceeds the parent.

**Sticky element not sticking**
- Position must be set to Sticky on the element itself.
- The parent must not have `overflow: hidden` — this breaks sticky.
- Anchor offset controls how far from the top the element sticks.

---

## Spacing problems

**Padding not applying symmetrically**
- Check if the link toggle (chain icon) is active. If not, T/R/B/L are set independently.
- Check if a class is setting conflicting padding — the "local" badge will show if it's an override.

**Margin between elements is uneven**
- If you're using margin on children, gaps will compound between some elements.
- Solution: Remove child margins, use Gap on the parent Flexbox instead.
- Use child margin only for one-off irregular spacing needs.

---

## Typography problems

**Font size not changing**
- A class might be setting the font size and you're editing a local override that's not taking effect.
- Check if the Typography > Font size field shows a class badge or "local" badge.
- If class badge: change the class in Class Manager, or override locally.

**Text color not matching variable**
- Make sure the color field shows the variable name, not a hex value.
- If it shows hex: click the color picker, select the variable icon (ƒ), choose the variable.

**Line height making text feel too tight or loose**
- Line height is hidden under Style > Typography > Show more.
- For body text, 1.5–1.6 is standard. For headings, 1.1–1.2 is standard.

---

## Dark mode problems

**Dark mode not applying**
- Check that the Design Tokens snippet contains `[data-theme="dark"]` variable overrides.
- Check that the toggle button has the `data-theme-toggle` attribute set in General tab → Attributes.
- Check that the Dark Mode Toggle snippet is active and in the footer position.
- Open browser DevTools and verify `html` element has `data-theme="dark"` attribute after clicking toggle.

**Some elements not switching in dark mode**
- Only elements using CSS variables will switch. Hardcoded hex colors will not.
- Find the element, check each color field — replace any hex values with the appropriate variable.

**Flash of wrong theme on page load**
- The Dark Mode Toggle snippet reads localStorage on load, but the FOUC snippet may be delaying visibility.
- Ensure the `data-theme` attribute is applied before `visibility: visible` is triggered.
- Solution: Move the localStorage read to an inline `<script>` in `<head>` (before the FOUC snippet fires).

---

## Interaction problems

**Animation not triggering**
- Trigger must be "Scroll into view" for scroll-based reveals.
- Test by scrolling the element out of view and then back in.
- If the page loaded with the element already visible, "Scroll into view" never fires — use "Page load" instead for above-the-fold elements.

**Animation playing too early / element visible before animation**
- The "Out" direction (Fade Out, Slide Out) is for exit animations. You likely want "In".
- If elements are visible before scroll, check if a previous animation left them in a visible state.

**Multiple animations on one element conflicting**
- Check the Interactions tab — it stacks. If there's a leftover animation from testing, delete it (✕ button).
- Two "Fade In" animations on the same element will both fire and may conflict.

**Interaction not showing in Interactions tab**
- The Interactions tab is Tab 3 (not Style, not General). Make sure you're on the right tab.
- Only available on elements in Elementor V4 — not on legacy V3 widgets.

---

## Custom Code problems

**Custom Code snippet not applying**
- Check the snippet is set to Active (toggle in the snippet list).
- Check the Location: `<head>` for CSS, footer for JS.
- Check for syntax errors — even a missing `;` will break the entire snippet.

**CSS variable not resolving**
- Variable names in Custom Code use `--` prefix: `var(--color_accent)`.
- Check that the variable is defined in `:root` in the Design Tokens snippet.
- Elementor adds `--` automatically to variables defined in Variables Manager, but Custom Code snippets must use the full `var(--name)` syntax.

**Design Tokens snippet growing too large**
- Only color variables and class-to-color mappings belong here.
- If you're adding layout rules, animations, or component styles — move them to a new, named snippet.
```

## File: CHANGELOG.md
size: 1523
sha: f3af166d91f0c931e0342feaad5bd16cd1fba9ef
upstream: https://github.com/jainshwetank/elementor-pro-designer-skill/blob/HEAD/CHANGELOG.md

```text
# Changelog

All notable changes to this skill are documented here.

Format: `## [version] — YYYY-MM-DD`

---

## [1.0.0] — 2026-03-30

### Added
- SKILL.md: decision hierarchy, V4/V3 delta, first questions to ask, common AI mistakes, instruction format (General → Style → Interactions order), layer architecture with Structure panel naming, responsive system with clamp() guidance, dark mode (conditional on theme switcher), interactions with exact dropdown values, quality checklist
- references/panel.md: complete 3-tab panel reference (General/Style/Interactions), corrected Display and Direction field options, Variables Manager access path, clamp() in variables, Class Manager with 4 states, default 10px padding note
- references/classes.md: multiple properties per class explained, 4 states (Normal/Hover/Focus/Active), recommended starting sets, guide for how many classes and variables to create, step-by-step creation instructions, clamp() patterns
- references/patterns.md: hero section, two-column layout, image frame, step header, alternating backgrounds, centered text, horizontal divider — all using correct V4 Direction labels (Row/Column)
- references/snippets.md: organizational guide — what each snippet type does, location rules, naming conventions, what each must never contain (no implementation code)
- references/troubleshooting.md: layout, spacing, typography, dark mode, interactions, custom code
- README.md: install instructions, comparison table, contributing guide
- CHANGELOG.md
```

## File: LICENSE
size: 1070
sha: 8b50eae817766f1960e0eaf883fa1d1ab01ef453
upstream: https://github.com/jainshwetank/elementor-pro-designer-skill/blob/HEAD/LICENSE

```text
MIT License

Copyright (c) 2026 Shwetank Jain

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```
