setup
/setup
One-time shadowcast setup check. Verifies tools, API keys, the YouTube OAuth client and disk space, and fixes what it can. Use when someone installs shadowcast or a run fails on a missing dependency or key.
- Author
- generalizingai ↗
- Repository
- shadowcast ↗
- Licence
- MIT
- Last repository change
- 05.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 05.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
One-time shadowcast setup check. Verifies tools, API keys, the YouTube OAuth client and disk space, and fixes what it can. Use when someone installs shadowcast or a run fails on a missing dependency or key.
Original author description
One-time shadowcast setup check. Verifies tools, API keys, the YouTube OAuth client and disk space, and fixes what it can. Use when someone installs shadowcast or a run fails on a missing dependency or key.
How it works
SKILL.md has no level-two headings · 28 lines, 295 words
SKILL.md preview
---
name: setup
description: One-time shadowcast setup check. Verifies tools, API keys, the YouTube OAuth client and disk space, and fixes what it can. Use when someone installs shadowcast or a run fails on a missing dependency or key.
---
# shadowcast setup
**Windows note:** Claude Code on Windows runs commands in Git Bash. If `python3` isn't found, use `python` (or `py`) for every `python3` command in Shadowcast's skills. Paths work with forward slashes.
`T="${CLAUDE_PLUGIN_ROOT}/tools"`
1. Run `python3 "$T/doctor.py"` and show the user the result.
2. Fix what you safely can, one at a time, and say what you're doing:
- Missing python packages: `python3 -m pip install --user <pkg>`.
- Cut-out tool:
- macOS: `zsh "$T/build_cutout.sh"`. It needs the Xcode command line tools; if `swiftc` is missing, tell the user to run `xcode-select --install`.
- Windows: `python -m pip install --user "rembg[cpu]"`.
- Windows also needs `python -m pip install --user tzdata`.
- ffmpeg / yt-dlp / node: give the install line from doctor (`brew` on macOS, `winget` on Windows). Install only if the user agrees.
3. Things only the user can do (explain each in plain steps, then wait):
- **API keys.** Required: ElevenLabs (voice-over) and Gemini (video analysis and images). Optional: OpenAI and SocialBunny.
- The user runs `python3 "$T/keys.py" set <name>` in their own terminal. Input is hidden and saved to `~/.config/shadowcast/keys.json` with mode 600.
- Never ask for a key in chat, never echo one, and never write one into a project file.
- `python3 "$T/keys.py" list` shows which keys are set.
- **YouTube OAuth client** (once per person, free):
1. console.cloud.google.com → new project.
2. Enable "YouTube Data API v3".
3. Configure the OAuth consent screen as External, then click **Publish app** (a testing-mode app shows "Access blocked" for other accounts and its tokens expire weekly).
4. Credentials → Create OAuth client ID → **Desktop app** → download the JSON to `~/.config/shadowcast/client_secret.json`.
- **Disk:** 8 GB free or more.
4. Run doctor again until every required item is OK.
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · generalizingai/shadowcast | 86 | MIT |
| HwangSlater/harness-fit | 100 | MIT |
| nesquikm/dev-process-toolkit | 100 | MIT |
| userKael/rastro | 100 | MIT |
| als-apg/osprey | 100 | BSD-3-Clause |
| dedujeong/gemba | 100 | Apache-2.0 |
| eigenwise/eigenwise-toolshed | 100 | MIT |
| awrshift/agent-memory-kit | 100 | MIT |
| lifecycle-innovations-limited/claude-ops | 100 | MIT |
Database snapshot: 13.11.2026 · package version 49dfca3bd0e9 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90demo
Quick Shadowcast trial. Give it a YouTube channel link and it produces ONE 1-minute demo video in that channel's format, plus 1 Short and 1 thumbnail. Nothing is published and no YouTube account is needed. Use when someone wants to try Shadowcast or see what it makes before… - 100oauth-client-setup
Configure oauth client setup operations. Auto-activating skill for API Integration. Triggers on: oauth client setup, oauth client setup Part of the API Integration skill category. Use when working with oauth client setup functionality. Trigger with phrases like "oauth client… - 100publish
Schedule a packaged shadowcast episode on YouTube (long video plus 2 Shorts, with thumbnail), and optionally on Facebook and Instagram through SocialBunny, using the channel's release calendar. Also YouTube auth and channel branding. Use for "schedule/publish episode X",… - 100disk-cleanup
Use when df says disk is above 80% full or the user wants to reclaim storage space on a VM. - 100linux-disk-usage
Linux disk-usage forensics and space recovery. Use when a Linux disk is near-full, finding what eats space, or clearing caches, build dirs and model stores. - 100hermes-runtime-operations
Operate and troubleshoot Hermes runtime health in production-like environments. Use for routine environment maintenance (gateway/cron/disk/workspace checks) and auth incident response (OAuth/API-key failures, refresh-token issues, headless device-code recovery).