add-vector-icon
/add-vector-icon
Automates adding and updating Chromium .icon vector icon files from Google Symbols (GM3) or custom single-path SVGs. Trigger this skill whenever asked to add, create, import, or update a .icon file, register a vector icon in BUILD.gn (aggregate_vector_icons), or convert a Material Symbol / GM3 or custom SVG icon into a Chromium kFooIcon / kFooCustomIcon vector icon.
- Author
- chromium ↗
- Repository
- chromium ↗
- Licence
- BSD-3-Clause
- Last repository change
- 13.11.2026
Assessment and security
- Files in this package
- 7
- Scripts
- 5
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 13.11.2026, without references to retired models or APIs.
BSD-3-Clause, otwarta.
- 5 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/fetch_icon.py, scripts/fetch_icon_unittest.py, scripts/skiafy.py, scripts/svg_optimizer.py, scripts/svg_resizer.py
What it does and when to use it
Automates adding and updating Chromium .icon vector icon files from Google Symbols (GM3) or custom single-path SVGs. Trigger this skill whenever asked to add, create, import, or update a .icon file, register a vector icon in BUILD.gn (aggregate_vector_icons), or convert a Material Symbol / GM3 or custom SVG icon into a Chromium kFooIcon / kFooCustomIcon vector icon.
Original author description
Automates adding and updating Chromium .icon vector icon files from Google Symbols (GM3) or custom single-path SVGs. Trigger this skill whenever asked to add, create, import, or update a .icon file, register a vector icon in BUILD.gn (aggregate_vector_icons), or convert a Material Symbol / GM3 or custom SVG icon into a Chromium kFooIcon / kFooCustomIcon vector icon.
How it works
- Step 1: Analyze Call Sites and Existing Icons
- Step 2: Fetch and Convert to .icon
- Last Resort: Custom (Non-GM3) Icons
- Step 3: Register in BUILD.gn and Verify
SKILL.md preview
---
name: add-vector-icon
description: >-
Automates adding and updating Chromium .icon vector icon files from Google
Symbols (GM3) or custom single-path SVGs. Trigger this skill whenever asked
to add, create, import, or update a .icon file, register a vector icon in
BUILD.gn (aggregate_vector_icons), or convert a Material Symbol / GM3 or
custom SVG icon into a Chromium kFooIcon / kFooCustomIcon vector icon.
---
# Adding Chromium `.icon` Vector Icons
Automate fetching, converting, combining sizes, and registering `.icon` files in
Chromium using the bundled self-contained converter script
([fetch_icon.py](scripts/fetch_icon.py)).
All GM3 / Google Symbols icons in Chrome Desktop Views **must** use **100 ROND
(`rond100`, Rounded)** and **400 weight** at the required optical/canvas size
(`16px`, `20px`, or `24px`), in either **Outlined** or **Filled** (`--fill`)
style (`go/chrome-gm3-icons`).
> [!IMPORTANT] **Default to the GM3 library (`--icon`).** Almost all icons in
> Chromium come from the Google Material 3 (Google Symbols) library. Custom
> (non-GM3) icons are a **last resort** for very limited cases and must be
> **explicitly stated by the user** with a user-provided SVG — never infer that
> an icon is custom or invent SVG path data on your own.
______________________________________________________________________
## Step 1: Analyze Call Sites and Existing Icons
Before generating a new `.icon` file, inspect the CL / C++ call sites and check
for pre-existing icons:
1. **Determine All Required Icon Sizes (`16`, `20`, `24`):**
- Search the CL / target files for references to the icon constant (e.g.
`kFooBarIcon`) in calls such as:
- `ui::ImageModel::FromVectorIcon(kFooBarIcon, color_id, icon_size)`
- `gfx::CreateVectorIcon(kFooBarIcon, size, color)`
- `views::ImageView` / `VectorIconModel` / menu item icon helpers
- **Single size:** If the icon is used at a single DIP size (e.g. `20`),
include only that size (`--sizes 20`). If no explicit size argument is
passed at the call site, check the default icon size of that UI surface or
neighboring `.icon` files (typically `20` or `16` in desktop Chrome UI).
- **Multiple sizes:** If the icon is used at multiple sizes across the CL
(for example, `16` in a menu item and `20` in a toolbar button), pass **all
relevant sizes** (`--sizes 20 16`). The script outputs them in strictly
descending order (`CANVAS_DIMENSIONS, 20,` followed by
`CANVAS_DIMENSIONS, 16,`), as required by
`//components/vector_icons/aggregate_vector_icons.py`.
2. **Determine Style (`Outlined` vs. `Filled`) & Filename:**
- The `.icon` filename maps directly to the generated C++ identifier:
`foo_bar.icon` -> `kFooBarIcon`.
- Use the canonical Google Symbols icon identifier (verified against
`//tools/resources/icon_checker/icon_list.json`) as the base filename (e.g.
`account_circle` -> `account_circle.icon`).
- For filled variants (`--fill`), Chromium convention appends `_filled` to
the filename: `account_circle_filled.icon` -> `kAccountCircleFilledIcon`.
- **If the icon name is not in `icon_list.json`:** First search
`//tools/resources/icon_checker/icon_list.json` for a matching GM3 symbol
name (call sites sometimes use outdated Material 2 names). Only if the user
**explicitly states** the icon is custom and provides an SVG should you
follow the [Custom (Non-GM3) Icons](#last-resort-custom-non-gm3-icons)
section below and append `_custom` to the filename
(`<icon_name>_custom.icon` -> `k<IconName>CustomIcon`). Otherwise, ask the
user to confirm the GM3 icon name or provide the custom SVG.
3. **Check for a Pre-existing Icon with the Same Name and Size (Reuse First):**
- Before creating a new `.icon` file, search the repository for an existing
`<icon_name>.icon` (or `<icon_name>_filled.icon` /
`<icon_name>_custom.icon`), especially in `//components/vector_icons/`,
`//ui/views/vector_icons/`, `//chrome/app/vector_icons/`, and
`//ash/resources/vector_icons/`.
- **Same name + required size already exists:** Reuse the existing icon
constant (e.g. `vector_icons::kFooBarIcon` from
`//components/vector_icons/`) rather than adding a duplicate `.icon` file.
- **Same name exists in target directory, but missing required size:**
Generate only the missing size block with `fetch_icon.py` and splice it
into the existing `.icon` file in descending `CANVAS_DIMENSIONS` order so
you **preserve the original copyright year, any `FLIPS_IN_RTL` directives,
and all existing `CANVAS_DIMENSIONS` blocks**.
4. **Choose the Target `vector_icons` Directory (Default to
`//components/vector_icons/`):**
- **Default (`//components/vector_icons/`):** Skew toward placing new icons
in `//components/vector_icons/` by default. This is the most common target
directory and provides maximum reusability across Chromium components and
platforms.
- **Subsystem-specific exceptions:** Only place an icon in a narrower
directory when it is specifically tied to that layer or subsystem:
- `//chrome/app/vector_icons/` for icons exclusively tied to `chrome/app` /
desktop Chrome browser UI.
- `//ash/resources/vector_icons/` for ChromeOS Ash-specific icons.
- `//ui/views/vector_icons/` for core Views framework internals.
- `//components/omnibox/browser/vector_icons/` for omnibox-only icons.
- **Trademarked / branded logos:** Place Google-branded logos in
`//components/vector_icons/google_chrome/` with a Chromium counterpart in
`//components/vector_icons/chromium/`.
______________________________________________________________________
## Step 2: Fetch and Convert to `.icon`
Run [fetch_icon.py](scripts/fetch_icon.py) with `--icon` to download the Google
Symbols SVG (enforcing **100 ROND** and **400 weight**) and print the converted
`CANVAS_DIMENSIONS` block(s) to stdout:
- **`24px`**: Fetches `<icon>/rond100/24px.svg` (or
`<icon>/fill1rond100/24px.svg` with `--fill`).
- **`20px`**: Fetches `<icon>/rond100/20px.svg` (or
`<icon>/fill1rond100/20px.svg` with `--fill`).
- **`16px`**: Fetches `<icon>/wght500rond100/20px.svg` (or
`<icon>/wght500fill1rond100/20px.svg` with `--fill`) and scales from
`viewBox="0 -960 960 960"` to `16x16` (`16/20 == 400/500`, preserving the 400
stroke weight at 16px).
```bash
# Single size (e.g. 20px outlined icon):
python3 agents/skills/add-vector-icon/scripts/fetch_icon.py \
--icon "<gm3_icon_name>" \
--sizes 20
# Multiple sizes (e.g. used at both 20px and 16px in the CL):
python3 agents/skills/add-vector-icon/scripts/fetch_icon.py \
--icon "<gm3_icon_name>" \
--sizes 20 16
# Filled variant (e.g. 24px filled icon):
python3 agents/skills/add-vector-icon/scripts/fetch_icon.py \
--icon "<gm3_icon_name>" \
--fill \
--sizes 24
```
Write the resulting output into the target `.icon` file (e.g.
`components/vector_icons/<gm3_icon_name>.icon`) with a single Chromium BSD
copyright header at the top (or splice the new size block into an existing
`.icon` file in descending size order).
______________________________________________________________________
## Last Resort: Custom (Non-GM3) Icons
Use this path **only** when the user explicitly states that the icon is a custom
(non-GM3) icon and provides the custom SVG (either as a local `.svg` file path
or as raw `<svg>` markup in the prompt, which you can write to a temporary file
to pass to `--svg`). Never guess or synthesize custom SVG geometry yourself.
1. **Filename must end with `_custom.icon`:**
- Append `_custom` to the `.icon` filename: `<icon_name>_custom.icon` ->
`k<IconName>CustomIcon`.
- This is required by `go/chrome-icon-modernization-dd` and
`//tools/resources/icon_checker/icon_checker.py` to explicitly identify
icons that are not part of `go/icons` and exclude them from bulk GM3
updates. (Note: `icon_checker.py` will still emit a presubmit warning when
the base name before `_custom` is not in `icon_list.json`, noting *"If this
icon is intended to be custom please disregard this warning."*)
2. **SVG must contain only a single filled `<path>`:**
- `fetch_icon.py` intentionally **only** supports `<path>` and rejects all
other SVG primitives (`<circle>`, `<rect>`, `<ellipse>`, `<line>`,
`<polyline>`, `<polygon>`, `<g>`, or multiple `<path>` elements).
- The `viewBox` (or `width` x `height`) must be **square**, since Chromium
`.icon` canvases are square.
- `transform` and `stroke` (other than `stroke="none"`) are rejected. Ask the
user to flatten transforms and convert strokes to filled outlines.
- Arc path commands (`A`/`a`) are **not supported**. Ask the user to convert
arcs to cubic curves (common when circles or rounded rects are flattened
into a single path).
- `fill-rule="evenodd"` is honored by omitting `FILL_RULE_NONZERO` (the
`.icon` default is even-odd).
3. **Use a single custom canvas size (never use raw `960` viewBox sizes):**
- `--svg` accepts only **one** `--sizes` value. `PaintVectorIcon` scales a
single vector representation at runtime, and
`//components/vector_icons/README.md` says not to add sizes that are scaled
copies of one another. Only add another `CANVAS_DIMENSIONS` block if the
user provides a separate optical-size SVG for it (convert each SVG
separately and splice the blocks in descending order).
- Custom icons may use DIP dimensions other than `16`, `20`, or `24` (e.g.
`13`, `14`, `18`, `32`), but they must still be valid Chromium DIP icon
sizes (`<= 64`).
- If no size is specified by the user or at the C++ call site, inspect the
SVG's `width` and `viewBox`. **Do not** use a large SVG coordinate space
(such as `960` from `viewBox="0 -960 960 960"`) as `CANVAS_DIMENSIONS` —
`960` is an unscaled coordinate box and is far too big to use as a DIP icon
size in Chromium (`fetch_icon.py` rejects custom sizes `> 64`).
- When the SVG only specifies a large `viewBox` (like `960`) and the call
site does not specify a DIP size, **double-check with the user** (or verify
the surrounding UI surface's default icon size, typically `20` or `16`) and
pass `--sizes <size>` explicitly:
```bash
# Convert at an explicit custom DIP size (e.g. 18px):
python3 agents/skills/add-vector-icon/scripts/fetch_icon.py \
--svg /path/to/custom_icon.svg \
--sizes 18
# Convert at the SVG's own width/viewBox size (only when <= 64 DIP):
python3 agents/skills/add-vector-icon/scripts/fetch_icon.py \
--svg /path/to/custom_icon.svg
```
______________________________________________________________________
## Step 3: Register in `BUILD.gn` and Verify
1. **Register the `.icon` file in `BUILD.gn`:**
- Open the corresponding `BUILD.gn` file (either in the same directory, such
as `//components/vector_icons/BUILD.gn` or
`//chrome/app/vector_icons/BUILD.gn`, or in the parent directory when
`icon_directory = "vector_icons"`, such as `//ui/views/BUILD.gn`).
- Add the `.icon` path (relative to `icon_directory`) in alphabetical order
inside the `aggregate_vector_icons` `sources` array, keeping it within any
`# go/keep-sorted` block or platform/branding conditionals
(`is_chrome_branded`, `is_mac`, etc.).
2. **Inspect the generated `.icon` file:**
- Starts with a single Chromium BSD copyright header.
- Contains `CANVAS_DIMENSIONS, <size>,` blocks in **strictly descending
order** of size (`24` -> `20` -> `16`).
- Ends cleanly with `CLOSE` (no trailing comma).
3. **Compile check (optional):**
- Build the corresponding vector icons target (e.g.
`autoninja -C out/Default components/vector_icons` or
`chrome/app/vector_icons`) to verify `aggregate_vector_icons.py` compiles
the new `.icon` file into `$target_gen_dir/vector_icons.h` / `.cc` without
errors.
Files in this package (7)
- OWNERS 1 KB
- SKILL.md 12 KB
- scripts/fetch_icon.py 6 KB
- scripts/fetch_icon_unittest.py 13 KB
- scripts/skiafy.py 3 KB
- scripts/svg_optimizer.py 23 KB
- scripts/svg_resizer.py 15 KB
Versions
The database has no other skills named add-vector-icon.
Database snapshot: 13.11.2026 · package version fb14b132d015 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100svg-icon-generator
Generate svg icon generator operations. Auto-activating skill for Visual Content. Triggers on: svg icon generator, svg icon generator Part of the Visual Content skill category. Use when working with svg icon generator functionality. Trigger with phrases like "svg icon… - 95custom-icons
Create or refine custom icon assets as native or traced SVGs and transparent PNG/WebP files. Use when the user asks for a bespoke icon or cohesive icon set, wants an image traced into a clean vector, or needs a detailed or 3D icon with transparency. - 90icon-system-builder
Build an icon system in Figma — a dedicated "Icons" page of well-named, scalable icon components from Lucide, Tabler, Phosphor, Material, or custom SVGs. Use this when the user wants to set up icons, add an icon library, import Lucide or Material icons, create icon components,… - 100ink
Generating SVG icons/illustrations, designing icon systems, and constructing sprite symbols. Use when vector assets are needed. - 100add-icon
Add or update supported language, framework, library, tool, or platform icons in Socialify. Use when a request involves adding a new icon/logo, mapping a display name to a Simple Icons entry or a custom icon, and updating the language options list used in the UI. - 100icon-ops
Source, vet, normalize and ship SVG icons for web UI - set selection, licence and trademark traps, currentColor theming, sprite/inline delivery, and accessibility. Triggers on: icon, icons, svg icon, find an icon, add an icon, icon set, icon library, iconify, lucide, heroicons,…