import-track

Move a track markdown file into its album tracks directory using Glob discovery.

408|97|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/bitwize-music-studio/claude-ai-music-skills --skill import-track
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: import-track
Source: https://github.com/bitwize-music-studio/claude-ai-music-skills/tree/main/skills/import-track
Command: npx skills add https://github.com/bitwize-music-studio/claude-ai-music-skills --skill import-track

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill moves track markdown files to the correct album location, helping you organize track files that are scattered in Downloads or other folders.

Core Features & Use Cases

  • Parse input: Validates arguments like <file-path> <album-name> [track-number] and reads the source track file.
  • Config-driven discovery: Reads ~/.bitwize-music/config.yaml to obtain content_root and artist.name.
  • Album discovery & path construction: Uses Glob to locate the album across genre folders and builds the destination path under tracks with the correct naming.
  • Move & confirm: Moves the file and reports the source and destination.

Quick Start

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

Frequently Asked Questions about import-track

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I move track markdown files into the correct album directory?

To move track markdown files into the correct album directory, this skill parses your input arguments, searches across genre folders using Glob, and moves the file to the constructed destination path under the album tracks directory.

Do I need a specific config file to organize track files into album folders?

You need a config file at ~/.bitwize-music/config.yaml to organize track files. This configuration file provides the required content_root path and artist name needed to locate the correct album destination.

What is the best way to assign a track number when moving files to an album?

The best way to assign a track number is by providing an optional track number argument during the move command. The skill automatically applies zero-padding to the number when constructing the final destination file name.

How does album discovery work when importing a track file?

Album discovery works by reading your config file for the artist name and content root, then using Glob to search across multiple genre folders to find the matching album directory before moving the track file.

Can I import a track file if it is currently scattered in my Downloads folder?

You can import a track file from your Downloads folder by providing the full file path as an argument. The skill validates the source file path and moves it directly into the matched album tracks location.

What happens after the track file is moved to the album directory?

After the track file is moved to the album directory, the skill outputs a confirmation report. This confirmation displays both the original source path and the newly constructed destination path for your records.