106.9K+Download
Skip to the usage guide
Better Iconsby better-auth

Better Icons Skill.

Find an existing icon and retrieve its SVG by a verified library ID.

  • Icon Search
  • SVG
Download OpenDesignView Usage Guide
Source Review · better-iconsSKILL.md
Task Find an existing icon and retrieve its SVG by a verified library ID. Produces A shortlist of named icon IDs matched to the requested concepts. Before You Start This workflow retrieves library assets; it does not describe an original logo-design process.
Editorial summary · source reviewed 2026-11-02 · not a generated example

01 What It Does

Find an existing icon and retrieve its SVG by a verified library ID

Search Iconify collections, compare icon styles and retrieve SVG assets through the Better Icons CLI or MCP tools.

Source-based workflowNot an execution benchmark

The Working Approach

Better Icons gives an agent a concrete way to find and retrieve icons across Iconify collections. Search terms can be narrowed by a collection prefix, and each result has an explicit identifier such as lucide:home. The skill supports SVG retrieval with size and color options, which helps turn a vague request for an icon into a traceable asset choice.

The same capability is available through command-line operations and MCP tools. The MCP surface includes collection browsing, similar-icon lookup, recommendations, project scanning and synchronization. This is useful for building or cleaning up an interface where icons should come from a consistent family.

Expected Deliverables

  • A shortlist of named icon IDs matched to the requested concepts.
  • SVG assets retrieved at the requested size and color.
  • An icon mapping or project integration using the selected supported workflow.
See the Example Brief

From Brief to Review

  1. 01
    Define the icon family

    Inspect existing icon choices and identify the concepts that need representation. Choose a collection prefix when the design already has a consistent visual language.

  2. 02
    Search and compare

    Search by meaning and review returned IDs. The MCP tools can also browse collections, recommend icons for a use case or find similar marks across libraries.

  3. 03
    Retrieve the selected assets

    Fetch SVGs by their prefix:name identifiers. Set size and color deliberately, then save or synchronize only the selected icons into the intended project location.

02 When to Use It

When to Use It

This workflow retrieves library assets; it does not describe an original logo-design process.

A Good Fit

  • Interface icon selectionFind navigation, action or status icons that fit a chosen existing collection.
  • Icon consistency workInspect a project's icon usage and replace mismatched choices through a documented mapping.

Limits to Check

  • Existing artworkThis workflow retrieves library assets; it does not describe an original logo-design process.
  • Tool availabilityThe CLI or MCP integration must be available, and retrieval uses the Iconify API.

Bring These Inputs

  • ConceptsProvide the actions, destinations or statuses the icons need to represent.
  • Collection preferenceSpecify a prefix or an outline, solid or unrestricted style preference.
  • Output requirementsName the destination, dimensions, color and supported integration framework.

03 Decisions That Matter

Decisions That Matter

  1. Traceable selection

    Each chosen asset has a concrete prefix:name ID.

  2. Consistent retrieval

    Color and size can be specified when retrieving assets.

  3. Agent integration

    MCP tools cover search, batch retrieval and project icon scanning.

04 Try a Focused Brief

Try a Focused Brief

The example brief below has not been tested. Check the skill’s setup before using it.

Review the Source and Setup

Provide the actions, destinations or statuses the icons need to represent.

Upstream Source File
https://github.com/better-auth/better-icons/blob/033316ecb8f4982235af4111a2257e80231f5ab1/skills/SKILL.md

The reference below opens the upstream instructions. Review the repository setup before using them; it is not an installation command.

Start With One Deliverable

Adapt the scope, source material and constraints in this brief before running the skill.

Example Brief
Use better-icons to choose icons for our project navigation: overview, activity, members, billing and settings. Inspect the icon family already used in the repository before searching. Prefer matching outline icons from that collection and return the exact prefix:name ID for each choice. Retrieve the selected SVGs at 24 pixels with currentColor and place them in the scoped asset directory. Keep a mapping from navigation label to icon ID. Do not replace other icons or install a new application-wide icon system in this pass.

Inspect the Result

Check the actual output against these observable criteria.

  • Every chosen icon ID resolves to the expected SVG.
  • The set has consistent visual style, size and color handling.
  • Only the agreed assets and integration files have changed.

OpenDesign provides a local design workspace for coding agents. This listing does not mean the skill is bundled or that its external tools, credentials and software dependencies are included.

Download OpenDesignRead the Quickstart

05 Source and License

Source and License

This page describes the pinned source revision linked below. Upstream behavior and requirements can change.

Source Owner
better-auth
Repository
better-auth/better-icons
Skill File
SKILL.md
License
MIT
Reviewed Snapshot
2026-11-02 · 033316ecb8f4

Reading Notes

  1. License ScopePinned repository LICENSE text verified; complete archive filename inventory found no more-specific LICENSE/COPYING/NOTICE file under this skill path. Classification is for the reviewed upstream source, not generated output or third-party dependencies. Retrieved icon collections can have their own licenses; this repository's MIT declaration does not establish the license of every icon returned by Iconify.
Editorial Source Summary
Find an existing icon and retrieve its SVG by a verified library ID.

Original summary by OpenDesign, based on the linked source. Repository stars are a dated popularity signal, not skill usage or a quality score.

06 Questions Before You Start

Questions Before You Start

How are icons identified?

The format is prefix:name, combining a collection identifier with an icon name.

Can it retrieve several icons?

Yes. The CLI can download search results as SVGs, while the documented MCP get_icons operation accepts up to 20 icon IDs per request. Select and check the IDs before fetching a batch so a broad search does not add unwanted assets.

Is MCP required?

No. The source also documents command-line search and retrieval with npm or Bun execution options.

OpenDesign

Keep Your Brief and Design Work Together.

Keep your brief, source material and design work together in a local workspace. Check the skill’s own setup before adding it to your workflow.

Download OpenDesignBrowse Design Skills
Upstream Source File
https://github.com/better-auth/better-icons/blob/033316ecb8f4982235af4111a2257e80231f5ab1/skills/SKILL.md