Skip to main content
skill CX Codex

clipboard — Claude Code skill: what it does, how to install

Copies track lyrics, style prompts, and metadata directly to your system clipboard for quick pasting into Suno and external tools.

CC0-1.0 261 installs ★ 686 updated 2026-10-22

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add bitwize-music-studio/claude-ai-music-skills --skill clipboard -a claude-code
Open on GitHub

What clipboard does

This skill retrieves specific sections from album track files and places them on your operating system clipboard. It delegates parsing to the format_for_clipboard tool within bitwize-music-mcp, eliminating manual file reading. It handles multiple target slots: lyrics, Suno style prompts, excluded genre tags, distributor-ready streaming lyrics, or a combined JSON payload designed for browser auto-fill scripts.

Clipboard transfer relies on native command-line utilities. It detects pbcopy on macOS, clip.exe on Windows and WSL, or xclip and xsel on Linux. The command will stop with an error if the ~/.bitwize-music/config.yaml configuration is missing or if the track markdown file lacks the requested section.

What it helps with

  • send raw track lyrics directly into the Suno generation prompt box
  • extract style tags and exclusion parameters without editing markdown files manually
  • export cleaned lyrics formatted for streaming service distributors
  • generate track metadata JSON payloads for Tampermonkey browser scripts

Example prompts for the agent

  • Run /clipboard lyrics sample-album 03 to copy track lyrics to the clipboard
  • Extract style parameters for track five using /clipboard style sample-album 05
  • Prepare a complete browser auto-fill payload with /clipboard suno sample-album 01

How to install clipboard

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/clipboard/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/clipboard/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about clipboard

How to install clipboard in Claude Code?

Run npx skills add bitwize-music-studio/claude-ai-music-skills --skill clipboard -a claude-code in your terminal.

What does clipboard do?

It reads structured track markdown files via MCP and sends specific sections like lyrics, styles, or JSON payloads straight to the system clipboard.

What system requirements does this skill have?

You need a system clipboard utility such as pbcopy, clip.exe, xclip, or xsel, plus an existing config file at ~/.bitwize-music/config.yaml.

Source text

SKILL.md · CC0-1.0
---
name: clipboard
description: Copies track content (lyrics, style prompts, streaming lyrics) to the system clipboard. Use when the user needs to paste lyrics or style prompts into Suno or other external tools.
argument-hint: <content-type> <album-name> <track-number>
model: haiku
allowed-tools:
  - Read
  - Bash
  - bitwize-music-mcp
---

## Your Task

**Input**: $ARGUMENTS

Copy content from track files to the system clipboard for pasting into Suno or other tools.

---

# Clipboard Skill

Copy specific sections from track files directly to your clipboard.

## Step 1: Detect Platform & Check Clipboard Tool

Run detection:

```bash
if command -v pbcopy >/dev/null 2>&1; then
  echo "macOS"
elif command -v clip.exe >/dev/null 2>&1; then
  # clip.exe is a built-in Windows utility (System32). Reachable both from WSL
  # via interop and from a native-Windows shell such as Git Bash, so this one
  # branch covers both. Verified on a windows-latest runner: Git Bash present,
  # clip.exe resolved at /c/Windows/system32/clip.exe, copy round-tripped.
  echo "Windows/WSL"
elif command -v xclip >/dev/null 2>&1; then
  echo "Linux-xclip"
elif command -v xsel >/dev/null 2>&1; then
  echo "Linux-xsel"
else
  echo "NONE"
fi
```

**If NONE:**

```
Error: No clipboard utility found.

Install instructions:
- macOS: pbcopy (built-in)
- Linux: sudo apt install xclip
- Windows (native) and WSL: clip.exe (built-in)
```

## Step 2: Parse Arguments

Expected format: `<content-type> <album-name> <track-number>`

**Content types:**
- `lyrics` - Suno Lyrics Box
- `style` - Suno Style Box only
- `exclude` - Suno Exclude Styles field (bare elements, comma-separated — `drums, autotune`, never "no drums")
- `streaming-lyrics` - Streaming Lyrics (for distributors)
- `all` - All Suno inputs (Style + Exclude + Lyrics combined)
- `suno` - JSON object (title, style, exclude_styles, lyrics) for Suno auto-fill via Tampermonkey

Examples:
- `/clipboard lyrics sample-album 03`
- `/clipboard style sample-album 05`
- `/clipboard streaming-lyrics sample-album 02`
- `/clipboard all sample-album 01`

If arguments are missing:
```
Usage: /clipboard <content-type> <album-name> <track-number>

Content types: lyrics, style, exclude, streaming-lyrics, all, suno

Example: /clipboard lyrics sample-album 03
```

## Step 3: Extract Content via MCP

Call `format_for_clipboard(album_slug, track_slug, content_type)` — extracts and formats the requested content in one call.

- `content_type`: `"lyrics"`, `"style"`, `"exclude"`, `"streaming"`, `"all"`, or `"suno"`
- Returns the formatted content ready for clipboard
- Handles track resolution, section extraction, and formatting automatically

**If track not found:** MCP returns an error with available tracks.

## Step 6: Copy to Clipboard

Use the detected platform's clipboard command:

| Platform | Command |
|----------|---------|
| macOS | `pbcopy` |
| Windows (native) / WSL | `clip.exe` |
| Linux (xclip) | `xclip -selection clipboard` |
| Linux (xsel) | `xsel --clipboard --input` |

Example (use `printf '%s'` to safely handle special characters in lyrics):
```bash
printf '%s' "$content" | pbcopy  # macOS
printf '%s' "$content" | xclip -selection clipboard  # Linux
```

## Step 7: Confirm

Report:
```
✓ Copied to clipboard: {content-type} from track {track-number}
  Album: {album}
  Track: {track-filename}
```

## Error Handling

**Track file not found:**
```
Error: Track {track-number} not found in album {album}

Available tracks:
- 01-track-name.md
- 02-track-name.md
```

**Content section not found:**
```
Error: {content-type} section not found in track {track-number}

The track file may not have this section yet.
```

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

---

## Examples

### Copy Suno Lyrics

```
/clipboard lyrics sample-album 03
```

Output:
```
✓ Copied to clipboard: lyrics from track 03
  Album: sample-album
  Track: 03-t-day-beach.md
```

### Copy Style Prompt

```
/clipboard style sample-album 05
```

### Copy Streaming Lyrics

```
/clipboard streaming-lyrics sample-album 02
```

### Copy All Suno Inputs

```
/clipboard all sample-album 01
```

Output:
```
✓ Copied to clipboard: all suno inputs from track 01
  Album: sample-album
  Track: 01-intro.md

Contents:
- Style Box
- `Exclude: …` (if the track has Exclude Styles)
- Lyrics Box
```

### Copy Suno Auto-Fill JSON

```
/clipboard suno sample-album 01
```

Output:
```
✓ Copied to clipboard: suno auto-fill JSON from track 01
  Album: sample-album
  Track: 01-intro.md

Clipboard contains JSON with: title, style, exclude_styles, lyrics
Paste into Suno with the Tampermonkey auto-fill script (Ctrl+Shift+V).
See tools/userscripts/README.md for setup.
```

---

## Implementation Notes

**Clipboard Detection:**
- Check multiple tools in order of preference
- `clip.exe` is built into Windows, so it serves both native Windows (via Git Bash) and WSL (via interop)
- If no bash is available at all, PowerShell's `Set-Clipboard` is an equivalent native fallback (verified working)
- Linux users may have either `xclip` or `xsel`

**Content Extraction:**
- MCP `format_for_clipboard` handles all section extraction and formatting
- No manual file parsing needed

**Multiple Matches:**
- If track number matches multiple files (shouldn't happen), use the first match
- Warn user if directory structure looks wrong

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

Similar skills

All skills for Notes, tasks and projects →

From the same set52

The whole set →
researchers-historical researchers-historical — a skill for exploring archives, documents, and primary sources when developing projects that rely on historical accuracy. Searches web archives, government records, and newspaper databases. CX Codex +1 266installs release-director release-director coordinates album releases after mastering by running pre-release QA, preparing distribution metadata, and tracking live platform links. CX Codex +1 265installs pre-generation-check pre-generation-check is a Claude Code skill that checks whether a track or album meets the gates before Suno generation, returning READY or NOT READY. CX Codex +1 264installs album-conceptualizer album-conceptualizer plans an album’s concept, track order, and thematic arc in 7 phases. Use it to start a new album or reshape an existing one. CX Codex +1 262installs researchers-legal researchers-legal investigates court records and criminal-case documents, then builds a cited research report. Use it when an album topic involves legal proceedings. CX Codex +1 261installs promo-director promo-director generates 15-second vertical videos for Instagram, TikTok and Twitter from a mastered track. Combines album artwork, intelligent clip selection, and waveform visualization. CX Codex +1 259installs promo-writer promo-writer creates platform-specific social copy from album material and lyrics. Use it before release when promo/ templates need campaign content. CX Codex +1 259installs tutorial tutorial guides new users through album creation, from the initial idea and sound to the tracklist, artwork concept, and final plan. CX Codex +1 259installs

Project sponsors

Companies that keep this analytics open