promo-reviewer
Reviews and iterates on social media copy in album promo/ files. Use after populating promo templates and before release to polish platform-specific posts.
Install / Use
npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-reviewerInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
MarketingSupported Platforms
Our assessment of promo-reviewer
promo-reviewer scores 90/100 on our quality scale, 267th of 652 Marketing skills we index (top 41%).
Its SKILL.md is 9.6 KB long, well organised into 31 sections with 10 code examples: a thorough specification that gives an agent plenty to work with.
It has 512 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so promo-reviewer is actively maintained.
- Our last check on 2026-10-30 found the source still online.
- It is released under the CC0-1.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit ā read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-05. Automated pattern scan on 2026-10-05. It catches known dangerous patterns, not every risk ā read a skill before letting an agent act on it.
promo-reviewer compared with similar skills
All 4 of these similar skills score higher than promo-reviewer; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| promo-reviewer (this skill)by bitwize-music-studio | 90 | 512 | 56d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 113.0k | 10d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 86.4k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install promo-reviewer?
- Run
npx skills add bitwize-music-studio/claude-ai-music-skills --skill promo-reviewer. The install tabs above show the steps for each supported agent. - Which AI agents does promo-reviewer work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is promo-reviewer safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is CC0-1.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is promo-reviewer still maintained?
- The repository was last updated about 2 months ago, so promo-reviewer is actively maintained.
Skill content
View source on GitHubname: promo-reviewer 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. argument-hint: <album-name> [platform] model: sonnet effort: medium allowed-tools:
- Read
- Edit
- Glob
- Grep
- bitwize-music-mcp
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-writergenerates 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 ā 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
| Platform | File | Status |
|----------|------|--------|
| Campaign | campaign.md | Populated |
| Twitter/X | twitter.md | Populated |
| Instagram | instagram.md | Template only |
| TikTok | tiktok.md | Not found |
| Facebook | facebook.md | Populated |
| YouTube | youtube.md | Template only |
3 of 6 platforms have copy ready for review.
If no promo files are populated:
No promo copy found to review.
Options:
1. Generate promo copy: /bitwize-music:promo-writer <album-name>
2. Populate promo templates manually (fill in promo/ files)
3. Skip promo review and proceed to release
2. Platform Selection
If platform specified in arguments, review only that platform.
Otherwise, ask:
Which platforms to review?
[A] All populated platforms (campaign, twitter, facebook)
[1] Campaign strategy
[2] Twitter/X posts
[3] Facebook posts
List only populated platforms as numbered options.
3. Section Parsing
For each selected platform file:
- Read the full file using the Read tool
- Split at heading boundaries ā
##and###headings delineate sections - Extract code blocks ā content inside ``` fences is the actual post copy
- Identify reviewable sections ā sections with code blocks containing non-placeholder text
- Count metrics for each post:
- Character count (hashtags count toward the limit on all platforms)
- Hashtag count
- Line count
- Platform limit compliance (from platform-rules.md)
- Thread detection ā if a code block contains numbered tweets (1/, 2/, 3/), split into individual tweets and review each separately with per-tweet char counts
4. Per-Post Review Loop
For each reviewable section, present the post with context:
## Twitter/X ā Track 01: Track Title
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
Track one tells the story of [concept].
Listen now: [link]
#NewMusic #HipHop
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
Chars: 87/280 | Hashtags: 2 | Status: Within limits
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
Actions:
[A] Approve ā keep as-is
[R] Revise ā give feedback for rewrite
[S] Shorten ā make more concise
[P] Punch up ā make more engaging/attention-grabbing
[H] Add hashtags ā suggest relevant hashtags
[T] Rewrite tone ā specify tone (casual, professional, hype, etc.)
[K] Skip ā move to next without changes
After any revision action (R, S, P, H, T):
- Generate the revised version
- Present it with updated metrics
- Offer follow-up:
Revised version:
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
[revised copy here]
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
Chars: 142/280 | Hashtags: 3 | Status: Within limits
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
[A] Approve this version
[R] Revise again ā more feedback
[D] Discard ā revert to original
5. Campaign.md Special Handling
Campaign files contain strategy tables and messaging, not code-block posts. Adjust the review approach:
- Present each section (Overview, Key Messages, Schedule, etc.) as a reviewable unit
- Replace "Punch up" with "[M] Strengthen messaging" ā tighten the strategic language
- Skip character limits ā campaign docs have no platform limits
- Focus on: clarity, consistency with album themes, actionable schedule entries, complete metadata fields
6. Write-Back
After all sections for a platform are reviewed:
- Reconstruct the file with approved/revised content in place
- Use the Edit tool to apply changes to the promo file
- Confirm write:
Updated twitter.md ā 4 posts revised, 2 approved as-is, 1 skipped
Only write back if at least one section was revised. If all sections were approved as-is or skipped, skip the write step.
7. Progress Tracking
Between platforms, show a running summary:
## Review Progress
| Platform | Approved | Revised | Skipped | Limit Issues |
|----------|----------|---------|---------|--------------|
| Twitter | 4 | 2 | 1 | 0 |
| Facebook | ā | ā | ā | ā |
Next: Facebook (5 sections to review)
Continue? [Y/n]
8. Session Summary
After all platforms reviewed:
## Promo Review Complete
| Platform | Approved | Revised | Skipped |
|----------|----------|---------|---------|
| Campaign | 3 | 1 | 0 |
| Twitter | 4 | 2 | 1 |
| Facebook | 3 | 2 | 0 |
| **Total** | **10** | **5** | **1** |
Char limit compliance: All posts within platform limits
Files updated:
- promo/campaign.md (1 revision)
- promo/twitter.md (2 revisions)
- promo/facebook.md (2 revisions)
Next steps:
1. Review any skipped posts if needed
2. Add streaming links when available (replace [Streaming Link] placeholders)
3. Ready for release: /bitwize-music:release-director <album>
Revision Guidelines
When revising posts, follow these principles:
Shorten (S)
- Cut filler words ("really", "very", "just")
- Combine sentences where possible
- Prioritize the hook ā lead with the most compelling element
- Respect platform limits (see platform-rules.md)
Punch Up (P)
- Stronger verbs, more vivid language
- Add urgency or curiosity
- Open with a hook, not a description
- Keep the core message ā just make it hit harder
Add Hashtags (H)
- Suggest 3-5 relevant hashtags based on genre, album themes, platform norms
- Present options ā user picks which to include
- Follow platform-specific hashtag conventions (see platform-rules.md)
- Never exceed platform maximum
Rewrite Tone (T)
- Ask user for target tone before rewriting
- Common tones: casual, professional, hype, mysterious, storytelling, urgent
- Preserve factual content ā only change voice and style
- Match tone to platform expectations
Strengthen Messaging (M) ā Campaign only
- Tighten strategic language
- Make key messages more memorable and quotable
- Ensure schedule entries are specific and actionable
- Verify consistency between messaging and album themes
Platform-Specific Review Focus
Twitter/X
- Every post under 280 chars (hard limit)
- Thread tweets: each tweet standalone but connected
- 1-2 hashtags max (more looks spammy)
- Streaming link in release posts
- Caption can be long (2,200 chars) but first 125 visible before "more"
- Hook in first line ā it's the only thing people see
- Hashtags as separate block at end
- 15-20 hashtags is optimal (30 max)
TikTok
- Under 150 chars ideal (visible without tap)
- 4,000 char max but shorter is better
- 3-5 hashtags, trending ones if applicable
- Casual, authentic tone
- Longer storytelling works well
- First 2-3 lines visible before "See more"
- 3-5 hashtags (less hashtag-driven platform)
- Include call to action
YouTube
- Description supports timestamps, credits, links
- First 2-3 lines visible in collapsed view
- Include streaming links, social links, credits
- 3-5 hashtags (shown above title)
Remember
- Read platform-rules.md at invocation start for current limits
- Present one post at a time ā don't batch review
- Show metrics with every post ā chars, hashtags, limit compliance
- Never auto-approve ā every post gets user review
- Write back only changed files ā don't touch files with no revisions
- Track progress ā running counts between platforms
- Campaign is different ā strategy doc, not social posts
- Preserve user voice ā revisions should enhance, not replace the user's style
- Flag limit violations ā highlight posts over platform char limits
- Placeholder detection ā flag remaining
[placeholder]text that needs real content
Related Skills
Agent-Reach
113.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu ā one CLI, zero API fees.
hyperframes
86.4kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.0kš The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
80.1kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit ā see the Safety scan above for what the skill file itself contains.
