Skip to content
This repository was archived by the owner on Apr 13, 2026. It is now read-only.

SKILL.md

Latest commit

 

History

History
218 lines (168 loc) · 7.51 KB

SKILL.md

File metadata and controls

218 lines (168 loc) · 7.51 KB
name release-management
description Manage music releases using RELEASE.md documents stored in releases/{release-slug}/ within an artist workspace. Triggers when the user mentions an artist's album, EP, single, or project — or asks about release planning, DSP pitches, metadata, marketing, press materials, physical production, or tour coordination. First infer which artist and release the user means, then find or create the RELEASE.md. Use this skill to create, update, or pull data from release documents, and to generate deliverables like DSP pitches, press one-sheets, and production specs.

Music Release Management

Manage music release campaigns using RELEASE.md as the single source of truth.

Folder Structure

Releases live inside an artist workspace under releases/. The full path from the sandbox root:

orgs/{org}/
└── artists/
    └── {artist-slug}/
        └── releases/
            └── {release-slug}/
            └── RELEASE.md

Use lowercase-kebab-case for release slugs (e.g. blue-slide-park, debut-ep).

Example:

orgs/recoup-records/artists/gatsby-grace/releases/adhd-ep/
            └── RELEASE.md

Step 1: Identify the Release

When the user mentions a release, infer:

  1. Organization — From the sandbox structure or conversation context
  2. Artist — From the current workspace, conversation history, or ask
  3. Release Name — Album title, EP name, single title
  4. Release slug — Derive from the name (e.g. "Blue Slide Park" → blue-slide-park)

If unclear, ask:

"Which artist and release are you referring to?"

Step 2: Check if RELEASE.md Exists

Once artist and release are identified:

1. Navigate to: orgs/{org}/artists/{artist-slug}/releases/{release-slug}/
2. Check if RELEASE.md exists
3. If YES → Read it and proceed
4. If NO → Ask: "No RELEASE.md found for [Release]. Should I create one?"

Step 3: Create, Update, or Pull

User Intent Action
Discussing a release Read RELEASE.md, use as context
Adding information Update the relevant section(s)
Asking for a deliverable Pull data from RELEASE.md, generate output
Starting a new release Create folder structure + RELEASE.md from template

Creating a New Release

# 1. Create the folder structure (from sandbox root)
mkdir -p "orgs/{org}/artists/{artist-slug}/releases/{release-slug}"

# 2. Create RELEASE.md from template
# 3. Fill Section 1 (Project Snapshot) first

Updating an Existing Release

  1. Read the current RELEASE.md
  2. Identify which section(s) need updates
  3. Update only those sections
  4. Note changes in Document History (Section 18)

Core Principles

  1. Never fabricate data — Leave sections blank if information is missing
  2. Be proactive — Fill sections as information becomes available
  3. Respect sharing tags — [INTERNAL], [SHAREABLE], [OPS] control distribution
  4. One document per release — All release info lives in RELEASE.md
  5. Always confirm the release — Before making changes, confirm which release.

Sharing Tags

Tag Meaning
[INTERNAL] Scrub before sharing externally
[SHAREABLE] Safe for publicists, DSPs, management, agents
[OPS] Operations/production team reference

Document Sections

Section Purpose Sharing
1. Project Snapshot Core release info SHAREABLE
2. Release Identifiers & Metadata UPCs, ISRCs, track data OPS
3. Narrative & Positioning Pitch, story, comparables SHAREABLE
4. Artist Background Bio, streaming history SHAREABLE
5. Audience & Market Data Demographics, geo data SHAREABLE
6. DSP & Streaming Strategy Pitches, playlist targets SHAREABLE
7. Marketing Strategy Campaign goals, KPIs INTERNAL
8. Social & Digital Marketing Organic, paid, influencer INTERNAL
9. PR & Media Relations Press targets, materials SHAREABLE
10. Visual & Creative Assets Artwork, videos, canvases SHAREABLE
11. Physical Production Vinyl, CD, cassette specs OPS/INTERNAL
12. Merch Items, strategy INTERNAL
13. Experiential & OOH Events, billboards INTERNAL
14. Touring & Live Dates, venues, routing SHAREABLE
15. Team Contacts All stakeholders INTERNAL
16. Budget Overview Allocated/spent/remaining INTERNAL
17. Performance Tracking Weekly KPIs, learnings INTERNAL
18. Links & Resources Hub All asset links —

Generating Deliverables

See references/deliverables.md for output patterns:

  • DSP Pitch — Pull from Sections 1, 3, 4, 5, 6
  • Press One-Sheet — Pull from Sections 1, 3, 4, 9, 10
  • Physical Production Spec — Pull from Sections 2, 11
  • Marketing Brief — Pull from Sections 1, 3, 5, 6, 7, 8
  • Tour Marketing Brief — Pull from Sections 1, 3, 5, 14

When generating any deliverable:

  1. Check RELEASE.md for required data
  2. Identify missing fields
  3. Request missing info from user OR generate with gaps noted
  4. Format per deliverable spec

Template

The full release template is in references/release-template.md. Copy this file to start a new release.

Section Deep-Dive

See references/section-guide.md for detailed guidance on each section, including:

  • What each field means
  • Common data sources
  • Best practices for filling out
  • Red flags to watch for

Workflows

New Release Setup

  1. Copy template → RELEASE.md
  2. Fill Section 1 (Project Snapshot)
  3. Fill Section 2.2 (Track Metadata) as available
  4. Draft Section 3 (Narrative & Positioning)
  5. Pull artist data for Sections 4-5
  6. Build DSP pitch (Section 6)
  7. Continue through remaining sections as timeline progresses

Pre-Release Checklist

Before announcement, verify these sections are complete:

  • Section 1: All dates confirmed
  • Section 2: UPC assigned, ISRCs for all tracks
  • Section 3: Pitch and narrative finalized
  • Section 6: DSP pitch submitted
  • Section 9: Press materials ready
  • Section 10: All visual assets delivered

Release Week Checklist

  • Section 6: Pre-save links live
  • Section 7: Phase 2 actions executing
  • Section 8: Paid ads launched
  • Section 9: Press embargo lifted
  • Section 17: Tracking dashboard ready

Post-Release

  • Section 17: Weekly KPIs logged
  • Section 17: Wins and learnings documented
  • Document History updated

Example Interactions

Creating a new release

User: "Create a RELEASE.md for the new album 'Decisions'"

Process:

  1. Release = "Decisions", slug = decisions
  2. Create releases/decisions/RELEASE.md from template
  3. Ask: "What's the release date?" (to fill Section 1)

Adding metadata

User: "Update the 'Sunrise' RELEASE.md with these ISRCs"

Process:

  1. Release = "Sunrise", slug = sunrise
  2. Open releases/sunrise/RELEASE.md
  3. Update Section 2.2 with ISRC data
  4. If file not found → "No RELEASE.md for 'Sunrise'. Should I create one?"

Generating a deliverable

User: "Generate a DSP pitch from the Midnights RELEASE.md"

Process:

  1. Read releases/midnights/RELEASE.md
  2. Pull data from Sections 1, 3, 4, 5, 6
  3. Format per deliverables.md spec
  4. If missing fields → "Missing [fields]. Proceed with gaps noted?"

Checking release status

User: "What's missing from the 'For All The Dogs' release doc?"

Process:

  1. Read releases/for-all-the-dogs/RELEASE.md
  2. Run through Pre-Release Checklist
  3. Report incomplete sections