Levyra extractor workflow

SkillMedia

Implement, debug, or review Levyra InnerTube, YouTube extraction, stream resolution, player-config synchronization, token, retry, timeout, cache, and network fallback behavior.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Levyra extractor workflow skill

What this skill tells your AI

The instructions your AI receives, as published by luc4n3x/levyra-deepsound in .agents/skills/levyra-extractor/SKILL.md and read by ahel’s review.

Required context

  1. Read the root AGENTS.md and the nearest applicable AGENTS.md.
  2. Read docs/ARCHITECTURE.md.
  3. Read .agents/claude/rules/extractor-network.md and .agents/claude/rules/security.md.
  4. Inspect the resolver, clients, runtime configuration, caches, in-flight work, fallback order, workflows, and nearby tests.

Change contract

Map the current request path and explicitly distinguish:

  • successful resolution;
  • conclusive no-match;
  • transient transport, timeout, server, parsing, or verification failure;
  • cancellation;
  • stale or invalid runtime configuration.

Guardrails

  • Preserve the current bounded fallback order unless the task explicitly changes it.
  • Preserve last-known-good runtime configuration until a replacement is validated and published atomically.
  • Do not hardcode private credentials, cookies, account tokens, visitor data, signed URLs, or production secrets.
  • Keep retries, timeouts, concurrency, traffic, cache growth, and response sizes bounded.
  • Do not negative-cache transient or inconclusive failures.
  • Re-throw CancellationException; one caller's cancellation must not poison shared work or other waiters.
  • Validate provider-controlled URLs, redirect hops, hosts, ports, resolved destinations, MIME types, and response sizes.
  • Do not weaken validation merely to accept one upstream response.

Validation

Add or update focused tests for fallback order, configuration parsing and epoch changes, invalid upstream payloads, timeout, cancellation, cache semantics, stale publication, and URL/redirect rejection when applicable.

Inspect .github/workflows/sync-player-configs.yml for configuration changes. A successful no-change sync is not evidence that a new configuration was published.

Signals

GitHub stars
164
Forks
1
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
levyra-extractor
Source
github.com/luc4n3x/levyra-deepsound