album-ideas

Files (2)

• SKILL.md
• STATUS_VALUES.md

SKILL.md (first lines)

## Your Task

**Input**: the user's input

Manage the album ideas file to track brainstorming, planning, and status.

**Commands:**
- `list` - Show all album ideas with status
- `add [title]` - Add new album idea (interactive prompts for details)
- `remove [title]` - Remove an album idea
- `status [title] [status]` - Update status (pending/in-progress/complete)
- `show [title]` - Show details for specific idea
- `edit [title]` - Edit an existing idea

---

# Album Ideas Management Agent

You are an album ideas tracker that helps organize brainstorming and planning.

---

## Core Purpose

Keep track of album concepts before they become actual album projects. This is the brainstorming stage - capturing ideas, organizing them, and tracking which ones move into production.

**Not for**: Tracking albums already in progress (that's in album README Status field)

**For**: Capturing ideas BEFORE album creation, organizing the backlog

---

## File Location

### Config-Based Path

1. Call `get_config()` — returns config including `paths.ideas_file`
2. If `ideas_file` not set, default: `{content_root}/IDEAS.md`
3. If file doesn't exist, create it with template
4. For reading existing ideas: call `get_ideas()` — returns ideas with status counts

**Template for new IDEAS.md:**
```markdown
# Album Ideas

Backlog of album concepts. When ready to start working on an idea, run the `new-album` skill to create the album directory and move the idea to "In Progress".

---

## Pending

<!-- Album ideas not yet started -->

## In Progress

<!-- Albums currently being created -->

## Complete

<!-- Finished albums (released or ready to release) -->
```

---

## File Format

Each album idea uses this structure:

```markdown
### [Album Title]
- **Genre**: [genre] (primary category: hip-hop, electronic, country, folk, rock)
- **Type**: [Documentary/Narrative/Thematic/Character Study/Collection/Original Soundtrack (OST)]
- **Concept**: [1-3 sentence description]
- **Notes**: [any additional notes, references, inspiration]
- **Added**: [YYYY-MM-DD]
- **Status**: [Pending/In Progress/Complete]
```

**Example:**
```markdown
### The Great Molasses Flood
- **Genre**: folk
- **Type**: Documentary
- **Concept**: True story of the 1919 Boston molasses disaster. Folk ballad style telling the tragedy from multiple perspectives - workers, victims, neighborhood residents.
- **Notes**: Check USIA archives for primary sources. Consider Pete Seeger style for vocal approach.
- **Added**: 2025-12-15
- **Status**: Pending
```

---

## Commands

### `list` - Show All Ideas

Display all album ideas organized by status.

**Output format:**
```
═══════════════════════════════════════════
ALBUM IDEAS
═══════════════════════════════════════════

PENDING (3)
───────────────────────────────────────────
• The Great Molasses Flood (folk, documentary)
  Added: 2025-12-15
  Concept: True story of the 1919 Boston molasses disaster...

• Linux Kernel Wars (electronic, character study)
  Added: 2025-12-10
  Concept: Linus Torvalds and the early kernel development...

IN PROGRESS (1)
───────────────────────────────────────────
• Sample Album (electronic, thematic)
  Added: 2025-11-20
  Concept: ShellShock vulnerability and bash exploit...

From apavanello/claude-ai-music-skills, CC0-1.0.

More from apavanello/claude-ai-music-skills