@soulcraft/kits 1.0.0

package/kits/music-collection/skills/music-metadata/SKILL.md

@@ -0,0 +1,209 @@
+---
+name: music-metadata
+description: Background expertise in music metadata, genres, and album relationships
+type: background
+version: "1.0.0"
+---
+
+## Music Metadata Expertise
+
+You have expertise in music cataloging, metadata standards, and genre classification. Apply these principles when helping users organize their music collections.
+
+### Core Metadata Fields
+
+**Essential Fields**
+- Artist name (primary)
+- Album title
+- Track title
+- Track number
+- Disc number (for multi-disc)
+- Year/release date
+- Genre
+
+**Extended Fields**
+- Album artist (for compilations)
+- Composer
+- Conductor (classical)
+- Record label
+- Catalog number
+- ISRC code
+- MusicBrainz IDs
+
+**Optional/Enrichment**
+- Mood/energy tags
+- BPM/tempo
+- Key signature
+- Lyrics
+- Album art
+- Credits
+
+### Artist Name Conventions
+
+**Standard Format**
+- Last, First for classical: "Bach, Johann Sebastian"
+- First Last for popular: "David Bowie"
+- Stage names as-is: "Prince"
+- The band: "The Beatles" (sort as "Beatles, The")
+
+**Collaborations**
+- Featured: "Artist A feat. Artist B"
+- Collaboration: "Artist A & Artist B"
+- Various: "Various Artists" for compilations
+
+**Consistency Rules**
+- Pick one spelling and stick to it
+- Handle special characters consistently
+- Note: "Beyoncé" not "Beyonce"
+
+### Album Types
+
+**Studio Album**
+- Original recordings
+- Primary release
+
+**Live Album**
+- Concert recordings
+- Include venue/date if known
+
+**Compilation**
+- Best of/greatest hits
+- Box sets
+- Themed collections
+
+**EP (Extended Play)**
+- 4-6 tracks typically
+- More than single, less than album
+
+**Single**
+- Primary track + B-sides
+- May include remixes
+
+**Soundtrack**
+- Film, TV, game scores
+- Note source in album title or genre
+
+**Remix Album**
+- Remixed versions of existing tracks
+
+### Genre Classification
+
+**Top-Level Genres**
+- Rock, Pop, Electronic, Hip-Hop/Rap, R&B/Soul
+- Jazz, Classical, Country, Folk, World
+- Metal, Punk, Blues, Reggae
+
+**Subgenre Specificity**
+- Be specific enough to be useful
+- "Shoegaze" better than just "Rock"
+- "Neo-Soul" better than just "R&B"
+- But don't over-specify
+
+**Multiple Genres**
+- Many systems support multiple genres
+- Order by relevance
+- "Alternative Rock; Dream Pop"
+
+### Genre Hierarchies
+
+**Rock Family**
+```
+Rock
+├── Alternative Rock
+│   ├── Indie Rock
+│   ├── Shoegaze
+│   └── Post-Punk
+├── Classic Rock
+├── Hard Rock
+│   └── Metal (sometimes separate)
+└── Progressive Rock
+```
+
+**Electronic Family**
+```
+Electronic
+├── House
+│   ├── Deep House
+│   └── Tech House
+├── Techno
+├── Ambient
+├── Drum & Bass
+└── IDM
+```
+
+### Release Relationships
+
+**Original vs. Remaster**
+- Note remaster in album title or field
+- Keep original year, note remaster year
+- "Kind of Blue (2020 Remaster)"
+
+**Deluxe/Expanded Editions**
+- Treat as separate release
+- Include edition in title
+- Note bonus tracks
+
+**Regional Variations**
+- Different tracklists by country
+- Different artwork
+- Note region if relevant
+
+### Date Handling
+
+**Original Release Date**
+- When album first came out
+- Use this for sorting/organization
+
+**This Release Date**
+- When this version came out
+- Important for remasters
+
+**Recording Date**
+- When tracks were recorded
+- Important for classical, jazz, live
+
+### Classical Music Considerations
+
+**Work Information**
+- Composer (primary "artist")
+- Composition name
+- Opus/catalog number
+- Movement names
+
+**Performer Credits**
+- Orchestra
+- Conductor
+- Soloists
+
+**Example Format**
+- Composer: Beethoven, Ludwig van
+- Album: Symphony No. 9 in D minor, Op. 125
+- Track: IV. Presto - Allegro assai
+
+### Compilation Handling
+
+**Various Artists Albums**
+- Album artist: "Various Artists"
+- Track artist: Individual artists per track
+- Maintains album unity while crediting artists
+
+**Artist Best-Ofs**
+- Album artist: The artist
+- Note "Compilation" in album type
+- Include original album in comments if desired
+
+### Tagging Best Practices
+
+**Consistency**
+- Same artist name across all albums
+- Same genre terminology
+- Consistent date formats
+
+**Accuracy**
+- Verify against discogs/musicbrainz
+- Check spelling carefully
+- Original language for foreign artists
+
+**Completeness**
+- Fill all applicable fields
+- Don't leave blank what can be found
+- Use "Unknown" rather than blank if needed

package/kits/music-collection/skills/playlist-curator/SKILL.md

@@ -0,0 +1,182 @@
+---
+name: playlist-curator
+description: Create themed playlists from music collections with good flow and variety
+type: invocable
+version: "1.0.0"
+---
+
+## Playlist Curator Skill
+
+When the user invokes `/playlist`, help them create well-curated playlists with good flow, variety, and thematic coherence.
+
+### Invocation Patterns
+
+- `/playlist [theme]` - Create themed playlist
+- `/playlist mood [mood]` - Mood-based playlist
+- `/playlist mix` - Balanced variety playlist
+- `/playlist [event]` - Event-specific playlist
+
+### Playlist Curation Principles
+
+**Flow & Pacing**
+- Energy arc (build up, peak, cool down)
+- Tempo progression
+- Key compatibility (optional, for seamless mixes)
+- Avoid jarring transitions
+
+**Variety Within Theme**
+- Different artists
+- Different eras/decades
+- Different subgenres
+- Different tempos
+
+**Cohesion**
+- Unified mood or theme
+- Consistent sound palette
+- Logical sequencing
+
+### Output Format
+
+```markdown
+## Playlist: [Title]
+
+### Concept
+- **Theme**: [Description]
+- **Mood**: [Energy/feeling]
+- **Duration**: [Total time]
+- **Best for**: [Use case]
+
+### Track List
+
+| # | Track | Artist | Album | BPM | Energy | Notes |
+|---|-------|--------|-------|-----|--------|-------|
+| 1 | [Track] | [Artist] | [Album] | [BPM] | [1-5] | Opener |
+| 2 | [Track] | [Artist] | [Album] | [BPM] | [1-5] | |
+| 3 | [Track] | [Artist] | [Album] | [BPM] | [1-5] | |
+...
+| N | [Track] | [Artist] | [Album] | [BPM] | [1-5] | Closer |
+
+### Playlist Arc
+```
+Energy
+  ▲
+5 │       ●●●
+4 │     ●     ●●
+3 │   ●         ●●
+2 │ ●              ●
+1 │●                ●
+  └─────────────────────→ Time
+   Opening  Peak  Cooldown
+```
+
+### Flow Notes
+- Tracks 1-3: [Description of opening]
+- Tracks 4-7: [Building energy]
+- Tracks 8-12: [Peak energy]
+- Tracks 13-15: [Winding down]
+
+### Key Transitions
+- Track 3→4: [Why this works]
+- Track 8→9: [Why this works]
+
+### Variety Check
+- Artists: [X] unique artists
+- Decades: [Spread]
+- Subgenres: [List]
+
+### Alternative Tracks
+If [track] isn't available:
+- Try: [Alternative 1]
+- Or: [Alternative 2]
+```
+
+### Playlist Types
+
+**Mood Playlists**
+- Chill/Relaxation
+- Energy/Workout
+- Focus/Study
+- Sad/Melancholy
+- Happy/Upbeat
+- Romantic
+
+**Activity Playlists**
+- Morning routine
+- Dinner party
+- Road trip
+- Cooking
+- Cleaning
+- Work from home
+
+**Theme Playlists**
+- Decade-specific (80s, 90s, etc.)
+- Genre deep-dive
+- Artist appreciation
+- Seasonal (summer, winter)
+- Event (wedding, birthday)
+
+### Playlist Length Guidelines
+
+| Use Case | Tracks | Duration |
+|----------|--------|----------|
+| Quick listen | 8-12 | 30-45 min |
+| Background | 20-30 | 1.5-2 hrs |
+| Event | 40-60 | 3-4 hrs |
+| Extensive | 100+ | 6+ hrs |
+
+### Sequencing Techniques
+
+**Energy Management**
+1. Start medium energy (welcoming)
+2. Build gradually
+3. Peak in middle third
+4. Provide valleys for contrast
+5. End with memorable closer
+
+**The DJ Approach**
+- Match BPMs for flow (±10 BPM)
+- Complementary keys
+- Similar energy adjacent
+- Gradual transitions
+
+**The Storytelling Approach**
+- Opening sets scene
+- Middle develops themes
+- Climax delivers payoff
+- Denouement resolves
+
+### Avoiding Common Mistakes
+
+**Don't**
+- Put all high-energy tracks together
+- Repeat same artist consecutively
+- Ignore song length variety
+- End with a dud
+- Forget about transitions
+
+**Do**
+- Create intentional contrast
+- Space out similar sounds
+- Include unexpected choices
+- End memorably
+- Listen through completely
+
+### Event-Specific Tips
+
+**Dinner Party**
+- Background level energy
+- No sudden loud tracks
+- Avoid controversial lyrics
+- 3-4 hours of music
+
+**Workout**
+- High energy throughout
+- Build to peak at hardest part
+- 130-150 BPM range
+- Clear beats
+
+**Focus/Study**
+- No or minimal lyrics
+- Consistent energy
+- Ambient or lo-fi works well
+- Long enough to not repeat

package/kits/music-collection/skills/recommend-similar/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: Recommend Similar Music
+description: Suggest albums or artists based on your favorites
+type: invocable
+version: "1.0.0"
+---
+
+## Recommend Similar Music
+
+Suggest albums or artists based on your favorites
+
+### Steps
+
+1. Review the user's existing favorites and ratings
+2. Identify patterns in their taste (genres, eras, moods)
+3. Consider influences and connections between artists they like
+4. Suggest 3-5 albums they might not know
+5. Explain why each recommendation fits their taste
+6. Offer to add any recommendations to their discovery list
+
+### Inputs Required
+
+- **basedOn** (optional): Artist or album to base recommendations on
+
+### Expected Outputs
+
+- Recommendation list with explanations
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "recommend"
+- "similar to"
+- "what else"
+- "if I like"
+- "suggest"