---
name: sablier-icon
argument-hint: <color> [--flat] [--format png|jpg|ico] [--favicon]
description: This skill should be used when the user asks to "recolor the Sablier icon", "Sablier icon in orange", "Sablier logo in primary color", "generate Sablier hourglass variant", "change Sablier icon color", "export Sablier icon as PNG", or "generate Sablier favicon". Generates a gradient or flat Sablier icon SVG in any color using brand palette names, hex values, or CSS color names, with optional PNG/JPG/ICO raster export.
---

Recolor the Sablier icon SVG to a user-specified color with an analogous gradient, and optionally export to PNG, JPG, or ICO (favicon).

## Source

The base icon is at `assets/icon.svg` (relative to this skill directory). It is a two-path SVG with `viewBox="0 0 189.9 236.73"`
(aspect ratio ~0.802:1). Two CSS classes (`.cls-1`, `.cls-2`) reference two `<linearGradient>` elements in `<defs>`:

- `<linearGradient id="linear-gradient">` — contains two `<stop>` elements:
  - `offset="0"` → `stop-color="#f77423"` (top / darker)
  - `offset="1"` → `stop-color="#fbce5b"` (bottom / lighter)
- `<linearGradient id="linear-gradient-2">` — inherits stops from the first via `xlink:href="#linear-gradient"`

To recolor, replace the two `stop-color` values inside `<linearGradient id="linear-gradient">`. Always preserve the original
viewBox and aspect ratio — never add or change `width`/`height` attributes on the SVG.

A flat variant is at `assets/icon-white.svg` — a single-path SVG with `fill="white"` and `viewBox="0 0 386 480"` (aspect
ratio ~0.804:1). Used only when `--flat` is passed.

## Color Resolution

Resolve the user's color input using this priority (first match wins):

1. **Exact alias** — `primary`, `secondary`, `orange`, `blue` (see aliases in palette below)
2. **Exact palette name** — e.g. `primary-start`, `dark-300`, `gray-400`
3. **Raw hex** — accept `#RRGGBB` or `RRGGBB` (6-digit only, reject 3/8-digit). Normalize to lowercase `#rrggbb`
4. **CSS color name** — standard CSS named colors (e.g. `red`, `teal`, `cornflowerblue`)

If multiple palette entries match a prefix (e.g. `dark` matches `dark`, `dark-100`, `dark-300`), prefer the exact match.
If no exact match exists, ask the user to be more specific.

### Sablier Brand Palette

Source: [sablier-labs/branding](https://github.com/sablier-labs/branding)

| Name                  | Hex       | Notes                           |
| --------------------- | --------- | ------------------------------- |
| primary-start         | `#ff7300` | Orange gradient start           |
| primary-end           | `#ffb800` | Orange gradient end             |
| primary / orange      | `#ff9c00` | Median orange (default primary) |
| secondary-start       | `#003dff` | Blue gradient start             |
| secondary-end         | `#00b7ff` | Blue gradient end               |
| secondary / blue      | `#0063ff` | Median blue (default secondary) |
| secondary-desaturated | `#266cd9` | Desaturated blue                |
| dark                  | `#14161f` | Darkest background              |
| dark-100              | `#1e212f` | App background                  |
| dark-300              | `#2a2e41` | Card borders                    |
| dark-400              | `#30354a` | Input borders                   |
| gray-100              | `#e1e4ea` | Body text                       |
| gray-400              | `#8792ab` | Labels                          |
| red                   | `#e52e52` | Error / destructive             |
| white                 | `#ffffff` | Original icon color             |
| black                 | `#000000` | Pure black (rarely used)        |

## Gradient Generation

### Brand gradient pairs

Use these exact hex pairs — no computation needed:

| Alias            | Start (offset=0, top) | End (offset=1, bottom) |
| ---------------- | --------------------- | ---------------------- |
| primary / orange | `#f77423`             | `#fbce5b`              |
| secondary / blue | `#003dff`             | `#00b7ff`              |

When the user says "primary" or "orange", the output is identical to `icon.svg` (no stop-color changes needed).
When the user says "secondary" or "blue", replace the two stop-colors with the blue pair.

### Arbitrary colors — piecewise HSL algorithm

For any color not in the brand gradient pairs above, generate an analogous two-stop gradient:

1. Convert the resolved hex to HSL `(h, s%, l%)`
2. Branch by saturation:
   - **Achromatic** (`s < 10`): keep `s = 0` for both stops, vary only lightness
     - Start: `hsl(h, 0%, max(l - 8, 10)%)`
     - End: `hsl(h, 0%, min(l + 12, 90)%)`
   - **Chromatic** (`s >= 10`): keep hue constant, adjust lightness and gently reduce end saturation
     - Start: `hsl(h, s%, max(l - 8, 15)%)`
     - End: `hsl(h, floor(s * 0.9)%, min(l + 12, 88)%)`
3. Ensure `endL > startL` after clamps; if not, set `startL = endL - 10`
4. Convert both HSL values back to 6-digit lowercase hex

## SVG Generation

### Gradient mode (default)

1. Read `assets/icon.svg`
2. Resolve gradient start/end colors:
   - If the color matches a brand gradient pair alias, use the exact hex pair
   - Otherwise, apply the piecewise HSL algorithm
3. Find the two `<stop>` elements inside `<linearGradient id="linear-gradient">` and replace their `stop-color` values:
   - `offset="0"` → start hex
   - `offset="1"` → end hex
4. Structural checks:
   - Exactly two `stop-color` replacements occurred
   - `xlink:href="#linear-gradient"` on `linear-gradient-2` is still intact
   - `viewBox="0 0 189.9 236.73"` preserved, no `width`/`height` attributes added
5. Write to `sablier-icon-<color-name>.svg`

### Flat mode (`--flat` flag)

1. Read `assets/icon-white.svg`
2. Resolve the color to a single hex value:
   - If the color matches a brand gradient pair alias (`primary`, `secondary`), use the median palette hex (`#ff9c00`, `#0063ff`)
   - Otherwise, use the resolved hex directly
3. Replace `fill="white"` on the `<path>` element only — never touch `fill="none"` on the root `<svg>` element
4. Verify exactly one replacement occurred
5. Verify `viewBox="0 0 386 480"` preserved, no `width`/`height` attributes added
6. Write to `sablier-icon-<color-name>.svg`

### Filenames

Use the brand alias when matched by name (e.g. `primary`), otherwise strip the `#` prefix and lowercase the hex value
(e.g. `#E52E52` → `e52e52`). If the color cannot be resolved, ask the user to provide a valid hex code.

## PNG / JPG Export

If the user passes `--format png` or `--format jpg`:

1. Generate the recolored SVG first
2. Verify `rsvg-convert` is available: `command -v rsvg-convert >/dev/null 2>&1 || { echo "Error: rsvg-convert not found. Install with: brew install librsvg"; exit 1; }`
3. Use `rsvg-convert` for SVG→PNG (it correctly renders CSS gradients, unlike ImageMagick's SVG renderer which produces grayscale)
4. For JPG, convert the PNG with `magick` (verify availability: `command -v magick >/dev/null 2>&1`)

**Gradient mode** (from `icon.svg`, viewBox 189.9×236.73):

```bash
# PNG (transparent background, 1024px height, width auto-computed from aspect ratio ≈822px)
rsvg-convert -h 1024 "<input>.svg" -o "<output>.png"

# JPG (dark background since JPG has no transparency) — render PNG first, then convert
rsvg-convert -h 1024 "<input>.svg" -o "<output>.tmp.png"
magick "<output>.tmp.png" -background "#14161f" -flatten "<output>.jpg"
rm "<output>.tmp.png"
```

**Flat mode** (from `icon-white.svg`, viewBox 386×480):

```bash
# PNG (transparent background, explicit height, width auto-computed ≈824px)
rsvg-convert -h 1024 "<input>.svg" -o "<output>.png"

# JPG (dark background)
rsvg-convert -h 1024 "<input>.svg" -o "<output>.tmp.png"
magick "<output>.tmp.png" -background "#14161f" -flatten "<output>.jpg"
rm "<output>.tmp.png"
```

Verify the exported file's dimensions match the expected aspect ratio.

### ICO Export (`--format ico` or `--favicon`)

`--favicon` is a shorthand for `--format ico`. Both produce a multi-resolution `.ico` file containing 16x16, 32x32, and 48x48 embedded PNGs — the standard sizes for `favicon.ico`.

1. Generate the recolored SVG first
2. Verify `rsvg-convert` and `magick` are available (same checks as PNG/JPG)
3. Render intermediate PNGs at each favicon size using `rsvg-convert` (height-constrained to preserve aspect ratio), then center each on a square transparent canvas with `magick -extent`
4. Combine into a single `.ico` with `magick`
5. Clean up intermediate PNGs

```bash
# Render PNGs preserving aspect ratio (height-constrained), then center on square canvas
for size in 16 32 48; do
  rsvg-convert -h "$size" "<input>.svg" -o "<output>-${size}-raw.tmp.png"
  magick "<output>-${size}-raw.tmp.png" -background transparent -gravity center -extent "${size}x${size}" "<output>-${size}.tmp.png"
  rm "<output>-${size}-raw.tmp.png"
done

# Combine into multi-resolution ICO
magick "<output>-16.tmp.png" "<output>-32.tmp.png" "<output>-48.tmp.png" "<output>.ico"

# Clean up
rm "<output>-16.tmp.png" "<output>-32.tmp.png" "<output>-48.tmp.png"
```

The output filename follows the `sablier-icon-<color-name>.ico` pattern — or `favicon.ico` if the user explicitly requests that name.

The output filename follows the same `sablier-icon-<color-name>.<ext>` pattern for all other formats.

## Examples

- `primary` → `sablier-icon-primary.svg` with brand orange gradient (identical to `icon.svg`)
- `secondary` → `sablier-icon-secondary.svg` with blue gradient `#003dff` / `#00b7ff`
- `#e52e52` → `sablier-icon-e52e52.svg` with red gradient (piecewise HSL algorithm)
- `white` → `sablier-icon-white.svg` with achromatic subtle lightness gradient
- `#00d395 --flat` → `sablier-icon-00d395.svg` with flat `fill="#00d395"`
- `red --format jpg` → `sablier-icon-red.svg` + `sablier-icon-red.jpg`
- `secondary --format png` → `sablier-icon-secondary.svg` + `sablier-icon-secondary.png` (blue gradient + raster export)
- `primary --format ico` → `sablier-icon-primary.svg` + `sablier-icon-primary.ico` (multi-resolution 16/32/48px)
- `primary --favicon` → same as `--format ico`