# Promo Reviewer

Reviews and iterates on social media copy in album promo/ files.

- Repository: https://github.com/bitwize-music-studio/claude-ai-music-skills (615 stars)
- Category: Marketing
- License: CC0-1.0
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-reviewer -g -a claude-code -y`
Codex: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-reviewer -g -a codex -y`
Cursor: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-reviewer -g -a cursor -y`
Gemini CLI: `npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-reviewer -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add bitwize-music-studio/claude-ai-music-skills`

## Description

Reviews and iterates on social media copy in album promo/ files. Use after populating promo templates and before release to polish platform-specific posts.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Promo Reviewer Skill

Interactive review and polish of social media copy in album `promo/` files. Walk through each post, approve or revise, and write polished results back to the file.

## Purpose

After promo templates are populated with platform-specific copy, this skill provides structured review before release. Each post is presented with character counts, hashtag counts, and platform limit compliance. The user chooses actions (approve, revise, shorten, punch up, etc.) and polished copy is written back.

## When to Use

- After `/bitwize-music:promo-writer` generates initial copy
- After populating promo/ templates (manually or during release prep)
- Before release, final polish pass on social media copy
- User says "review promo copy" or "polish the twitter posts for [album]"
- When promo copy exists but hasn't been reviewed

## Position in Workflow

```
Promo Videos (optional) → [Promo Writer] (or manual) → **[Promo Review]** → Release
```

Between populating promo templates and release-director.

## Supporting Files

- **[platform-rules.md](platform-rules.md)**, Per-platform character limits, hashtag rules, tone guidelines

---

## Workflow

### 1. Album Resolution

**Resolve the album from arguments:**

Use MCP `find_album` with the album name from `$ARGUMENTS`. If no album specified, check `get_session` for last album context.

**Locate promo directory:**
```
{content_root}/artists/{artist}/albums/{genre}/{album}/promo/
```

**Check which promo files exist and have content:**

Glob for `promo/*.md` in the album directory. For each file, check if it contains populated content (not just template placeholders). A file is "populated" if it contains text beyond the template markers, look for content inside code blocks that isn't `[placeholder text]`.

**Report status:**
```
## Promo Copy Status

The rest: https://github.com/bitwize-music-studio/claude-ai-music-skills/blob/HEAD/skills/promo-reviewer/SKILL.md