docs: bulk authoring + track-selection guidance (#43 Phase 2)#53
Merged
Conversation
Phase-2 of agentic copy authoring: skill polish only, no CLI change. - bulk authoring subsection: the recommended agent loop to backfill metadata across many videos - select candidates once via videos list -o json (filtering weak-metadata fields client-side), gate the pricey transcript behind a cheap captions check, draft + dry-run per video, batch-confirm, then execute - quota-aware batching: ~350 units per fully-authored video (transcript itself lists then downloads), ~28 videos exhaust a fresh daily budget; estimate and warn before a run that could hit quotaExceeded - expanded language/track selection: prefer standard over ASR, pass --lang explicitly on multi-language channels, and fall back / tell the user when a track is missing or not downloadable No CLI surface changed, so the generated references/reference.md is untouched.
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## main #53 +/- ##
=======================================
Coverage 85.03% 85.03%
=======================================
Files 15 15
Lines 2660 2660
Branches 393 393
=======================================
Hits 2262 2262
Misses 264 264
Partials 134 134 ☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
This was referenced Jul 1, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Phase-2 of #43. Skill polish only - no CLI change, no new command or flag. Builds on the Phase-1 primitives (
videos captions/transcript,profile brand) shipped in #52.What changed (
skills/ytstudio/SKILL.md)Bulk authoring subsection - the recommended agent loop to backfill metadata across many videos:
videos list -o jsonpass, filtering weak-metadata fields client-side (description == "",tags == [], null language fields, emptylocalizations).videos transcriptbehind a cheapvideos captionscheck - skip the transcript entirely for videos with no usable track.videos updateas a dry-run.--executeeach.Quota-aware batching - real arithmetic against the 10,000 units/day budget: ~350 units per fully-authored video (the transcript command itself lists then downloads, so the gate's list call is paid twice when a track exists), so ~28 videos exhaust a fresh budget; estimate
candidates x 350and warn before a run that could hitquotaExceeded.Expanded language/track selection - prefer
standardoverASR, pass--langexplicitly on multi-language channels (without ittranscriptauto-picks across all tracks), and fall back tovideos captions/ tell the user when a track is missing or not downloadable.Phase 3 (external ASR/STT) and any new CLI primitive stay out of scope.
Scope & verification
Designed and reviewed with the same multi-agent approach as Phase 1: a design workflow confirmed this is expressible with existing primitives (no new CLI warranted), and an adversarial review over the diff surfaced two issues, both fixed here:
--has-localizationexample was dropped - the flag keeps videos that already have a localization, the inverse of the gap-backfill candidates the section is about.No CLI code changed, so the generated
references/reference.mdis untouched andtests/test_skill_reference.pystays green. Full suite: 338 passed; SKILL.md is ASCII-only and every command/flag/field referenced is verified against the live CLI.