@olegkoval/agent-skills 1.35.2 → 1.36.0

package/plugins/olko-creative/skills/music-to-plex/references/youtube-full-album-fallback.md

@@ -0,0 +1,34 @@
+# YouTube full-album fallback salvage
+
+Use this when RuTracker / Download Station fails and the only practical source is a YouTube full-album upload.
+
+## Pattern observed
+
+- `yt-dlp` can pull a clean album source, but uploader metadata is often garbage.
+- Treat the first download as a source artifact, not Plex-ready media.
+- Validate tags with `ffprobe` or `mutagen` before any organize step.
+
+## Repair flow
+
+1. Download the upload at highest audio quality.
+2. Inspect embedded metadata immediately.
+3. If the output is one long FLAC, split it into tracks using album track timings.
+4. Retag each track with canonical artist, album, year, tracknumber, and tracktotal.
+5. Embed official cover art, not the YouTube thumbnail.
+6. Move the repaired album into the final NAS music path.
+7. Refresh Plex only after the final path exists.
+8. Verify the album appears in Plex search.
+
+## NAS transfer workaround
+
+When `rsync` or `scp` fights remote path quoting, use a tar pipe instead:
+
+```bash
+cd /local/staging && tar -cf - *.flac | ssh user@nas 'cd "/volume1/music/.../Release" && tar -xf -'
+```
+
+If macOS leaves AppleDouble sidecar files on the NAS, remove `._*` before refresh.
+
+## Session note
+
+For `Ozzy Osbourne - Diary Of A Madman (1981)`, the fallback source was a YouTube full-album upload. The tracks were downloaded to FLAC, retagged, cover art embedded, copied into `/volume1/music/metal/Ozzy Osbourne/Diary Of A Madman (1981)`, AppleDouble files removed, and Plex refreshed with `mtp refresh --path`.

package/plugins/olko-creative/skills/music-to-plex/references/youtube-lineage-playlist-fallback.md

@@ -0,0 +1,33 @@
+# YouTube-only lineage playlist fallback
+
+Use when the user wants a new DJ crate or playlist based on mood/lineage rather than a formal release request, and the intended path is YouTube track finding/downloading only.
+
+## Trigger
+
+- The user says things like "check this message and create new playlist" and provides lane/feeling language instead of a single album.
+- The brief is built from references, influences, or lineage tags such as "classic deep house DNA", "modern disco/deep house revival", "jazzy/warm cuts", or a left-field closer.
+- The task is explicitly on the YouTube branch, not a tracker or store purchase flow.
+
+## Pattern
+
+1. Convert the message into a small set of lanes first.
+2. Pick 1-3 anchor artists or canonical tracks per lane.
+3. Search exact titles with `yt-dlp`/YouTube query strings before broadening the search.
+4. Prefer official or Topic uploads, then the cleanest stable upload with the closest duration and metadata match.
+5. Assemble a local crate manifest, tracklist, and playlist file.
+6. Verify the files exist and the playlist content matches the intended lane order.
+
+## Curation notes
+
+- Keep the middle of the set mix-friendly.
+- Use the final lane for the emotional curveball or taste-flex closer.
+- If the user explicitly says the branch is YouTube-only, do not route through tracker/search paths for acquisition.
+- If Spotify or another catalog route is unavailable, skip it and continue with the YouTube branch instead of stalling.
+
+## File outputs
+
+- `00_MANIFEST.json`
+- `00_TRACKLIST.md`
+- `00_PLAYLIST.m3u8`
+
+This reference is session-derived but the pattern is reusable for future YouTube-only crate builds.

package/plugins/olko-creative/skills/music-to-plex/references/youtube-playlist-import.md

@@ -0,0 +1,50 @@
+# YouTube-first playlist import for MTP
+
+Use this flow when the user gives a YouTube playlist URL or a plain track list and wants it landed in Plex.
+
+## Input shapes
+- Playlist URL
+- Plain list of `Artist - Title` lines
+
+If only a track list is provided, resolve each track on YouTube first, then download in album/sequence order.
+
+## Download + staging
+Use max-quality audio extraction and preserve ordering with explicit numbering:
+
+```bash
+yt-dlp -x --audio-format flac --audio-quality 0 \
+  --write-thumbnail --convert-thumbnails jpg --embed-thumbnail \
+  --add-metadata \
+  -o "/tmp/mtp_youtube_crates/<crate>/work/raw/%(playlist_index)02d - %(title)s.%(ext)s" \
+  "<youtube-url>"
+```
+
+Notes:
+- Keep a manifest with index, source URL, resolved artist/title, and final filename.
+- For VA / DJ-style sets, keep track order stable even if metadata is messy.
+- If a title needs cleanup, fix it in tags, not by renaming out of sequence.
+
+## Import into Plex
+- Copy the finalized files into the NAS import path that Plex scans for the music section.
+- Trigger a library scan after the copy.
+- Create a normal Plex playlist from the imported track rating keys in the exact source order.
+
+## Verification
+Prefer proof over assumptions:
+- Check Plex scanner logs for `Added new metadata item` / `Loaded metadata for ...` on each track.
+- Confirm the imported track by querying Plex search directly and inspecting the returned `ratingKey`, `title`, `originalTitle`, and `parentTitle`.
+- For playlist verification, read the playlist back and enumerate items in order.
+
+## Plex metadata quirks
+- For compilation-style sets, Plex often shows `grandparentTitle=Various Artists`.
+- The displayed `title` may be the track title, while `originalTitle` carries the artist.
+- Search by both artist and title when matching imported tracks.
+- If a search query misses a track, try the cleaned title and artist separately.
+
+## Session-proven pattern
+The Deep Lineage Set import worked by:
+1. staging 8 FLAC tracks from YouTube,
+2. copying the final files into a Plex-scanned NAS import directory,
+3. refreshing Plex,
+4. creating a playlist in the source order,
+5. verifying all 8 items and their order.

package/plugins/olko-creative/skills/music-to-plex/references/youtube-track-resolution-heuristics.md

@@ -0,0 +1,23 @@
+# YouTube track resolution heuristics
+
+Use this when a user gives a plain `Artist - Title` list and wants it turned into a Plex playlist.
+
+## Search pattern
+- Run `yt-dlp --flat-playlist --dump-json "ytsearch5:<artist> <title>"` for each line.
+- Keep the source order from the user list. Never reorder by search result rank.
+
+## Scoring
+Prefer results with:
+1. exact title match,
+2. artist match in the channel/uploader name,
+3. `Topic` channel or official upload,
+4. clean metadata over remix/edit clutter.
+
+## Pitfalls
+- The first search hit is often wrong for house/disco catalog cuts.
+- If the user only gives a vibe list and not a playlist name, derive a short title from the theme, then ask once before creating the Plex playlist.
+- For compilation-style uploads, check both title and channel before deciding.
+
+## Verification
+- After download, confirm each track title still maps to the intended line.
+- When building the Plex playlist, read it back and verify item order matches the source list.

package/plugins/olko-creative/skills/music-to-plex/references/zero-track-playlist-recovery.md

@@ -0,0 +1,21 @@
+# Zero-track playlist recovery
+
+Use this when Plex shows a playlist shell but the track list is empty or `0 tracks`.
+
+## What it means
+
+- The playlist object exists.
+- The import likely failed to attach playable items, or the items have not been indexed yet.
+- Do not treat the playlist as done until Plex returns leaf items.
+
+## Recovery order
+
+1. Read back the playlist with `GET /playlists/<id>/items`.
+2. Confirm the returned leaf count matches the source track count.
+3. Compare the returned order with the intended playlist order.
+4. If the playlist is still empty, re-check the source track `ratingKey` list before trying another create.
+5. If the UI says `0 tracks` but the API returns items, trust the API and let PlexAmp refresh.
+
+## Rule
+
+A playlist is only imported when the API read-back shows the expected number of items and order. The UI tile alone is not proof.

package/plugins/olko-garmin-kit/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-garmin-kit",
   "description": "Build, test and publish Garmin Connect IQ watch faces.",
-  "version": "1.35.2",
+  "version": "1.36.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-git-tools/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-git-tools",
   "description": "Everyday git and GitHub CLI operations: conventional commits, branch hygiene.",
-  "version": "1.35.2",
+  "version": "1.36.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-github-pr/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-github-pr",
   "description": "Drive GitHub pull requests to merge-ready: review-bot loops, CI fixes, descriptions, dependency triage.",
-  "version": "1.35.2",
+  "version": "1.36.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-obsidian/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-obsidian",
   "description": "Keep an Obsidian vault in sync with work: PR sync, task rollover, morning routine.",
-  "version": "1.35.2",
+  "version": "1.36.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-product/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-product",
   "description": "Take a product idea to a shippable build: MVP passes, full-stack scaffolds, launch plans.",
-  "version": "1.35.2",
+  "version": "1.36.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-reflection/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-reflection",
   "description": "Look back and improve: self-critique, retrospectives, performance review, rapid learning.",
-  "version": "1.35.2",
+  "version": "1.36.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-release/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-release",
   "description": "Ship a release: semantic-release setup, changelogs, store listing copy, release-day routine.",
-  "version": "1.35.2",
+  "version": "1.36.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-skill-meta/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-skill-meta",
   "description": "Author and maintain agent skills and the AI toolchain itself.",
-  "version": "1.35.2",
+  "version": "1.36.0",
   "author": {
     "name": "Oleg Koval"
   },

package/plugins/olko-web-ops/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-web-ops",
   "description": "Operate a website: WAF rules, search console audits, analytics bootstrap, docs indexes.",
-  "version": "1.35.2",
+  "version": "1.36.0",
   "author": {
     "name": "Oleg Koval"
   },

package/scripts/lib/catalog.mjs

@@ -45,7 +45,7 @@ export const PLUGIN_ASSIGNMENT = {
   },
   'olko-creative': {
     description: 'Creative and personal projects: photo galleries, music players, listings, wiki editing.',
-    skills: ['gallery', 'fill-music-player', 'vinted-listing', 'wikipedia-uk-editor'],
+    skills: ['gallery', 'fill-music-player', 'music-to-plex', 'vinted-listing', 'wikipedia-uk-editor'],
   },
   'olko-web-ops': {
     description: 'Operate a website: WAF rules, search console audits, analytics bootstrap, docs indexes.',