# Select Svg Icon

> Choose and validate SVG icons for pyRevit extension commands. Use when creating or updating a pyRevit pushbutton and you need an SVG-only icon workflow with automated acquisition from svgrepo.com first, manual fallback on svgfind.com, and vision-based semantic ranking before finalizing icon assets.

- Skill: `oriashkenazi/select-svg-icon` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add oriashkenazi/select-svg-icon`
- Raw SKILL.md: https://api.skillmd.com/api/skills/oriashkenazi/select-svg-icon/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: oriashkenazi (https://skillmd.com/u/oriashkenazi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/oriashkenazi/select-svg-icon

---


# Select SVG Icon

Use this skill to pick an icon that matches a pyRevit command's behavior, not just its name.

## SVG-Only Policy

- Acquire source assets as `.svg` only.
- Reject PNG-only sources during acquisition.
- Generate `icon.png` only in the finalization step for pyRevit compatibility.

## Workflow

1. Read the target command script and capture an intent brief:
- Primary verb (`select`, `align`, `export`, `delete`).
- Primary object (`walls`, `views`, `parameters`, `sheets`).
- Risk level (`safe`, `warning`, `destructive`).
- User context (`single element`, `batch`, `analysis`, `settings`).

2. Build 3-6 SVG search queries from the brief.
- Start with `verb noun`.
- Add one domain synonym.
- Add one metaphor fallback only if literal matches are weak.

3. Collect 3-5 candidate SVG icons with ordered sources.
- Keep candidate downloads and previews under `tmp/icons/<command-name>/`.
- Record each source URL and license note.
- Run `scripts/acquire_svgrepo_svg.py --command-id <command-name> -q "<query>" ...` first.
- Run `references/svgrepo_automated_acquisition.md` first.
- If automated acquisition yields fewer than 3 valid candidates, run `references/svgfind_acquisition.md` as manual fallback.

4. Run a vision pass before deciding.
- Compare candidates against the script intent and UI context.
- Score and rank with `references/icon_review_rubric.md`.
- Reject icons that imply the wrong action direction or risk level.
- If vision tools are unavailable, use candidate metadata as fallback and mark confidence as low.

5. Finalize for pyRevit.
- Save the selected icon to the command folder as `icon.png`.
- Generate `icon.png` from the selected SVG with `scripts/render_svg_icon_png.py`.
- Check legibility at `16px`, `24px`, and `32px` before finalizing.
- Keep rejected candidates in `tmp/` only.
- Add a one-line rationale in task/review notes to preserve intent for future changes.

## Use With Other Skills

- Pair with `develop-pyrevit-extensions` for command scaffolding and workflow docs.
- Pair with `pyrevit-revit-20xx` skills when API behavior affects icon semantics.

## Technical Reference

- Open `scripts/acquire_svgrepo_svg.py` for deterministic automated SVG acquisition.
- Open `scripts/render_svg_icon_png.py` to render final `icon.png` from SVG.
- Open `references/svgrepo_automated_acquisition.md` for the default automated acquisition path.
- Open `references/svgfind_acquisition.md` for the manual fallback path.
- Use `references/icon_review_rubric.md` after acquisition to rank candidates with vision.