---
title: IconMuse for AI agents
description: The IconMuse skill detects a project's tech stack and installs or generates a native music-icon pack. Also covers llms.txt and Markdown pages for agents.
---

# IconMuse for AI agents

## The IconMuse skill

The skill lets coding agents such as Claude Code add IconMuse to any project. It detects the stack and then either installs the official package or generates a typed, framework-native icon pack.

**Supported stacks:** React, Next.js, React Native / Expo, Vue, Nuxt, Svelte / SvelteKit, Angular (with or without `@for`), Solid, Astro, vanilla HTML / Lit, Django, Flask, Rails, Laravel, PHP, Go, Flutter, Android / Compose, and iOS / macOS (SwiftUI, UIKit). It's also monorepo-aware.

### Install the skill

Download the skill into Claude Code's skills folder. These commands install it for every project:

```bash
mkdir -p ~/.claude/skills/iconmuse/scripts ~/.claude/skills/iconmuse/assets
cd ~/.claude/skills/iconmuse
curl -fsSL https://icons.chordmuse.app/skills/iconmuse/SKILL.md -o SKILL.md
curl -fsSL https://icons.chordmuse.app/skills/iconmuse/scripts/iconmuse.mjs -o scripts/iconmuse.mjs
curl -fsSL https://icons.chordmuse.app/skills/iconmuse/assets/icons.json -o assets/icons.json
```

To install it for one project only, use `<project>/.claude/skills/iconmuse` instead of `~/.claude/skills/iconmuse`.

Then ask, for example: *"Add IconMuse play, pause and volume icons to the player bar."*

Read the skill's instructions at [`https://icons.chordmuse.app/skills/iconmuse/SKILL.md`](https://icons.chordmuse.app/skills/iconmuse/SKILL.md).

### Run it directly

No agent is needed. It requires Node 18 or later.

```bash
npx iconmuse detect   --cwd my-app
npx iconmuse generate --cwd my-app --icons play,pause
npx iconmuse list     --search drum
```

## Machine-readable pages

| URL | Contents |
| --- | --- |
| `https://icons.chordmuse.app/llms.txt` | Index of everything below |
| `https://icons.chordmuse.app/llms-full.txt` | All guides plus the full icon list in one file |
| `https://icons.chordmuse.app/index.md` | The gallery page as Markdown |
| `https://icons.chordmuse.app/icons/<name>.md` | One page per icon, with SVG and usage on every platform |
| `https://icons.chordmuse.app/docs/*.md` | Platform guides |
| `https://icons.chordmuse.app/dist/icons.json` | All icon geometry |