More screenshots

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    Make Icons Fit the Type Beside Them

    1

    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

    Secure checkout via Stripe

    Money-back guarantee

    Converts to your local currency at checkout

    Security scanned
    Make Icons Fit the Type Beside Them

    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 roleText size / weightIcon sizeStroke (rendered)stroke-width attributeAlignmentNotes
    Menu row16 / 40020 px1.5 px1.8centred on the cap band, then checkgap 8 px (0.5 em)
    Button label16 / 60020 px2 px2.4sameoutline stays outline; no filled icons in buttons
    Error message14 / 40016 px1.25 px1.875samethe 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.md and example-output.md: a worked pairing with CSS values.
    • A shortlist method, licence reminders and an icon review contract.

    How to use

    1. Describe the typeface construction and read its real metrics.
    2. Shortlist compatible icon families and compare the same icons beside real text.
    3. Run python scripts/pair_check.py --svg ICON.svg --font-weight 400 --font-size 16.
    4. Apply the printed stroke or size fix, then rerun the check.
    5. 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. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 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

    Python

    Permissions

    Terminal / Shell
    Read Files
    Listed5 days ago

    What's inside

    Frequently Asked Questions

    It gives your agent a fixed routine: describe the typeface (class, terminals, corners, contrast, proportions), shortlist free icon sets with matching traits, then set stroke, size, alignment and gap. A script measures each SVG's rendered stroke and size, and the agent finishes with a pass/fail icon report. The final call is still made by eye beside the real font.

    SKILL.md (the pairing routine, a trait table, six free icon sets with their licence links, starting values and an output format), scripts/pair_check.py, three sample SVGs with saved reports, 12 pytest tests, a worked example, README, TESTING.md and CHANGELOG.md.

    The routine covers sans, serif, mono, script and display faces. The free icon sets fit sans and quiet serif text best; for serif-display, script or pixel typefaces the skill says no listed set is a close match and suggests a commercial set or custom icons.

    It is a SKILL.md skill, tested with Claude Code and OpenAI Codex. The script is standard-library Python 3 and only reads the SVG, so you can also run it by hand.

    A generic prompt picks a set by taste. This skill makes the agent write down the typeface's traits first, then measure: the script compares the rendered stroke with a stem estimate for the font weight (PASS within 0.20 px) and checks the icon is 0.70 to 1.25 times the text size, printing the exact stroke-width fix. The stem values are estimates, not readings of your font file, so confirm beside the real font.

    New in Frontend & Web Apps