Agent skill

Playback Webview Debugging

by sozercan in sozercan/kaset

A skill your agent uses when playback, auth recovery, queue sync, or hidden WebView state diverges from native Swift state and you need to debug the DRM playback WebView, bridge events, or…

MITAuto-check passedMobile

Install Playback Webview Debugging

skills CLI
$ npx skills add sozercan/kaset --skill playback-webview-debugging -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sozercan/kaset playback-webview-debugging --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sozercan/kaset.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/playback-webview-debugging .claude/skills/playback-webview-debugging && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
playback-webview-debugging
GitHub stars
2.4k
Token cost
~480 tokens
SKILL.md length
147 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when playback, auth recovery, queue sync, or hidden WebView state diverges from native Swift state and you need to debug the DRM playback WebView, bridge events, or…

  • Works in 5 steps: Reproduce with the packaged app or… → Use Xcode Console filters to watch… → In debug builds, verify… → …
  • Hidden WebView state diverges from native Swift state and you need to debug the DRM playback WebView
  • SKILL.md covers When To Use It, Runtime Workflow and Landmarks
  • Calls swift

What it does

Playback Webview Debugging is an agent skill from sozercan/kaset. Use when playback, auth recovery, queue sync, or hidden WebView state diverges from native Swift state and you need to debug the DRM playback WebView, bridge events, or cookie/auth behavior.

Its SKILL.md is about 480 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering iOS development and Debugging. It works with YouTube and macOS. The repository describes itself as: 📼 The missing YouTube and YouTube Music macOS app. The licence is MIT.

When your agent uses it

  • Hidden WebView state diverges from native Swift state and you need to debug the DRM playback WebView
  • Cookie/auth behavior

Example prompts

  • “/playback-webview-debugging”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Reproduce with the packaged app or Scripts/compile_and_run.sh.
  2. Use Xcode Console filters to watch runtime logs
  3. In debug builds, verify webView.isInspectable = true, then inspect the player WebView with Safari Web Inspector.
  4. To simulate auth expiry, delete __Secure-3PAPISID via Safari Web Inspector storage tools and trigger an authenticated API call.
  5. If auth cookies or headers look suspicious, run swift run api-explorer auth and compare against the exported cookie state.

What it can do on your machine

Read from SKILL.md and the folder at commit 4b74e9f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • swift

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Playback Webview Debugging loads about 480 tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 147 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~480

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sozercan/kaset at commit 4b74e9f, republished under its MIT licence (© sozercan). 147 words, ~480 tokens.

Download SKILL.mdSave it as .claude/skills/playback-webview-debugging/SKILL.md (or your agent's skills folder).
name
playback-webview-debugging
description
Use when playback, auth recovery, queue sync, or hidden WebView state diverges from native Swift state and you need to debug the DRM playback WebView, bridge events, or cookie/auth behavior.
metadata.short-description
Debug playback WebView state

Playback WebView Debugging

Use this skill when playback, auth recovery, queue sync, or hidden WebView state diverges from the native Swift state.

When To Use It

  • Playback starts, stops, or advances unexpectedly
  • Auth looks stale and API calls return 401/403
  • WebView metadata drifts from the native queue
  • You need to inspect JavaScript bridge events or DOM/player state

Runtime Workflow

  1. Reproduce with the packaged app or Scripts/compile_and_run.sh.
  2. Use Xcode Console filters to watch runtime logs: subsystem:Kaset category:player subsystem:Kaset category:auth
  3. In debug builds, verify webView.isInspectable = true, then inspect the player WebView with Safari Web Inspector.
  4. To simulate auth expiry, delete __Secure-3PAPISID via Safari Web Inspector storage tools and trigger an authenticated API call.
  5. If auth cookies or headers look suspicious, run swift run api-explorer auth and compare against the exported cookie state.

Landmarks

  • docs/testing.md
  • docs/playback.md
  • Sources/Kaset/Views/MiniPlayerWebView.swift
  • Sources/Kaset/Views/SingletonPlayerWebView+ObserverScript.swift
  • Sources/Kaset/Views/SingletonPlayerWebView+NavigationState.swift
  • Sources/Kaset/Views/SingletonPlayerWebView+QueueInjection.swift
  • Sources/Kaset/Services/Player/PlayerService.swift
  • Sources/Kaset/Services/Player/PlayerService+WebPlaybackIdentity.swift
  • Sources/Kaset/Services/Player/PlayerService+WebQueueSync.swift
  • Sources/Kaset/Services/Player/PlayerService+QueueNavigationRecovery.swift
  • Sources/Kaset/Services/WebKit/WebKitManager.swift

© sozercan, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/playback-webview-debugging of sozercan/kaset.

Open the folder on GitHubat commit 4b74e9f

Compare with similar skills

Playback Webview Debugging next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Playback Webview Debugging compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Playback Webview Debugging this skillsozercan/kaset2.4k—~480Automated safety check: PassMIT
Apple Crash Log .NET Symbolicationdotnet/skills5.6k1 repos~2.4kAutomated safety check: PassMIT
Swiftui Debuggingst0012/cctop154—~2kAutomated safety check: PassMIT
Push Notificationsdpearson2699/swift-ios-skills1.2k—~5.2kAutomated safety check: PassCustom licence
Swift Diagnosticsjohnrogers/claude-swift-engineering231—~743Automated safety check: PassMIT
Debug Like Expertglittercowboy/taches-cc-resources2k—~2.8kAutomated safety check: PassMIT

Similar skills

  • Official

    Resolves .NET runtime frames in Apple .ips crash logs to function names, source files and line numbers using dSYM symbols, atos and the Microsoft symbol server.

    5.6k GitHub starsUsed in 1 repo~2.4k tokens
    MobileAuto-check passed
  • Swiftui Debugging

    st0012/cctop

    A skill your agent uses when debugging SwiftUI issues in this macOS app — views not updating, layout problems, unnecessary re-renders, state ownership bugs, Preview crashes, or NSHostingView/NSPanel…

    154 GitHub stars~2k tokensUpdated 7 days ago
    MobileAuto-check passed
  • Push Notifications

    dpearson2699/swift-ios-skills

    Implement, review, or debug push notifications in iOS/macOS apps — local notifications, remote (APNs) notifications, rich notifications, notification actions, silent pushes, and notification…

    1.2k GitHub stars~5.2k tokensUpdated 2 mo ago
    MobileAuto-check passed
  • Swift Diagnostics

    johnrogers/claude-swift-engineering

    A skill your agent uses when debugging NavigationStack issues (not responding, unexpected pops, crashes), build failures (SPM resolution, "No such module", hanging builds), or memory problems…

    231 GitHub stars~743 tokensUpdated 8 mo ago
    MobileAuto-check passed
  • Debug Like Expert

    glittercowboy/taches-cc-resources

    Deep analysis debugging mode for complex issues. An agent skill from glittercowboy/taches-cc-resources.

    2k GitHub stars~2.8k tokensUpdated 6 mo ago
    DevelopmentAuto-check passed
  • VPhone Guest Control

    Lakr233/vphone-cli

    Drives a virtual iPhone running on an Apple Silicon Mac through the vphone-launchpad-cli, from checking host setup and starting a machine to tapping, typing and installing apps in the guest.

    15k GitHub stars~1.6k tokensUpdated today
    MobileAuto-check passed

More from sozercan/kaset

  • Autoreview

    sozercan/kaset

    Run a structured code review (Codex default, Claude optional) as a closeout check on a local or PR branch before commit or ship.

    2.4k GitHub stars~3k tokensUpdated 4 days ago
    Auto-check passed
  • API Exploration

    sozercan/kaset

    A skill your agent uses when a task needs a new or modified YouTube Music API call, response parser validation, authenticated endpoint investigation, or fixture capture; explore endpoints with swift…

    2.4k GitHub stars~454 tokensUpdated 4 days ago
    Auto-check passed
  • Dev Loop Packaging

    sozercan/kaset

    A skill your agent uses when you need a fresh packaged .app bundle, a fast build-package-relaunch loop, or a packaged runtime repro for Kaset instead of a compile-only verification.

    2.4k GitHub stars~388 tokensUpdated 4 days ago
    Auto-check passed

Works with

Questions about Playback Webview Debugging

What does Playback Webview Debugging do?

A skill your agent uses when playback, auth recovery, queue sync, or hidden WebView state diverges from native Swift state and you need to debug the DRM playback WebView, bridge events, or…. Playback Webview Debugging is an agent skill from sozercan/kaset. Use when playback, auth recovery, queue sync, or hidden WebView state diverges from native Swift state and you need to debug the DRM playback WebView, bridge events, or cookie/auth behavior.

When should I use Playback Webview Debugging?

Playback Webview Debugging fits situations like: hidden WebView state diverges from native Swift state and you need to debug the DRM playback WebView; cookie/auth behavior.

How do I install Playback Webview Debugging in Claude Code?

Run `npx skills add sozercan/kaset --skill playback-webview-debugging -a claude-code`. Or copy the skill folder (.agents/skills/playback-webview-debugging in sozercan/kaset) into .claude/skills/playback-webview-debugging in your project. Claude Code loads it when a task matches its description.

How do I install Playback Webview Debugging in Codex?

Run `npx skills add sozercan/kaset --skill playback-webview-debugging -a codex`. Or copy the skill folder (.agents/skills/playback-webview-debugging in sozercan/kaset) into .agents/skills/playback-webview-debugging in your project. Codex loads it when a task matches its description.

Can I use Playback Webview Debugging in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sozercan/kaset --skill playback-webview-debugging -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/playback-webview-debugging, .gemini/skills/playback-webview-debugging, .github/skills/playback-webview-debugging and .opencode/skills/playback-webview-debugging in your project.

What does Playback Webview Debugging need to run?

Going by SKILL.md and its folder, Playback Webview Debugging needs the command-line tools its instructions call (swift).

Does Playback Webview Debugging access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Playback Webview Debugging safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Playback Webview Debugging use?

Playback Webview Debugging is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Playback Webview Debugging use?

About 480 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Playback Webview Debugging?

Skills that share tags, products or a category with Playback Webview Debugging: Apple Crash Log .NET Symbolication (dotnet/skills, 5.6k stars), Swiftui Debugging (st0012/cctop, 154 stars), Push Notifications (dpearson2699/swift-ios-skills, 1.2k stars) and Swift Diagnostics (johnrogers/claude-swift-engineering, 231 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Playback Webview Debugging?

sozercan (a GitHub user) maintains it in sozercan/kaset, which has 2,362 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 3, 2026.

Source: sozercan/kaset on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.