Agent skill · software engineering · sundial-org
sfsymbol-generator
Generate an Xcode SF Symbol asset catalog .symbolset from an SVG. Use when you need to add a custom SF Symbol (build-time) by creating the symbolset folder, Contents.json, and SVG file.
Why this skill is useful
Adds a script for generating SF Symbol asset catalogs from SVG files, which includes specific commands and workflows not commonly known.
What it needs
Requires bash installed locally. About 1k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
SF Symbol Generator Usage You can override the default asset catalog location with SFSYMBOLASSETSDIR. Raw symbolset (no template injection) symbol-name: Full symbol name (e.g., custom.logo, brand.icon.fill). svg-path: Path to the source SVG file. assets-dir (optional): Path to Assets.xcassets/Symbols (defaults to Assets.xcassets/Symbols or SFSYMBOLASSETSDIR). Template-based symbolset (recommended) template-svg (optional): SF Symbols template SVG to inject into (defaults to the first .symbolset SVG found in Assets.xcassets/Symbols, otherwise uses the bundled skill template). Example Requirements SVG must include a viewBox. Use path-based shapes (paths are required; rects are supported and converted, but other shapes should be converted to paths). Prefer filled shapes (no strokes) to avoid thin artifacts. Workflow 1. Validates the SVG path and viewBox. 2. Computes path bounds and centers within the SF Symbols template margins. 3. Injects the paths into the SF Symbols template (Ultralight/Regular/Black). 4. Creates <symbol-name>.symbolset inside the asset catalog Symbols folder. 5. Writes a matching Contents.json.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/sfsymbol-generator