laguagu/claude-code-nextjs-skills / skills/icons
icons
VerifiedSources icons, country flags, file-type marks and brand logos that fit the app's existing visual language. Use when adding an icon, finding an official logo, building a language switcher, or the project's icon library has no match. Covers Iconify and svgl; use frontend-design for overall visual direction and shadcn for general component installation.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.8 KB |
SKILL.md
View on GitHub---
name: icons
description: Sources icons, country flags, file-type marks and brand logos that fit the app's existing visual language. Use when adding an icon, finding an official logo, building a language switcher, or the project's icon library has no match. Covers Iconify and svgl; use frontend-design for overall visual direction and shadcn for general component installation.
license: MIT
---
# Source icons that fit
Reuse the project's icon family for ordinary UI glyphs. Choose a different source
when the mark represents a brand, country or file type, then check it in context.
## Where to look
| Need | Starting point |
|---|---|
| UI glyph | The project's existing library |
| Country flag | Iconify: `circle-flags`, `flag`, `flagpack`; `tabler-flags` is keyed by English country name (`tabler-flags:finland`) |
| Colour file-type mark | Iconify: `vscode-icons`, `catppuccin`, `material-icon-theme` |
| Colour brand logo or wordmark | svgl, including its light/dark variants |
| Monochrome brand logo | Iconify: `simple-icons` |
| Tech or infrastructure logo | Iconify: `logos`, `devicon`, `skill-icons` |
| A mark absent from catalogs | The organization's official brand assets |
| Custom glyph or spot illustration no catalog has | Generate it with an image model, through a media-generation skill when one is installed (SVG output where the model offers it) |
These are search starting points, not guaranteed coverage or blanket licences.
Check the selected set's licence in its own repository, not only in Iconify's
metadata, and check the brand's usage requirements. Do not invent a logo for a real
organization when an official asset is unavailable, and never generate one.
A generated SVG is a draft, and can come back as a filled shape when a line icon was
asked for: set its `viewBox`, stroke and `currentColor` to the family's grid and compare
it beside a catalog icon at 16–24 px before use.
## Iconify
Search at [Iconify's catalog](https://icon-sets.iconify.design/) or through its
[search API](https://iconify.design/docs/api/search.html). Results use
`prefix:name` identifiers; `prefixes` limits a query to selected sets. Fetch
individual SVGs through `https://api.iconify.design/{prefix}/{name}.svg` (the
identifier remains `prefix:name`).
The public API needs no key; `https://api.iconify.design/collections?prefixes=<sets>`
returns metadata and licences for comma-separated sets.
The public API rate-limits bursts of requests, so for more than a handful of
icons fetch per set, not per icon:
`https://api.iconify.design/<prefix>.json?icons=a,b` returns the named icons' SVG
bodies in one response (a requested alias comes back under `aliases` with its
`parent`, whose body is in `icons`), and
`https://cdn.jsdelivr.net/npm/@iconify-json/<prefix>/icons.json` is the whole set
from another host. A body is the inside of the element: wrap it in `<svg xmlns="http://www.w3.org/2000/svg" viewBox="{left} {top} {width} {height}">`,
each value from the icon when it has one, else from the set, else 0, 0, 16, 16.
The SVG flag sets `circle-flags`, `flagpack` and `flag` use lowercase ISO 3166-1
alpha-2 codes, and a country-name search does not find them (`finland` finds the
name-keyed `tabler-flags:finland` and emoji sets), so build the id
directly: `circle-flags:fi`, `flagpack:fi`; `flag` needs a ratio suffix (`flag:fi-4x3`, `flag:fi-1x1`), and
bare `flag:fi` is a 404. Use SVG flags rather than emoji: Windows' emoji font
has no flag glyphs and shows the letters (`FI`). For a language selector,
language names usually communicate the choice better than national flags.
Use local SVGs or build-time icon data by default. A string identifier passed to
`@iconify/react` can load missing data from the public API at runtime; merely
installing an icon-data package does not make that rendering offline. Pass or
register the data explicitly. See [React usage](https://iconify.design/docs/icon-components/react/)
for the project's chosen integration.
## svgl
Use [svgl's API docs](https://svgl.app/docs/api) to find exact titles, categories
and asset routes. The API base is `https://api.svgl.app` (no key). Its docs ask callers
to cache, and the API answers more than five requests in ten seconds from one IP with
a 429 and a three-minute lockout: the bare base returns the whole catalogue in one
response, which serves many lookups better than one search per logo. It
primarily holds software and brand marks, with some file marks such as `PDF`; use Iconify for flag families and consistent file-type sets.
`?search=` matches titles; a missing title returns "SVG not found". Browse
categories through `/categories` and use each name exactly as listed there
(`/category/AI`; `ai` is not found). Registry names are currently slugified
titles, not asset filenames (`Hugging Face` → `hugging-face`, `Next.js` → `nextjs`,
`shadcn/ui` → `shadcnui`); confirm with `https://svgl.app/r/<name>.json`
before adding. Entries may carry light/dark routes and a separate wordmark.
For a shadcn project, its
[registry guide](https://svgl.app/docs/shadcn-ui) defines the `@svgl` namespace
at `https://svgl.app/r/{name}.json`. Follow the project's package manager and
existing registry configuration. If shadcn is absent, use the raw asset rather
than initializing a component system just to add a logo.
## Without network
Iconify and svgl are online services. Offline, search the installed icon
library (for example `node_modules/lucide-react/dist/esm/icons/`) or any
installed `@iconify-json/<prefix>/icons.json`, and reuse assets already in the
repo. For a missing brand mark, ask for the official file or use a neutral
placeholder; do not draw one.
## Integration gotchas
- Match stroke/fill, optical size and alignment to surrounding UI. Lucide uses
a 24 px grid and 2 px stroke; Tabler and Hugeicons sit close, Material and
Carbon read thinner. Colour file-type marks carry their own padding and often
need one size step up. Mix by role when needed: one family for controls, one
set for flags, one for file types. Preserve brand colours where appropriate
rather than tinting every mark.
- Choose the variant for its actual background. Check dark and light surfaces
if both are supported.
- Inline SVG masks, gradients and clip paths need IDs unique per rendered
instance, with every reference updated. A brand-name suffix still collides
when the same logo appears twice.
- Iconify's `simple-icons` set keeps marks whose owners asked for removal as
`hidden: true` in its set JSON (LinkedIn, for example): they still download but are
missing from search. Take those from svgl or the brand's own assets.
- Put an accessible name on icon-only controls; hide decorative SVGs next to
equivalent text. A missing icon downloads as `Not found` text (Iconify) or
an HTML page (svgl), so check that each saved file starts with `<svg`, and
view the control at its displayed size.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |