.claude/skills/jellyfin/ is a stale divergent copy, not the symlink CLAUDE.md describes — it documents auth that v12 only accepts by legacy opt-in
#617
Closed
opened 2026-07-25 17:27:55 +02:00 by timothy
·
3 comments
No Branch/Tag Specified
main
renovate/dotnet-monorepo
renovate/meziantou.analyzer-3.x
renovate/lucene.net
renovate/sqlitepclraw.bundle_e_sqlite3-3.x
renovate/cliwrap-3.x
913-scripted-playout-401
release/v26.15.0-notes
issue-806-guard-populations
scratch/767b-poisoned
scratch/767b-control
release/v26.14.0-notes
release/v26.14.0
docs/510-skill-logo-bug-policy
fix/510-watermark-resolution-policy
fix/629-verdict-classifier-falseopens
fix/609-decisions-edit-token-scope
issue-135-clear-to-none
release/v26.12.0-notes
fix/409b-lastscan-api-parity
fix/401-updatechannel-mirror-422
fix/327-playlist-rename-validation
fix/410-scancancel-log-level
fix/409-447-librariesscreen-neverscanned
fix/338-zap-exit-code
fix/367-plex-budget-message
fix/310-debom-legacy-cs
ci/604-lane-rebalance
feat/388-design-mirror
feat/247-test-ownership
feat/247-primary-action
feat/357-player-owned-playback
feat/357-jellyfin-plugin-poc
fix/289-mcp-hardening
issue58-mcp
feat/244-channels-extract
ci/auto-bump-prod-compose
feat/multi-rerun-collections-api
feat/collections-api
feat/quick-wins
feat/185-docs-part2
feat/140-collections-screen
feat/146-channel-edit
feat/147-classic-ui-link
issue22-renovate-dashboard
feat/91-cutover
feat/63-composite-create
feat/65-library-browse
feat/85-epg
feat/86-schedule-editor
feat/109-dashboard-data
feat/99-session-tracking
fix/dockerfile-node-tag
feat/59-spa-foundation
docs/59-ui-redesign-brief
feat/102-json-guide
feat/111-schedule-durations
feat/104-artwork-upload
feat/103-media-sources-api
feat/playouts-read-api
feat/108-health-api
feat/105-picker-list-endpoints
issue-97-channel-state-api
issue42-jellyfin-musicvideos
issue46-rest-api-error-contract
dependabot/nuget/ErsatzTV.FFmpeg.Tests/multi-d307a2e06f
qsv-improvements
hdr-vulkan-cuda-test
v26.16.0
v26.15.0
v26.14.0
v26.13.0
v26.12.0
v26.11.0
v26.10.0
v26.9.0
v26.8.0
v26.7.0
blazor-final
v26.6.0
v26.5.0
v26.4.0
v26.3.1
v26.3.0
v26.2.0
v26.1.1
v26.1.0
v25.9.0
v25.8.0
v25.7.1
v25.7.0
v25.6.0
v25.5.0
v25.4.0
v25.3.1
v25.3.0
v25.2.0
v25.1.0
v0.8.8-beta
v0.8.7-beta
v0.8.6-beta
v0.8.5-beta
v0.8.4-beta
v0.8.3-beta
v0.8.2-beta
v0.8.1-beta
v0.8.0-beta
v0.7.9-beta
v0.7.8-beta
v0.7.7-beta
v0.7.6-beta
v0.7.5-beta
v0.7.4-beta
v0.7.3-beta
v0.7.2-beta
v0.7.1-beta
v0.7.0-beta
v0.6.9-beta
v0.6.8-beta
v0.6.7-beta
v0.6.6-beta
v0.6.5-beta
v0.6.4-beta
v0.6.3-beta
v0.6.2-beta
v0.6.1-beta
v0.6.0-beta
v0.5.8-beta
v0.5.7-beta
v0.5.6-beta
v0.5.5-beta
v0.5.4-beta
v0.5.3-beta
v0.5.2-beta
v0.5.1-beta
v0.5.0-beta
v0.4.5-alpha
v0.4.4-alpha
v0.4.3-alpha
v0.4.2-alpha
v0.4.1-alpha
v0.4.0-alpha
v0.3.8-alpha
v0.3.7-alpha
develop
v0.3.6-alpha
v0.3.5-alpha
v0.3.4-alpha
v0.3.3-alpha
v0.3.2-alpha
v0.3.1-alpha
v0.3.0-alpha
v0.2.5-alpha
v0.2.4-alpha
v0.2.3-alpha
v0.2.2-alpha
v0.2.1-alpha
v0.2.0-alpha
v0.1.5-alpha
v0.1.4-alpha
v0.1.3-alpha
v0.1.2-alpha
v0.1.1-alpha
v0.1.0-alpha
v0.0.62-alpha
v0.0.61-alpha
v0.0.60-alpha
v0.0.59-alpha
v0.0.58-alpha
v0.0.57-alpha
v0.0.56-alpha
v0.0.55-alpha
v0.0.54-alpha
v0.0.53-alpha
v0.0.52-alpha
v0.0.51-alpha
v0.0.50-alpha
v0.0.49-prealpha
v0.0.48-prealpha
v0.0.47-prealpha
v0.0.46-prealpha
v0.0.45-prealpha
v0.0.44-prealpha
v0.0.43-prealpha
v0.0.42-prealpha
v0.0.41-prealpha
v0.0.40-prealpha
v0.0.39-prealpha
v0.0.38-prealpha
v0.0.37-prealpha
v0.0.36-prealpha
v0.0.35-prealpha
v0.0.34-prealpha
v0.0.33-prealpha
v0.0.32-prealpha
v0.0.31-prealpha
v0.0.30-prealpha
v0.0.29-prealpha
v0.0.28-prealpha
v0.0.27-prealpha
v0.0.26-prealpha
v0.0.25-prealpha
v0.0.24-prealpha
v0.0.23-prealpha
v0.0.22-prealpha
v0.0.21-prealpha
v0.0.20-prealpha
v0.0.19-prealpha
v0.0.18-prealpha
v0.0.17-prealpha
v0.0.16-prealpha
v0.0.15-prealpha
v0.0.14-prealpha
v0.0.13-prealpha
v0.0.12-prealpha
v0.0.11-prealpha
v0.0.10-prealpha
v0.0.9-prealpha
v0.0.8-prealpha
v0.0.7-prealpha
v0.0.6-prealpha
v0.0.5-prealpha
v0.0.4-prealpha
v0.0.3-prealpha
v0.0.2-prealpha
v0.0.1-prealpha
Labels
Clear labels
ad-hoc
api
bug
ci-cd
content
dependencies
enhancement
frontend
in-progress
jellyfin
parked
priority: high
priority: low
priority: medium
review
security
One-off / ad-hoc work not tracked by a dedicated issue
REST API / HTTP endpoints
Something isn't working
Build, test, deploy pipeline
Channel content / schedules / playlists
Dependency updates (Renovate)
New feature or improvement
ChicoryTV React SPA frontend
Claimed by an active session — do not pick up
Jellyfin tuner / IPTV integration
Excluded from automatic queue pickup; work only when explicitly selected
Adversarial review finding
Security / vulnerability fix
Milestone
No items
No Milestone
Projects
Clear projects
No projects
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: timothy/ersatztv#617
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
CLAUDE.md→ Project Boundaries says:It is not a symlink.
/Users/timothy/ersatztv/.claude/skills/jellyfin/is a real directory holding a stale fork of the canonical~/server-management/.claude/skills/jellyfin/SKILL.md.Divergence
X-Emby-Tokenpresented as the patternAuthorization: MediaBrowser Token="…", withX-Emby-Tokenmarked legacyjellyfin/jellyfin:12.0-rc2(migrated off linuxserver in #478)DELETE /Items/{id}data-loss warningWhy it matters
Two of these are actively misleading:
X-Emby-Tokenand?api_key=with 401 unlessEnableLegacyAuthorization=true. That flag is currently ON, so the stale copy's examples still work — but it is slated for removal in v13, and the local copy gives no hint that the pattern is deprecated. (I usedX-Emby-Tokenthroughout #487 on that basis; it worked, but only incidentally.)DELETE /Items/{id}warning. The canonical file leads with it because it has destroyed files three times. A session reading only the ersatztv copy never sees it.The Live TV section is also wrong in a way that would cause duplicate channels if acted on.
Fix
Replace the directory with a symlink to the canonical copy, restoring the documented intent:
Worth checking the other cross-repo skills (
ersatztv, and anything else CLAUDE.md claims is symlinked) for the same drift at the same time — this one presumably started as a symlink and got materialised by some copy operation.Not done in-session because it deletes a checked-in tree and rewires another repo's skill, which is an operator call rather than part of #487.
Done-when
.claude/skills/jellyfinis a symlink to the server-management copy — relative symlink (mode120000), matching thebeets/radarr/sonarrpattern. PR fix(617): make the cross-repo skills real symlinks and reconcile the ersatztv skill (#639)ersatztvandjellyfinare cross-repo (closing-an-issueis ersatztv-local with no duplicate).ersatztvreconciled and made canonical here; server-management symlinks to itReview-verdict: MERGEABLE @ 01fb07a; the pass found and fixed a real YAML-frontmatter defect (see PR)Evidence for the second Done-when box: the
ersatztvskill has the same drift, and it is worseFound while running the completion checks for #616 (which asks whether a discovered API gotcha belongs in a skill file). This issue's second box — "Other skills CLAUDE.md claims are symlinked are checked for the same drift" — is now answered for
ersatztv: it is also a real directory, not a symlink, and the two copies have diverged in BOTH directions.Unlike the jellyfin case, neither copy is simply "the stale one":
/api/v1with write paths; "do not hand-edit SQLite for something the API can do"/appis the only UIForwardedHeaders__KnownNetworksWhy the server-management copy is the more harmful one. Its
description:is what the model reads when deciding to load the skill, and it says CRUD requires SQLite DB scripting. That actively routes a session toward hand-editing the prod SQLite for operations the API has supported since the REST work landed — against a WAL-mode, root-owned DB on a live channel server. The jellyfin drift in this issue hid aDELETE /Itemswarning; this one advertises a riskier path as the normal one.So a straight
rm -rf+ symlink in either direction loses correct content. This one needs a reconcile-then-symlink, not a replace — worth deciding which repo is canonical for it (CLAUDE.md→ Project Boundaries says ersatztv OWNS the ErsatzTV skill in server-management, i.e. content owner and host repo differ, which is probably how it drifted).Please carry these into the reconciled copy (from #616, merged as PR #635)
The skill documents
GET /api/v1/playoutsandPOST /api/v1/channels/{id}/playout/resetadjacently but says nothing about paging or id spaces. Both are now settled inapi.paging-zero-based:pageNumis 0-based. Starting at 1 silently skips a page and returns a short set with no error.pageSizeis clamped per-endpoint (100 typical, 200 auto-tune members, 1000 search/all-items); the offset derives from the effective size. Page to completeness againsttotalCount.channelId(list since #297; detail since #616) — use that.I deliberately did not patch either copy, because editing one side of a 338-line bidirectional divergence deepens exactly the problem this issue exists to fix.
Claiming — bundled with #615 (shared
jellyfinlabel).Operator decision taken on the canonical-owner question raised in the comment above:
jellyfin→ server-management is canonical. ersatztv's copy is strictly worse (no bidirectional divergence to preserve), so: delete the local tree, replace with a relative symlink.ersatztv→ ersatztv is canonical, matchingCLAUDE.md→ Project Boundaries ("ersatztv OWNS … the ErsatzTV skill in server-management"). Because that pair diverged in both directions, this is a reconcile-then-symlink, not a replace: port server-management's fresher host/topology content (jazz #633, Dispatcharr-reaches-by-IP,ForwardedHeaders__KnownNetworks) into the ersatztv copy, kill the dangerous "CRUD requires SQLite DB scripting" claim in itsdescription:, fold in theapi.paging-zero-basedfacts requested above, and only then symlink server-management → ersatztv.Relative-symlink form follows the existing cross-repo pattern already used in server-management (
beets,radarr,sonarr, … →../../../<repo>/.claude/skills/<name>).Closing record
Outcome: Both cross-repo skills are now a single copy each, reached by relative symlink from the other repo. Landed as ersatztv PR #639 (merged) plus two commits in
timothy/server-management(34873a6,05712ac).jellyfin~/server-management/.claude/skills/jellyfin(218 lines)~/ersatztv/.claude/skills/jellyfin→ symlinkersatztv~/ersatztv/.claude/skills/ersatztv(439 lines)~/server-management/.claude/skills/ersatztv→ symlinkRoot cause: Both started as symlinks and were materialised into real directories by some copy operation, after which they drifted independently.
jellyfindrifted one way (ersatztv's copy purely stale).ersatztvdrifted both ways, which is why arm -rf+ symlink in either direction would have destroyed correct content.Decisions/conventions changed: none new.
CLAUDE.md→ Project Boundaries updated to state where each canonical copy lives and to record the worktree caveat below.Reusable knowledge:
ersatztvcopy as "stale and dangerous" and ersatztv's as "correct". In fact server-management's was wrong only in itsdescription:— its body already said "Full REST CRUD is available under/api/v1" and it carried ~150 lines ersatztv's lacked. Taking ersatztv's 215-line copy as the base, as the issue implied, would have silently dropped backup/deploy, test/prod topology, the #500 streaming-mode analysis, VAAPI-vs-QSV and the channel-creation checklist. When a bug report says "file A is stale, file B is correct", diff both bodies before believing the direction.description:containing": "breaks the whole skill. An unquoted YAML scalar with a colon-space parses as a mapping, soyaml.safe_loadfails and the frontmatter never loads — silently killing the skill discovery the description exists to drive. I introduced this withIMPORTANT: the fork has…, and the canonical jellyfin file had the identical latent defect (IMPORTANT: Never use DELETE /Items/{id}) — meaning its prominent data-loss warning may never have been reaching the model. Both now quoted. Validate frontmatter by parsing it, not by reading it; eyeballing cannot see this.beets/radarr/sonarr; documented inCLAUDE.mdrather than diverging to absolute paths.ersatztvandjellyfinare cross-repo —closing-an-issueis ersatztv-local with no duplicate anywhere.Verification:
120000with correct relative targets; bothSKILL.mdfiles readable through the symlink from either repo, andmd5confirms one copy each (no divergence possible by construction now).yaml.safe_load.auto_update: false, contradictedCLAUDE.md), ErsatzTV's Music Videos library is 16 and Standup 14 (not 8/9), and both logo gotchas were fixed upstream in #502 / #340.01fb07a;Review-verdict: MERGEABLE @ 01fb07a.Deferred: none.
Docs updated:
CLAUDE.md(both Project-Boundaries lines). Nodocs/*.mdchange needed — no route, endpoint, SPA screen or convention changed.