Icons8 — Agent Skills

Ten Agent Skills that give coding agents taste, first when picking Icons8 artwork and then when looking at what they built with it. icons8 and ouch keep a project on one consistent set instead of a pile of mismatched pieces; the seven that follow check the finished screen and fix what they find from the same catalogue. illustration-animator turns static SVG illustrations into looped Lottie animations.

Ships as a Claude Code plugin that bundles the Icons8 MCP server (420,000+ icons across 132 styles). Installing it is the whole setup: sign in through the browser once on first use, and search and high-res PNG are free from there. No API key to paste.

Why

The MCP server is a thin wrapper over the Icons8 search API. It gives an agent a handful of tools and no judgement, and the default behaviour fails in three specific ways:

1. Unfiltered search returns one metaphor in ten styles. Asking for delete twelve times returns the same trash can in twelve different packs — one idea, no alternatives, and whatever gets picked won’t match the icon picked five minutes earlier.
2. Ranking is not taste-ranking. settings puts four Apple logos above the plain gear; dashboard puts a car dashboard gauge first. The API matches names and tags — it doesn’t know you’re building a settings screen.
3. SVG is the slow, paid path. One call per icon, and payloads run from 600 characters to 46,000. PNG previews are free, instant, and need no MCP call at all.

The skill fixes all three: it lists every concept a screen needs before searching, picks one pack for the whole project and locks it in icons8.json, filters every search by that pack so results are ten different metaphors instead of ten styles of one, rejects the brand logos and machine parts that search ranks first, previews on a free PNG contact sheet, and fetches SVG only for the approved final set.

Examples

Ask in plain words. The skills trigger by intent, so you do not have to name them.

• “Add icons to this dashboard, one consistent Icons8 set, 24px.”
• “Illustrate the empty states with one Ouch! style.”
• “Put an animated illustration in the hero of this landing page.”
• “Check this screen: emoji icons, missing images, contrast.”
• “Review the button labels and error messages on this signup form.”
• “Animate the illustrations in styles/little: looped Lottie and MP4.”

Install

Claude Code

/plugin marketplace add icons8/agent-skills
/plugin install icons8@icons8

That registers both the skill and the Icons8 MCP server. Approve the server on first use, sign in when the browser opens, and start asking for icons. /mcp signs in again later if you need it.

OpenAI Codex

codex plugin marketplace add icons8/agent-skills

Then install icons8 from the plugin browser (/plugins, or the Plugins section in the Codex app).