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

import-track — скилл для Claude Code: импорт треков в альбом

Скилл import-track для Claude Code перемещает файлы треков в директории альбомов. Организует треки, лежащие вразброс, по структуре проекта.

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

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

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

Скилл берёт markdown-файл трека, находит альбом по названию через MCP и перемещает файл в папку tracks внутри альбома. Учитывает жанр альбома и структуру каталога: трек оказывается по пути {content_root}/artists/{artist}/albums/{genre}/{album}/tracks/{номер}-{имя}.md. Номер трека можно передать аргументом или извлечь из имени файла; скилл автоматически форматирует его с нулевым заполнением (03, а не 3).

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

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

  • переместить трек из загрузок в альбом
  • организовать файлы треков по структуре проекта
  • переименовать трек с нулевым заполнением номера
  • найти альбом по названию и разместить трек в его папке

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

  • Переместить трек ~/Downloads/t-day-beach.md в альбом sample-album под номером 03
  • Добавить трек beach-vibes.md в альбом sample-album, номер уже в имени файла
  • Переместить загруженный трек в соответствующую папку альбома по названию

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

1Через Skills CLI (Vercel)

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

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

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

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

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

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

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

Выполни npx skills add bitwize-music-studio/claude-ai-music-skills --skill import-track -a claude-code, затем открой ~/.claude/skills/import-track/SKILL.md.

Что делает import-track?

Берёт markdown-файл трека и перемещает его в правильную папку альбома по структуре {content_root}/artists/{artist}/albums/{genre}/{album}/tracks/. Номер трека форматируется с нулевым заполнением.

Что нужно для работы скилла?

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

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

SKILL.md · CC0-1.0
---
name: import-track
description: Moves track markdown files to the correct album location. Use when the user has track files in Downloads or other locations that need to be placed in an album.
argument-hint: <file-path> <album-name> [track-number]
model: haiku
allowed-tools:
  - Read
  - Bash
  - Glob
  - bitwize-music-mcp
---

## Your Task

**Input**: $ARGUMENTS

Import a track markdown file (.md) to the correct album location based on config.

---

# Import Track Skill

You move track markdown files to the correct location in the user's content directory.

## Step 1: Parse Arguments

Expected format: `<file-path> <album-name> [track-number]`

Examples:
- `~/Downloads/track.md sample-album 03`
- `~/Downloads/t-day-beach.md sample-album 03`
- `~/Downloads/03-t-day-beach.md sample-album` (number already in filename)

If arguments are missing, ask:
```
Usage: /import-track <file-path> <album-name> [track-number]

Example: /import-track ~/Downloads/track.md sample-album 03
```

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

1. Call `find_album(album_name)` — fuzzy match by name, slug, or partial. Returns album metadata including genre.
2. Call `resolve_path("tracks", album_slug)` — returns the full tracks directory path

If album not found, MCP returns available albums:
```
Error: Album "{album-name}" not found.

Available albums:
[list from MCP response]

Create album first with: /new-album {album-name} <genre>
```

## Step 4: Construct Target Path

The target path is **ALWAYS**:

```
{content_root}/artists/{artist}/albums/{genre}/{album}/tracks/{XX}-{track-name}.md
```

Example with:
- `content_root: ~/bitwize-music`
- `artist: bitwize`
- `genre: electronic` (found from album location)
- `album: sample-album`
- `track-number: 03`
- `track-name: t-day-beach`

Result:
```
~/bitwize-music/artists/bitwize/albums/electronic/sample-album/tracks/03-t-day-beach.md
```

**Track numbering**:
- If track number provided, use it (zero-padded: `03`)
- If filename already has number prefix (e.g., `03-name.md`), preserve it
- If neither, ask user for track number

## Step 5: Move File

```bash
mv "{source_file}" "{target_path}"
```

## Step 6: Confirm

Report:
```
Moved: {source_file}
   To: {target_path}
```

## 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>
```

**Track already exists:**
```
Warning: Track already exists at destination.
Overwrite? (The original was not moved)
```

---

## Examples

```
/import-track ~/Downloads/t-day-beach.md sample-album 03
```

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

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

Result:
```
Moved: ~/Downloads/t-day-beach.md
   To: ~/bitwize-music/artists/bitwize/albums/electronic/sample-album/tracks/03-t-day-beach.md
```

---

## Common Mistakes

### ❌ Don't: Manually read config and search for albums

**Wrong:**
```bash
cat ~/.bitwize-music/config.yaml
find . -name "README.md" -path "*albums/$album_name*"
```

**Right:**
```
# Use MCP to find album and resolve path
find_album(album_name) → returns album metadata with genre
resolve_path("tracks", album_slug) → returns full tracks directory path
```

**Why it matters:** MCP handles config reading, fuzzy matching, and path resolution in single calls.

### ❌ Don't: Forget the tracks/ subdirectory

**Wrong destination:**
```
{album_path}/01-track.md
# Example: ~/bitwize-music/artists/bitwize/albums/electronic/sample-album/01-track.md
```

**Correct destination:**
```
{album_path}/tracks/01-track.md
# Example: ~/bitwize-music/artists/bitwize/albums/electronic/sample-album/tracks/01-track.md
```

**Why it matters:** Tracks always go in the `tracks/` subdirectory within the album folder.

### ❌ Don't: Skip track number validation

**Wrong:**
```bash
# Not validating track number format
mv track.md {album_path}/tracks/$track_num-track.md
# Could result in: 3-track.md instead of 03-track.md
```

**Right:**
```bash
# Ensure zero-padding
track_num=$(printf "%02d" $track_num)
mv track.md {album_path}/tracks/$track_num-track.md
# Results in: 03-track.md
```

**Why it matters:** Track numbers must be zero-padded (01, 02, 03...) for proper sorting.

### ❌ Don't: Assume album location without searching

**Wrong:**
```bash
# Guessing album is in electronic genre
mv track.md ~/music-projects/artists/bitwize/albums/electronic/sample-album/tracks/
```

**Right:**
```
# Use MCP to find the album (handles genre resolution)
find_album(album_name) → returns album metadata including genre and path
```

**Why it matters:** Albums are organized by genre. `find_album` resolves the genre automatically.

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

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
toggl-track membrane Скилл для работы с Toggl Track прямо из Claude Code, Cursor, GitHub Copilot и других редакторов. Создавайте записи времени, управляйте проектами и клиентами, просматривайте отчёты через команды агента. CX Codex +1 247установок organize-dropbox-folder официальный Dropbox Скилл organize-dropbox-folder помогает разложить файлы и папки Dropbox по новой структуре через создание папок, копирование и перемещение. Перед изменениями он готовит план. CX Codex GP ChatGPT +1 ★ 8 052звёзд репо wiki-import Ar9av Скилл wiki-import для Claude Code переносит граф вики в текущее хранилище Obsidian из graph.json или набора OKF с файлами Markdown. Он разбирает конфликты с уже существующими страницами. CX Codex +1 1 000установок google-drive-automation davepoon Скилл google-drive-automation автоматизирует работу с Google Drive: загружает и скачивает файлы, ищет документы, создаёт папки, делится доступом. Работает через Rube MCP и Composio — нужна активная связь с Google Drive. CX Codex +1 133установок horizon-track ruvnet Скилл horizon-track отслеживает долгосрочные цели через цепочку сессий, фиксирует вехи в памяти и предупреждает о срыве сроков. CX Codex +1 747установок cost-track ruvnet Считает расход токенов по сессии, переводит его в доллары и сохраняет запись в неймспейсе cost-tracking. Показывает стоимость работы. CX Codex +1 685установок

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

Весь набор →
session-start Скилл session-start для Claude Code запускает проверку окружения в начале сессии и загружает конфигурацию и состояние проекта. Восстанавливает рабочий контекст. CX Codex +1 251установок explicit-checker Скилл explicit-checker проверяет тексты песен на ненормативную лексику и сверяет флаг Explicit перед генерацией в Suno или отправкой дистрибьюторам. CX Codex +1 251установок promo-reviewer Скилл promo-reviewer проверяет тексты для соцсетей в promo/ альбома и помогает отредактировать их перед релизом. Подходит для финальной вычитки постов по платформам. CX Codex +1 250установок voice-checker Скилл voice-checker анализирует текст песен и прозу на признаки AI-генерации: абстрактные существительные подряд, переобъяснённые метафоры, штампованные фразы. Помечает проблемы как советы, не переписывает. CX Codex +1 250установок researchers-verifier Скилл researchers-verifier для Claude Code проверяет источники, цитаты и факты после завершения исследования. Передаёт отчёт с ошибками и предупреждениями на проверку человеку. CX Codex +1 249установок verify-sources Скилл verify-sources проверяет ссылки и источники для треков музыкального альбома перед генерацией в Suno. Скилл запрашивает ручное подтверждение и проставляет дату проверки в файлах. CX Codex +1 249установок rename Скилл rename переименовывает музыкальные альбомы и треки в каталоге, обновляя слаги, метаданные и зеркальные папки контента. Помогает навести порядок в архиве проектов. CX Codex +1 249установок about Скилл about выводит версию плагина bitwize-music и сведения о его создателе. Используй, когда нужно уточнить возможности плагина или проверить установленную версию. CX Codex +1 248установок

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

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