Skip to main content
Glama
material-icons-agent-skill

material-icons-agent-skill

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

Version Agent Skills MCP License

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

NOTE

Version 0.1.0 — The kit is local-first: it uses official Google sources, does not overwrite assets by default, and requires explicit confirmation for destructive changes.


🔭 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

Goal

Command

📥 Install into detected clients

npm run setup

🔄 Refresh integrations after an update

npm run skill:update

🗑️ Remove integrations

npm run skill:remove

⌨️ Run the CLI

npm run cli -- <command>

✅ Run syntax checks

npm test

TIP

Run a command for one host:npm run setup -- --hosts Cursor Remove only one: npm run skill:remove -- --hosts Cursor For global access in Cursor, ChatGPT, and Claude Desktop → set up a global MCP server.


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

Available Tools

11 tools
audit_iconsC

Find duplicate and likely unused local Android/Flutter icon assets.

Inputs: root (required).

delete_iconC

Delete a computed local icon path. Requires explicit confirmation.

Inputs: name (required), root (required), target (required), confirm (required).

detect_project_environmentB

Detect Android Compose, Android Views, Flutter, and web evidence in a project.

Inputs: root (required).

generate_icon_wrappersB

OPTIONAL: generate Kotlin, Dart, or TypeScript icon constants. Enable this only in projects that want an AppIcons abstraction.

Inputs: root (required), names (required), output (required), target (required).

import_iconC

Download an official icon into Android, Flutter, or SVG project assets. Never overwrites files.

Inputs: name (required), root (required), target (required), style, +1 more.

migrate_compose_iconsB

Dry-run or apply standard Compose Icons.* to local painterResource replacements. Import drawables first; complex expressions are reported, never guessed.

Inputs: root (required), apply.

preview_iconsB

Create a local HTML preview sheet for a shortlist of icons.

Inputs: names (required), style, output.

search_iconsC

Search official Material Symbols by meaning and style.

Inputs: query (required), limit, style.

sync_offline_catalogC

OPTIONAL: write a project-local catalog of official icon names for offline or repeat lookup.

Inputs: root (required), refresh.

update_iconC

Explicitly re-download and replace an already imported local icon.

Inputs: name (required), root (required), target (required), confirm (required), +1 more.

validate_icon_usageC

Report likely missing accessibility labels for icon usage.

Inputs: root (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool targets a distinct operation: searching, importing, updating, deleting, auditing, validating, migrating, generating wrappers, syncing offline catalog, previewing, and detecting environment. Even similar tools like audit_icons and validate_icon_usage are clearly separated by their focus (duplicates/unused vs accessibility labels).

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case. Singular nouns are used for single-item operations (import_icon, delete_icon) and plural nouns for multi-item operations (search_icons, preview_icons), demonstrating a clear and predictable semantic convention.

    Tool Count5/5

    11 tools is well within the ideal range for a specialized icon management skill. Each tool serves a distinct purpose in the workflow, and none are redundant or extraneous, making the set well-scoped for its domain.

    Completeness5/5

    The tool surface covers the full lifecycle of icon management: search, import, update, delete, audit, validate, migrate, generate wrappers, offline catalog, preview, and environment detection. There are no obvious gaps or dead ends for the stated purpose of managing Material Icons in projects.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides access to over 200,000 icons from 150+ collections with features for searching, recommendations, and direct file synchronization. It supports multiple frameworks and optimizes AI performance by writing icon code directly to project files.
      1,352 npm
      1,471
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Visual icon search, retrieval, and comparison for AI agents. Search 200k+ icons semantically, render side-by-side comparison grids, and retrieve raw SVG markup — all tools return images so vision-capable LLMs can see the icons.
      1
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI coding tools to search, inspect, recommend, and export SVG icons from svgicons.com for use in design systems, frontend projects, and AI-assisted workflows.
      MIT