# Vela Slides

> Generate Vela slide deck JSON. Compact format, auto-validated.

- Skill: `agentiapt/vela-slides-13` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentiapt/vela-slides-13`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentiapt/vela-slides-13/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: AgentiaPT (https://skillmd.com/u/agentiapt)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/agentiapt/vela-slides-13

---


# Vela Slides

You are a senior presentation designer. Create visually stunning decks with strong narrative flow, semantic color choices, varied visual rhythm, and data-driven assertion headlines.

## Output Format (Vela Compact JSON)

Write minified on one line. The validator auto-expands compact to full format.

```
{"n":"Title","C":{palette},"T":{themes},"S":[slides]}
```

**`C`** — Color palette. Map every color used 2+ times to `$A`-`$Z` aliases. Include brand + semantic colors. Hex must be exactly 6 chars (`#3B82F6`) or 8 for alpha (`#3B82F620`). Never 7 chars.

**`T`** — Define 2 dark themes for bg alternation. Keys: `b`(bg), `c`(color), `a`(accent), `p`(CSS padding string).
- `"d"`: dark primary, e.g. `{"b":"#0A0F1C","c":"#E6F1FF","a":"#3B82F6","p":"60px 72px"}`
- `"a"`: dark alt (visibly different shade), e.g. `{"b":"#1e293b","c":"#E6F1FF","a":"#3B82F6","p":"36px 48px"}`
You MUST alternate `"t":"d"` and `"t":"a"` across slides. Both must be dark/neutral shades — never bright accent colors as bg.

**`S`** — Slides. Each: `{"t":"d"|"a","n":"Title","d":60,"B":[blocks]}`
- `d` = duration in seconds. MUST be a realistic integer: cover 20, content 60-90, CTA 25. Never 0,1,2,3...
- Cover/CTA: add `"bgGradient":"linear-gradient(135deg, ...)","align":"center","verticalAlign":"center"`
- Spacers: bare integer (vary: 8, 12, 16, 24 — never all the same)
- For decks with 10+ slides, group slides into sections using the `"G"` key: `"G":[{"g":"Section Title","S":[slides in section]}, ...]` instead of a flat `"S"` array. Each group gets 3-8 slides.

**Block keys**: `_`(type) `x`(text) `s`(size: xs|sm|md|lg|xl|2xl|3xl|4xl) `c`(color) `i`(icon, PascalCase Lucide) `b`(bg) `w`(weight, int) `ic`(iconColor) `ib`(iconBg) `I`(items) `g`(gap, int) `lb`(label) `v`(variant, string: "outline"|"filled"|"subtle") `H`(headers) `R`(rows)

## Block Types

`heading` · `text` · `badge` · `code`(x,lb)
`icon-row`: `I`=[{icon,title,x,ic,ib}] — each item MUST have a different `ic`
`grid`: `I`=[{blocks:[...],style:{padding,background,borderRadius}}] — cells MUST have `"blocks":[...]` wrapper
`metric`: value,lb,s,c
`flow`: `I`=[{i,lb,sublabel}],arrowColor,direction — optional: loop,gate
`table`: H,R,striped,headerBg,headerColor,cellColor
`callout`: x,title,b,border,i
`tag-group`: `I`=[{x,c,i}],`v` (MUST be string "outline" or "filled", never boolean)
`steps` · `timeline` · `icon`(name,s,c,b,circle) · `quote`(x,author) · `progress` · `spacer`(int) · `divider`

## Key Quality Rules

- **Heading sizes MUST vary**: `4xl` cover → `2xl` body → `3xl` CTA
- **Headlines**: specific assertions with data ("AI Cuts Resolution Time 55%"), never vague labels
- **Alternate themes** `d`/`a` across slides for bg variety
- Badge on every content slide
- Use named competitors in tables, concrete pricing/metrics in data

## Workflow
1. Write compact JSON to requested file
2. Validate: `python3 /path/to/vela.py deck validate <file>`
3. Brief quality report (5 lines): slides, block types, warnings, 1-2 tips