Material Icons Agent Skill

One icon workflow for every AI coding agent.

Search, import, migrate, validate, and maintain official Google Material Symbolsacross Codex · Claude · Gemini · Antigravity · Cursor · Grok

Quick start · Documentation · Русский · MCP tools

🔭 How it works

  💬  User request
       ↓
  🧠  Agent Skill ──── understands intent, platform, style, states, accessibility
       ↓
  🔧  MCP + CLI ────── searches, imports, previews, migrates, audits, validates
       ↓
  📦  Project ───────── Android Compose · Android Views · Flutter · Web · React · Vue

Related MCP server: brain-mcp-icon-visual

⚡ Quick start

git clone <repository-url> material-icons-agent-skill
cd material-icons-agent-skill
npm install
npm run setup

Start a new agent chat after setup. For Claude App / Desktop / Cowork, upload the generated material-icons-claude-skill.zip in Customize → Skills → Create skill → Upload a skill.

🚀 Choose your entry point

Use $material-icons: choose a rounded save icon for an article and add it to my Android Views screen.

The agent reads the portable skill, detects your project environment, searches for the best icon, and imports it — all in one request.

npm run cli -- search "save article" --style rounded
npm run cli -- migrate-compose --root C:\path\to\project
npm run cli -- skill:update

npm start

The server exposes search, import, preview, audit, environment detection, Compose migration, accessibility validation, optional wrappers, and an optional offline catalog.

See the full MCP reference →

🧩 Command palette

📚 Documentation

🗂️ Repository map

skills/material-icons/     🧠  Portable skill and deterministic helpers
src/                        🔧  MCP server and CLI
integrations/               🔌  MCP and host templates
templates/                  🏗️  Opt-in CI template
docs/                       📚  English + Russian documentation

👤 Developer

Built and maintained by ByteFlipper (GitHub · Website · Telegram).

This project is intentionally local-first: the skill is portable, the MCP server runs over stdio, and destructive operations require explicit confirmation. See SECURITY.md for the operational boundaries.

📄 License

The kit is licensed under MIT. Google Material Symbols are provided separately under Apache-2.0; see google/material-design-icons.