| name | select-svg-icon |
| description | 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. |
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
- 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).
- 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.
- 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.
- 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.
- 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.
