music-recommender

Generate personalized playlists from Spotify and Last.fm metadata by mood, scene, and preferences.

18|6|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/alter123-zz/RaccoonClaw --skill music-recommender-alter123-zz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: music-recommender
Source: https://github.com/alter123-zz/RaccoonClaw/tree/main/skills/music-recommender
Command: npx skills add https://github.com/alter123-zz/RaccoonClaw --skill music-recommender-alter123-zz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Quickly curate personalized music selections without manual searching by matching songs to a user's mood, scene, and listening preferences, saving time and improving listening relevance.

Core Features & Use Cases

  • API-driven music data: Fetch metadata and recommendations from Spotify and Last.fm to surface relevant tracks and artists.
  • Scene and mood-aware playlists: Create playlists tailored for work, workout, commute, sleep, or emotional states like relaxed, happy, or energetic.
  • Style and tempo matching: Filter and rank tracks by BPM, energy, and emotion tags to ensure consistent listening experience.
  • Command-line utility: Provide recommend, playlist, and mood commands to generate recommendations and persist simple usage records for auditing or refinement.
  • Use Case: Generate a 30-minute focused-work playlist that emphasizes low energy and steady BPM for improved concentration.

Quick Start

Create a 10-track relaxed office playlist suitable for focused work.

Frequently Asked Questions about music-recommender

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a mood-based playlist using Spotify metadata?

Generate mood-based playlists by fetching track metadata from the Spotify API and filtering songs by BPM, energy, and emotion tags to match your specified scene or mood. This produces a personalized playlist tailored to your listening scenario.

Can I create a focused work playlist with low energy and steady BPM?

Yes, you can create a focused work playlist by applying filters for low energy and steady BPM to the recommended tracks. This ensures a consistent listening experience suitable for concentration and deep work sessions.

Do I need Spotify and Last.fm API keys to get music recommendations?

Yes, integrating with external music metadata sources like Spotify and Last.fm requires valid API credentials to fetch track data, artist information, and recommendations needed to generate personalized playlists.

How does filtering by BPM and energy tags improve music recommendations?

Filtering by BPM, energy, and emotion tags ranks tracks to ensure a consistent listening experience matching your desired mood or scene. This style and tempo matching prevents jarring transitions in your generated playlist.

What's the best way to curate music for specific scenarios like commuting or sleep?

The best way to curate music for scenarios like commuting or sleep is using scene-aware recommendation commands that match tracks to specific emotional states and activities, saving time compared to manual searching.

Does the music recommender save my playlist generation history?

Yes, the music recommender persists basic usage records in a local data directory when generating recommendations and playlists. This auditing data helps refine future music recommendations based on your past listening preferences.