Clipboard

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:

if command -v pbcopy >/dev/null 2>&1; then
  echo "macOS"
elif command -v clip.exe >/dev/null 2>&1; then
  echo "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
- 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 (auto-appends Exclude Styles if present)
• exclude - Exclude Styles only (negative prompts)
• 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:

Example (use printf '%s' to safely handle special characters in lyrics):

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 (with Exclude Styles if present)
- 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
• WSL has clip.exe which works from Linux subsystem
• 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

Clipboard Skill - Usage Examples

Platform-specific examples and troubleshooting for the /bitwize-music:clipboard skill.

---

Platform Detection

The skill auto-detects your platform and uses the appropriate clipboard utility:

---

Common Use Cases

Copy Lyrics to Paste into Suno

/bitwize-music:clipboard lyrics my-album 03

Copies the Suno Lyrics Box content for track 03. Paste directly into Suno's lyrics field.

Copy Style Prompt for Suno

/bitwize-music:clipboard style my-album 05

Copies the Suno Style Box content. Paste into Suno's style/genre field.

Copy Both for Quick Generation

/bitwize-music:clipboard all my-album 01

Copies Style Box + separator + Lyrics Box. Useful when setting up a new generation.

Copy Streaming Lyrics for Distributors

/bitwize-music:clipboard streaming-lyrics my-album 02

Copies clean lyrics (no section tags) formatted for DistroKid, TuneCore, etc.

---

Platform-Specific Commands

macOS

# Manual verification (what the skill does internally)
echo "test" | pbcopy
pbpaste  # Should show "test"

Linux with xclip

# Install if missing
sudo apt install xclip

# Manual verification
echo "test" | xclip -selection clipboard
xclip -selection clipboard -o  # Should show "test"

Linux with xsel

# Install if missing
sudo apt install xsel

# Manual verification
echo "test" | xsel --clipboard --input
xsel --clipboard --output  # Should show "test"

WSL (Windows Subsystem for Linux)

# No install needed - uses Windows clipboard
echo "test" | clip.exe
# Paste in any Windows app to verify

---

Troubleshooting

"No clipboard utility found"

Linux: Install xclip or xsel:

sudo apt install xclip  # Debian/Ubuntu
sudo dnf install xclip  # Fedora
sudo pacman -S xclip    # Arch

WSL: Ensure you're running from WSL, not native Linux. clip.exe should be available.

"Track not found"

Check your track number and album name:

# List available tracks
ls ~/music-projects/artists/bitwize/albums/*/my-album/tracks/

Track numbers are zero-padded: use 03 not 3.

"Content section not found"

The track file may not have the requested section yet. Check the track file:

# Look for section headings
grep -E "^#{3,4} (Style|Lyrics) Box" ~/path/to/track.md

Clipboard Not Working in SSH

Remote SSH sessions don't have clipboard access. Options:

• Use X11 forwarding: ssh -X user@host
• Copy the output manually from the terminal
• Use a clipboard manager that syncs across machines

Content Gets Truncated

Very long lyrics may hit shell limits. The skill handles this internally, but if issues persist:

• Check the source track file isn't corrupted
• Try copying smaller sections (style vs all)

---

See Also

• SKILL.md - Full skill documentation
• ${CLAUDE_PLUGIN_ROOT}/reference/suno/v5-best-practices.md - Suno prompting guide