icon-set-generator

Generate cohesive, project-specific SVG icon sets for websites and applications. Use this skill whenever the user needs custom icons, an icon set for a website…

INSTALLATION
npx skills add https://github.com/jezweb/claude-skills --skill icon-set-generator
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

$28

A brief like "plumber in Newcastle, modern feel" is enough to proceed. Don't over-interview.

Step 2: Suggest Icons

Read references/industry-icons.md for industry-specific suggestions. Organise into groups:

  • Navigation — menu, close, arrows, search
  • Communication — phone, email, location, clock
  • Trust — star, shield, award, users
  • Actions — download, share, calendar, form
  • Industry-Specific — icons unique to this business type

Present the list. Let the user add, remove, or rename before generating.

Step 3: Define the Style Spec

Read references/style-presets.md for full preset definitions. Pick one as starting point:

Preset

Best For

Stroke

Caps/Joins

Corners

Clean

Most business sites

1.5px

round/round

2px

Sharp

Corporate/technical

1.5px

square/miter

0px

Soft

Friendly/approachable

2px

round/round

4px

Minimal

Elegant/editorial

1px

round/round

0px

Bold

High impact/accessible

2.5px

round/round

2px

Tell the user which preset you're recommending and why, then confirm.

Step 4: Generate the Icons

Generate every icon following the SVG Rules below. Output to an icons/ directory in the project root (or the user's preferred location).

Read references/svg-examples.md before generating — it contains reference implementations showing the right level of complexity and how to handle common icon shapes.

Generate in batches of ~5. After each batch, visually review for consistency before continuing. After all icons are done, create the preview page and style-spec.json.

Step 5: Deliver

Output structure:

icons/

├── style-spec.json

├── preview.html

├── home.svg

├── phone.svg

└── ...

Present preview.html first so the user sees the complete set visually.

SVG Rules

Every icon in a set MUST follow all of these. Even small inconsistencies — a slightly different stroke width, a rounded corner where others are sharp — make the set look amateur.

SVG Template

Every icon uses this exact outer structure:

<svg xmlns="http://www.w3.org/2000/svg"

  width="{grid}" height="{grid}"

  viewBox="0 0 {grid} {grid}"

  fill="none"

  stroke="currentColor"

  stroke-width="{strokeWidth}"

  stroke-linecap="{strokeLinecap}"

  stroke-linejoin="{strokeLinejoin}">

  <!-- icon paths here -->

</svg>

Hard Rules

-

**currentColor only** — Never hardcode colours. SVGs inherit colour from CSS. No fill="#000" or stroke="blue". If a shape needs fill, use fill="currentColor".

-

Identical viewBox — Every icon uses the same viewBox. No exceptions.

-

Identical root stroke attributesstroke-width, stroke-linecap, stroke-linejoin on the <svg> element must match across all icons. Override on individual elements only when truly necessary.

-

No transforms on root — No translate, rotate, scale. Bake positioning into coordinates.

-

No IDs or classes — Keep SVGs clean for external styling.

-

Coordinate precision — Max 2 decimal places. Snap to half-pixel grid (e.g. 12, 12.5, not 12.333).

-

Consistent padding — Maintain configured padding from viewBox edge. For 24px grid with 2px padding, draw within 2–22 coordinate range.

-

Minimal elements — Fewest <path>, <circle>, <rect>, <line> elements practical. Simpler = smaller + faster rendering.

-

Visual centring — Appear visually centred, not just mathematically centred. A leftward arrow shifts slightly right. A house with a chimney adjusts for asymmetry.

Optical Corrections

Subtle but essential for professional results:

  • Curved stroke compensation: Curves appear thinner than straight lines at same stroke width. For primarily curved icons (phone, globe), make paths slightly larger rather than changing stroke width.
  • Pointed shape overshoot: Arrows, chevrons, triangles extend ~0.5px beyond where a square would stop to appear the same size.
  • Visual weight balancing: Simple icons (single chevron) look lighter than complex ones (gear). Make simpler icons slightly larger in the grid, or use slightly more substantial paths. No icon should look noticeably lighter or heavier than the others.

style-spec.json

{

  "name": "project-name-icons",

  "preset": "clean",

  "grid": 24,

  "strokeWidth": 1.5,

  "strokeLinecap": "round",

  "strokeLinejoin": "round",

  "cornerRadius": 2,

  "padding": 2,

  "opticalBalance": true,

  "iconCount": 20,

  "icons": ["home", "phone", "email"],

  "generated": "2026-02-15"

}

Preview Page

Generate a self-contained HTML file displaying all icons for visual review. Read references/preview-template.md for the template. Requirements:

  • Grid of all icons at native size (24px) with labels
  • Same grid at 2x (48px) for detail inspection
  • Dark background section (white on dark) for contrast check
  • Style spec summary at top
  • Inline CSS, no dependencies — just open in browser
  • Inline all SVGs directly into the HTML (don't reference external files)

Quality Checklist

Verify every item before delivering:

  • All SVGs have identical viewBox, stroke-width, stroke-linecap, stroke-linejoin
  • All SVGs use currentColor exclusively
  • Visual weight is balanced across the set
  • Padding is consistent (nothing touching viewBox edge)
  • All icons visually centred
  • Filenames are lowercase kebab-case (arrow-right.svg)
  • Preview HTML renders all icons correctly
  • style-spec.json is accurate and lists all icons

Reference Files

Read these before generating:

  • references/style-presets.md — Detailed preset definitions and selection guidance
  • references/industry-icons.md — Industry-specific icon suggestions
  • references/preview-template.md — HTML template for the preview page
  • references/svg-examples.md — Example SVGs showing proper construction at various complexity levels
BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card