К основному содержанию
скилл CX Codex

import-art — скилл для Claude Code: что делает и как установить

Скилл import-art копирует обложку музыкального альбома сразу в две папки проекта с нужными именами файлов. Помогает при подготовке релизов.

CC0-1.0 252 установок ★ 686 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add bitwize-music-studio/claude-ai-music-skills --skill import-art -a claude-code
Открыть на GitHub

Что делает import-art

Скилл принимает путь к файлу изображения и название альбома. Затем через вызовы MCP-инструмента bitwize-music-mcp (find_album и resolve_path) он ищет альбом по нечёткому совпадению и определяет целевые пути в каталогах музыки и контента.

Файл раскладывается в два места. Первый экземпляр отправляется в аудио-директорию с именем album.png для платформ и мастеринга. Второй копируется в папку документации как album-art.{ext} с сохранением оригинального расширения.

Для работы обязательно требуется настроенный MCP-сервер bitwize-music-mcp и конфигурационный файл ~/.bitwize-music/config.yaml: без них скилл не сможет разрешить пути и скопировать файлы.

Какие задачи решает

  • копировать обложку альбома в структуры audio и content одной командой
  • приводить названия файлов обложек к стандартным album.png и album-art.{ext}
  • автоматически создавать вложенные папки жанров и артистов перед копированием

Примеры запросов агенту

  • /import-art ~/Downloads/cover.png ambient-works
  • Импортируй обложку ~/Downloads/sample-album-cover.jpg для альбома sample-album

Как установить import-art

1Через Skills CLI (Vercel)

npx skills add bitwize-music-studio/claude-ai-music-skills --skill import-art -a claude-code

2Вручную: положить файлы

~/.claude/skills/import-art/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/import-art/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об import-art

Как установить import-art в Claude Code?

Выполните команду npx skills add bitwize-music-studio/claude-ai-music-skills --skill import-art -a claude-code в терминале.

Что делает скилл import-art?

Он находит альбом через MCP, создаёт недостающие каталоги и дублирует изображение обложки в аудио-папку релиза и в папку документации.

Что требуется для запуска import-art?

Необходим инструмент bitwize-music-mcp, настроенный файл ~/.bitwize-music/config.yaml и предварительно созданный альбом.

Исходный текст

SKILL.md · CC0-1.0
---
name: import-art
description: Places album art files in the correct audio and content directory locations. Use when the user has generated or downloaded album artwork that needs to be saved.
argument-hint: <file-path> <album-name>
model: haiku
allowed-tools:
  - Read
  - Bash
  - Glob
  - bitwize-music-mcp
---

## Your Task

**Input**: $ARGUMENTS

Import album art to both the audio folder and album content folder.

---

# Import Art Skill

You copy album art to both required locations based on config.

## Step 1: Parse Arguments

Expected format: `<file-path> <album-name>`

Examples:
- `~/Downloads/album-art.jpg sample-album`
- `~/Downloads/cover.png sample-album`

If arguments are missing, ask:
```
Usage: /import-art <file-path> <album-name>

Example: /import-art ~/Downloads/album-art.jpg sample-album
```

## Step 2: Find Album and Resolve Paths via MCP

1. Call `find_album(album_name)` — fuzzy match, returns album metadata including genre
2. Call `resolve_path("audio", album_slug)` — returns audio directory path
3. Call `resolve_path("content", album_slug)` — returns content directory path

If album not found:
```
Error: Album "{album-name}" not found.
Create it first with: /new-album {album-name} <genre>
```

## Step 3: Construct Target Paths

**TWO destinations required** (paths from MCP `resolve_path` calls):

1. **Audio folder** (for platforms/mastering): `{audio_path}/album.png`
2. **Content folder** (for documentation): `{content_path}/album-art.{ext}`

**CRITICAL**: `resolve_path` includes the artist folder automatically.

## Step 4: Create Directories and Copy Files

```bash
# Create audio directory (includes artist folder!)
mkdir -p {audio_root}/artists/{artist}/albums/{genre}/{album}

# Copy to audio folder as album.png
cp "{source_file}" "{audio_root}/artists/{artist}/albums/{genre}/{album}/album.png"

# Copy to content folder preserving extension
cp "{source_file}" "{content_root}/artists/{artist}/albums/{genre}/{album}/album-art.{ext}"
```

## Step 5: Confirm

Report:
```
Album art imported for: {album-name}

Copied to:
1. {audio_root}/artists/{artist}/albums/{genre}/{album}/album.png (for platforms)
2. {content_root}/artists/{artist}/albums/{genre}/{album}/album-art.{ext} (for docs)
```

## Error Handling

**Source file doesn't exist:**
```
Error: File not found: {source_file}
```

**Config file missing:**
```
Error: Config not found at ~/.bitwize-music/config.yaml
Run /configure to set up.
```

**Album not found:**
```
Error: Album "{album-name}" not found.
Create it first with: /new-album {album-name} <genre>
```

**Not an image file:**
```
Warning: File doesn't appear to be an image: {source_file}
Expected: .jpg, .jpeg, .png, .webp

Continue anyway? (y/n)
```

---

## Examples

```
/import-art ~/Downloads/sample-album-cover.jpg sample-album
```

Config has:
```yaml
paths:
  content_root: ~/bitwize-music
  audio_root: ~/bitwize-music/audio
artist:
  name: bitwize
```

Album found at: `~/bitwize-music/artists/bitwize/albums/electronic/sample-album/`

Result:
```
Album art imported for: sample-album

Copied to:
1. ~/bitwize-music/audio/artists/bitwize/albums/electronic/sample-album/album.png (for platforms)
2. ~/bitwize-music/artists/bitwize/albums/electronic/sample-album/album-art.jpg (for docs)
```

---

## Common Mistakes

### ❌ Don't: Manually read config and construct paths

**Wrong:**
```bash
cat ~/.bitwize-music/config.yaml
cp art.png ~/music-projects/audio/sample-album/
```

**Right:**
```
# Use MCP to find album and resolve both paths
find_album(album_name) → returns album metadata
resolve_path("audio", album_slug) → audio path with artist folder
resolve_path("content", album_slug) → content path with genre
```

**Why it matters:** `resolve_path` handles config reading, artist folder, and genre resolution automatically.

### ❌ Don't: Place art in only one location

**Wrong:**
```bash
# Only copying to audio folder
cp art.png {audio_root}/artists/{artist}/albums/{genre}/{album}/album.png
# Missing: content folder copy
```

**Right:**
```bash
# Copy to BOTH locations
# 1. Audio location (for streaming platforms)
cp art.png {audio_root}/artists/{artist}/albums/{genre}/{album}/album.png
# 2. Content location (for documentation)
cp art.jpg {album_path}/album-art.jpg
```

**Why it matters:** Album art needs to be in both locations - audio folder for release, content folder for documentation.

### ❌ Don't: Mix up the filenames

**Wrong:**
```bash
# Using same filename in both locations
cp art.png {audio_root}/artists/{artist}/albums/{genre}/{album}/album-art.png
cp art.png {album_path}/album.png
```

**Correct naming:**
```
Audio location: album.png (or album.jpg)
Content location: album-art.jpg (or album-art.png)
```

**Why it matters:** Different locations use different naming conventions to avoid confusion.

### ❌ Don't: Search for albums manually

**Wrong:**
```bash
find . -name "README.md" -path "*albums/$album_name*"
```

**Right:**
```
find_album(album_name) → returns album data including path and genre
```

### ❌ Don't: Forget to create directories

**Wrong:**
```bash
# Copying without ensuring directory exists
cp art.png {audio_root}/artists/{artist}/albums/{genre}/{album}/album.png
# Fails if directory doesn't exist
```

**Right:**
```bash
# Create directory first
mkdir -p {audio_root}/artists/{artist}/albums/{genre}/{album}/
cp art.png {audio_root}/artists/{artist}/albums/{genre}/{album}/album.png
```

**Why it matters:** Audio directory might not exist yet, especially for new albums.

© bitwize-music-studio · CC0-1.0 · bitwize-music-studio/claude-ai-music-skills

Похожие скиллы

Все скиллы по теме «Заметки, задачи и проекты» →
cd-spine-art stvlynn Скилл cd-spine-art для Claude Code создаёт и собирает изображения корешков CD в общую полочную композицию. Берёт за основу референсы, проверенные логотипы или готовые изображения. CX Codex +1 ★ 137звёзд репо elevenlabs-music-generation prime-skills Скилл elevenlabs-music-generation для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI запускает ElevenLabs Music через runcomfy CLI и возвращает стереодорожку 44.1 кГц. CX Codex +1 387 700установок spotify-player openclaw Даёт агенту доступ к Spotify через spogo или spotify_player. Управляет воспроизведением, ищет треки и переключает устройства прямо из терминала. CX Codex +1 5 400установок layer-workflow-import layerai Скилл layer-workflow-import для Claude Code и Codex. Переносит пайплайны и JSON-графы из других редакторов в воркфлоу Layer Blueprint, пересобирая их через ноды Layer с группировкой шагов по смыслу. CX Codex +1 4 000установок Spotify Automation Claude Office Skills Скилл Spotify Automation для управления воспроизведением Spotify, сборки плейлистов и разбора аудиохарактеристик треков прямо из чата с агентом. CX Codex +1 4 800установок scenario-elevenlabs scenario-labs Скилл scenario-elevenlabs для работы с моделями ElevenLabs через Scenario MCP: озвучка текста с тегами эмоций, генерация музыки и звуковых эффектов, дубляж видео в другой язык, замена голоса в записи. CX Codex +1 865установок

Из того же набора52

Весь набор →
album-dashboard Скилл album-dashboard собирает сводку по этапам альбома: показывает процент готовности, статусы треков и блокирующие задачи. Пригодится, чтобы понять, что мешает выпуску. CX Codex +1 253установок researcher Скилл researcher для Claude Code собирает первоисточники, проверяет факты по трём и более независимым источникам и строит цепочки доказательств. Даёт фактологию с цитатами и ссылками. CX Codex +1 253установок researchers-tech Скилл researchers-tech для Claude Code собирает сведения об истории открытых проектов, интервью разработчиков и технической документации. Находит факты о происхождении, авторах и эволюции технологий. CX Codex +1 253установок help Скилл help для Claude Code показывает каталог команд, рабочих процессов и быстрые советы; вызывай его, чтобы найти команду или узнать назначение инструмента. CX Codex +1 253установок new-album Скилл new-album разворачивает каталоги и шаблоны нового музыкального альбома по заданному жанру через вызов инструмента MCP. CX Codex +1 252установок researchers-gov Скилл researchers-gov ищет и структурирует официальные релизы ведомств США (DOJ, FBI, SEC, CISA) для документальных музыкальных треков. Выделяет цитаты, хронологию и ключевые цифры. CX Codex +1 252установок session-start Скилл session-start для Claude Code запускает проверку окружения в начале сессии и загружает конфигурацию и состояние проекта. Восстанавливает рабочий контекст. CX Codex +1 251установок explicit-checker Скилл explicit-checker проверяет тексты песен на ненормативную лексику и сверяет флаг Explicit перед генерацией в Suno или отправкой дистрибьюторам. CX Codex +1 251установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой