name: wjs-uploading-video description: Upload one or many videos to YouTube. Use when the user wants to "上传到 YouTube", "发 YouTube", "批量上传", "upload to YouTube", "post videos to YouTube", or to publish a finished

final/

directory of MP4s. Reads per-video metadata (title / description / tags) from a sibling

UPLOAD_META.md

file when present (the user's standard markdown format), or from command-line flags. Survives behind a SOCKS/HTTP proxy by using

requests

directly for the resumable upload (the stock

google-api-python-client

MediaFileUpload stalls under this user's proxy setup).

wjs-uploading-video

Push finished videos to YouTube. Defaults are tuned for this user's workflow (王建硕 channel, China network with local proxy, 1080p horizontal recordings from Riverside / multicam edits).

When to use

User has one or more finished
```
.mp4
```
files and wants them on YouTube
User points to a
```
final/
```
directory with multiple segments and an
```
UPLOAD_META.md
```
User wants a specific privacy / playlist / scheduled publish

Don't use for:

微信视频号 upload (no public API; user uploads manually via web)
抖音 / 小红书 / B 站 (different APIs, not yet implemented here)
YouTube Shorts variants from horizontal source (use
```
wjs-reframing-video
```
first to produce the 9:16 cut, then upload that via this skill)

Prerequisites (one-time per machine)

Google Cloud OAuth client:
```
~/.config/youtube/credentials.json
```
must exist. See
```
references/credentials-setup.md
```
for the 5-minute setup if missing.

Python deps:

pip3 install google-auth-oauthlib google-api-python-client requests

(only

google-auth

requests

are strictly needed at upload time, but the OAuth-lib pulls them).

First-ever upload opens a browser for Google consent and writes
```
~/.config/youtube/token.json
```
. Subsequent runs reuse it silently.

How it works (and why it's not the stock youtube-uploader)

YouTube's resumable upload protocol issues a

Location:

URL after the metadata POST, then accepts the bytes in chunked

PUT

requests. The stock

google-api-python-client

runs this over

httplib2

, which under this user's local SOCKS+HTTP proxy stack throws

[Errno 65] No route to host

socket.timeout

on those follow-up PUTs and stalls indefinitely.

This skill bypasses

httplib2

: it does OAuth via

google-auth

, then drives the resumable upload manually with

requests

, passing the proxy explicitly. 8 MB chunks (not the stock 256 KB) — fewer round-trips through the proxy. Exponential-backoff retry on

socket.timeout

ConnectionError

/ 5xx.

If you're tempted to "just call the YouTube API client directly," don't — it'll fail in this environment.

Usage

Batch upload a

final/

Single file

python3 ~/.claude/skills/wjs-uploading-video/scripts/upload_youtube.py \
  --video /path/to/clip.mp4 \
  --title "My Title" \
  --description "Body text" \
  --tags "tag1,tag2,tag3"

Common overrides

Flag	Default	Notes
`--privacy`	`unlisted`	`private` / `unlisted` / `public`
`--category`	`28`	28 = Science & Tech. 27 = Education. 24 = Entertainment.
`--made-for-kids`	`false`	YouTube requires this declaration
`--playlist <ID>`	none	Add each uploaded video to a playlist
`--publish-at <ISO8601>`	none	Schedule publish (requires `--privacy private` )
`--credentials`	`~/.config/youtube/credentials.json`	OAuth client JSON
`--token`	`~/.config/youtube/token.json`	Cached OAuth token
`--chunk-mb`	`8`	Smaller chunks if uploads keep failing mid-flight
`--dry-run`	off	Parse meta + list what would upload, don't touch network

UPLOAD_META.md format

The parser expects the user's standard structure:

## 01 · segment_01_no-bugs.mp4

**短标题**
代码没有错误,只有意图不一致

**视频描述**
AI 时代屎山的重新定义...

—— 王建硕 × 任鑫《...》第 1 集

#王建硕 #AI编程 #ClaudeCode

---

Mapping:

```
## NN · <filename>
```
→ which video this block describes
```
**短标题**
```
(or
```
**Title**
```
) block → YouTube title, verbatim. Short titles work but consider that YouTube allows up to 100 chars — if you want a richer title with series name, write it that way in
```
**短标题**
```
```
**视频描述**
```
(or
```
**Description**
```
) block → YouTube description, verbatim, with the
```
#tag
```
hashtags retained at the bottom
All
```
#word
```
tokens in the 视频描述 → comma-separated YouTube tags (each
```
#
```
is stripped; the user's channel name
```
王建硕
```
is auto-prepended per global instructions)

Filename in the heading must match an actual file in

--dir

. If a file exists but has no meta block, the script errors loudly — pass

--allow-missing-meta

to upload it with

--title <basename>

and empty description.

Sensible defaults this skill bakes in

Privacy = unlisted: lets the user review before going public; flip in YouTube Studio when ready (or pass
```
--privacy public
```
)
Category = 28 (Science & Tech): matches 王建硕 channel's main content; override with
```
--category
```
per upload
selfDeclaredMadeForKids = false: YouTube requires this; the user's content is adult-targeted
Chunk size = 8 MB: validated working size through this user's local proxy (256 KB stalled)
Skip already-uploaded: results file is the source of truth; deleting it forces re-upload

Channel-name CTA rule

If you write description footers, signatures, or "subscribe to me" lines into a video's metadata, use 王建硕 (the user's channel name). Don't put a guest's name there — guests like 任鑫 belong inside the description body when they're the conversation partner, never in the channel-CTA slot.

Troubleshooting

Symptom	Fix
`access_denied 403` on consent screen	Add user's Google account to the OAuth client's Test users list in Google Cloud Console
`[Errno 65] No route to host` mid-upload	Almost always a proxy issue — verify `curl --max-time 10 https://upload.googleapis.com/upload/youtube/v3/videos` returns a 4xx (any 4xx = proxy reachable); if `000` , the proxy is down
Upload stalls with no progress lines	The proxy is silently buffering. Lower `--chunk-mb 4` or restart the proxy daemon
`quotaExceeded`	YouTube Data API default quota is 10,000 units/day, each upload is 1,600 units — so ~6 uploads/day. Request a quota bump in Google Cloud Console, or split uploads across days
Token refresh fails	Delete `~/.config/youtube/token.json` and re-run; OAuth browser flow restarts

After uploading

Results saved to
```
--results-file
```
(JSON: file, title, video id, URL)
Echo the URL list back to the user in a markdown table
Tell them the videos are
```
unlisted
```
by default and remind them to flip to public in YouTube Studio when ready
If they mentioned a 合集 / series, offer to create a YouTube playlist and batch-add the new uploads (the user must give a playlist ID or let you create one)

wjs-uploading-video

AI Skill Market Insights

Be Part of the 0+ Developer Community

wjs-uploading-video

When to use

Prerequisites (one-time per machine)

How it works (and why it's not the stock youtube-uploader)

Usage

Batch upload a
`final/`
directory

Single file

Common overrides

UPLOAD_META.md format

Sensible defaults this skill bakes in

Channel-name CTA rule

Troubleshooting

After uploading

License

Quick Start

Manual Installation

TEAR & SHARE

Tags

plan-design-review

design-review

design-html

design-shotgun

design-consultation

Channels

Learn

Compare

Company

wjs-uploading-video

AI Skill Market Insights

Be Part of the 0+ Developer Community

wjs-uploading-video

When to use

Prerequisites (one-time per machine)

How it works (and why it's not the stock youtube-uploader)

Usage

Batch upload a final/ directory

Single file

Common overrides

UPLOAD_META.md format

Sensible defaults this skill bakes in

Channel-name CTA rule

Troubleshooting

After uploading

License

Quick Start

Manual Installation

TEAR & SHARE

Tags

Channels

Learn

Compare

Company

Batch upload a
`final/`
directory