- Home
- Skills
- Frontend & Web Apps
- Make Icons Fit the Type Beside Them
More screenshots
Works with the AI Agents you already use
Make Icons Fit the Type Beside Them
Icons can feel too light, too large or simply unrelated to the text beside them. This skill helps your agent choose a compatible icon style, measure SVG stroke and size, and report what needs changing.
$6.99
Make Icons Fit the Type Beside Them
Example session with this skill installed
Example request
Tidewell is a small budgeting web app (fictional). Body and labels are set in Inter, 16 px on a 24 px line height, regular for body and semibold (600) for button labels. We need icons for four menu rows (Overview, Transactions, Budgets, Settings) and one warning icon beside an error message. Pick a free icon set and give me stroke, size and alignment values I can paste into CSS. Free sets only, and tell me what I must check about the licence.
- Read your context and instructions
- Compiled the make icons fit
Example output (fictional brand "Tidewell")
Icon pass
Typeface
Inter (neutral grotesque); terminals flat, corners square with a slight softening, stroke contrast very low (near monoline), generous counters, normal proportions. Cap height about 0.73 em and x-height about 0.55 em (published Inter metrics; confirm against your font file). At 16 px: cap height about 11.6 px, x-height about 8.7 px.
Shortlist
Lucide (monoline, plain, even stroke, close to a neutral grotesque) and
Tabler Icons (same family of construction, a little more technical). Chosen:
Lucide, outline style, because its even stroke and plain corners match Inter's low contrast and Tabler's extra detail adds nothing here.
| Text role | Text size / weight | Icon size | Stroke (rendered) | stroke-width attribute | Alignment | Notes |
|---|---|---|---|---|---|---|
| Menu row | 16 / 400 | 20 px | 1.5 px | 1.8 | centred on the cap band, then check | gap 8 px (0.5 em) |
| Button label | 16 / 600 | 20 px | 2 px | 2.4 | same | outline stays outline; no filled icons in buttons |
| Error message | 14 / 400 | 16 px | 1.25 px | 1.875 | same | the warning icon is paired with the words, not colour alone |
Working for the attributes (Lucide draws on a 24 px grid): attribute = target x 24 / size. Menu row: 1.5 x 24 / 20 = 1.8. Button: 2 x 24 / 20 = 2.4. Error: 1.25 x 24 / 16 = 1.875. Check: 1.8 x 20 / 24 = 1.5. OK.
Size choice: the 16 px body text takes a 16 to 20 px icon, so 20 px (1.25 times the font size). That is about 1.7 times the cap height (20 / 11.6), taller than the 1 to 1.25 times cap-height guideline, so judge it by eye: if the icons look heavy next to the text, try 18 px and recompute the attribute (1.5 x 24 / 18 = 2.0).
.nav-row { display: flex; align-items: center; gap: 8px; line-height: 24px; }
.nav-row svg { width: 20px; height: 20px; stroke: currentColor; stroke-width: 1.8; fill: none; }
.btn svg { stroke-width: 2.4; }
Icon checks
- One family and style: PASS (Lucide outline everywhere).
- Stroke matches stem weight: PASS by method (1.5 px regular, 2 px semibold); verify beside real text at 100 percent zoom.
- Size per role set: PASS (20, 20, 16).
- Centred on cap band: NOT CHECKED in this written example: no screenshot was rendered. Do it before shipping.
- Smallest size legible (16 px warning): NOT CHECKED, same reason.
- 3:1 contrast: icons use
currentColor, so they inherit the text colour; they pass wherever the text passes 4.5:1. - Licence: Lucide, ISC (some icons MIT, derived from Feather), https://github.com/lucide-icons/lucide/blob/main/LICENSE, read on 8 Nov 2026.
Check before use: confirm the licence and keep the licence text in your repository or about page.
Connects securely to your tools. The creator never sees your data.
About this skill
Icons can feel too light, too large or simply unrelated to the text beside them. This skill helps your agent choose a compatible icon style, measure SVG stroke and size, and report what needs changing.
The proof
These are real outputs saved in the package.
From sample/balanced-output.txt:
PASS | stroke | 1.46px; target 1.44px
PASS | size | 20.0px; 1.25x text size
SUMMARY: PASS | 2 PASS | 0 WARN | 0 FAIL
From sample/light-output.txt:
FAIL | stroke | 0.33px; target 1.44px | FIX: set stroke-width to 2.16 (renders at 1.44px)
PASS | size | 16.0px; 1.00x text size
SUMMARY: FAIL | 1 PASS | 0 WARN | 1 FAIL
From sample/oversize-output.txt:
WARN | stroke | 1.75px; target 1.44px | FIX: set stroke-width to 1.23 (renders at 1.44px)
FAIL | size | 28.0px; 1.75x text size | FIX: render the icon between 11.2px and 20.0px; try 20.0px
SUMMARY: FAIL | 0 PASS | 1 WARN | 1 FAIL
What you get
SKILL.md: a typeface-to-icon workflow for Claude Code and OpenAI Codex.scripts/pair_check.py: the standard-library SVG measurement script.sample/: balanced, light and oversize icons with saved reports.tests/: pytest coverage for SVG parsing, thresholds, fixes and the command line.example-task.mdandexample-output.md: a worked pairing with CSS values.- A shortlist method, licence reminders and an icon review contract.
How to use
- Describe the typeface construction and read its real metrics.
- Shortlist compatible icon families and compare the same icons beside real text.
- Run
python scripts/pair_check.py --svg ICON.svg --font-weight 400 --font-size 16. - Apply the printed stroke or size fix, then rerun the check.
- Inspect alignment and legibility at the final display size.
Known limitations
- The stem table contains general estimates. It does not read a font file.
- The script measures SVG stroke and size. It does not judge visual taste.
- Alignment, blur and legibility still need a screenshot at the intended size.
- Licence names can change. Read the current licence before using an icon set.
FAQ
Does it choose the perfect icon set? No. It narrows the choice and measures two properties. You make the visual decision.
Which agents does it work with? It is a SKILL.md skill for Claude Code and OpenAI Codex. The script can also run by hand.
What does the script read? It reads an SVG viewBox, rendered dimensions and a single stroke width.
Does it download icons or fonts? No. It measures the SVG file you provide.
Does it send anything anywhere? No. It runs locally and prints a report.
Does not support script or pixel typefaces. Relies on stem weight estimates that require manual visual confirmation. License data is based on 8 Nov 2026 records.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 5 days ago
Requires