skills.rest
perminder-klair
perminder-klairCOMMUNITY
Explore all skills by this author →
Website𝕏@pinku1GitHub

library-deep-cut

Finds unplayed tracks by the on-air artist in the station's music library.

1.3k|113|Updated May 11, 2026
Search Tags:#radio#icecast#music library#ai dj#play history#on-air#deep cut
One-click install
npx skills add https://github.com/perminder-klair/subwave --skill library-deep-cut
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: library-deep-cut
Source: https://github.com/perminder-klair/subwave/tree/main/controller/src/skills/builtins/library-deep-cut
Command: npx skills add https://github.com/perminder-klair/subwave --skill library-deep-cut

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Radio DJs want to tease deeper catalog material from the current artist, but manually checking which tracks have gone unplayed is tedious. This Skill surfaces library tracks by the on-air artist that have not been played in the last 30 days, giving the DJ a natural one-line tease.

Core Features & Use Cases

  • Cold-track detection: Walks the on-air artist's albums via the library service and filters out anything played in the last 30 days.
  • Bounded results: Returns at most six candidate tracks plus a count, and reports available: false when the artist has nothing cold to surface.
  • Safe on-air behavior: The DJ teases the deep cut in one sentence without naming the track unless exactly one candidate is found, and never characterizes how it sounds.
  • Use Case: While a track by an artist is playing, the DJ mentions that there is more worth digging out of that artist's catalog, creating anticipation without spoiling the surprise.

Quick Start

Enable the library-deep-cut skill so the DJ occasionally teases an unplayed track from the current artist's catalog between songs.

Frequently Asked Questions about library-deep-cut

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

FAQPage Schema
How do I find unplayed songs by an artist in my music library?▼

The skill resolves the on-air artist through the library service, walks up to eight of their albums, and filters out any track whose ID or title-artist key appears in the last 30 days of play history. It returns up to six cold candidates plus a count.

What does the DJ say when a deep cut is found?▼

The DJ delivers a one-sentence tease suggesting there is more worth digging out of the artist's catalog, without promising when it will play. The track is only named when exactly one candidate is surfaced, and its sound is never characterized.

What happens if the artist has no unplayed tracks?▼

The tool returns available: false when the artist cannot be resolved, has no albums, or every track has been played within 30 days. In that case the DJ simply skips the tease.

How often does the library deep-cut tease run?▼

The skill has a 90-minute cooldown configured in its frontmatter, so the tease can only fire once per hour and a half at most, keeping the on-air patter from becoming repetitive.

Does the deep-cut search work with unknown or missing artist metadata?▼

No. If the now-playing artist name is missing or matches an unknown-artist pattern, the tool immediately returns available: false rather than guessing against the library.

Related Skills

Explore More Content & Communication Skills→
zocomputerzocomputer
45

lastfm

Query Last.fm listening history, top artists, and similar artists via API.

Official
Intermediate
drndrn
23

tts

Convert text into speech with adjustable rate and voice selection.

Community
Basic
zhouguoqingzhouguoqing
23

weather-query

Fetches real-time weather data and forecasts for Chinese cities and districts.

Community
Intermediate
adraalabsadraalabs
2

music-queue

Manage song request queues, voting, and now-playing displays.

Official
Intermediate