How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/yayamaz/analyze-youtube-skill --skill analyze-youtubeBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
Analyze YouTube
Use Gemini's native YouTube input through the bundled wrapper. Prefer it over caption scraping because it can interpret both audio and visuals.
Workflow
- Resolve the exact public YouTube URL from the user message or visible page.
Ask for the URL only when it cannot be determined safely. Never guess from a title.
- Resolve
SKILL_DIRto the directory containing thisSKILL.md. - Check credentials without printing the key:
python3 -B "$SKILL_DIR/scripts/gemini_youtube.py" --check-credentialsIf credentials are missing, walk the user through these steps:
- Create a Gemini API key at <https://aistudio.google.com/app/apikey>.
- Copy
.env.exampleto.envinside the skill directory:
cp "$SKILL_DIR/.env.example" "$SKILL_DIR/.env"- Tell the user to open
.envin their text editor and paste the key afterGEMINI_API_KEY=.
Never ask them to paste the key into chat.
.envalso accepts per-mode token limits:MAX_OUTPUT_TOKENS_BRIEF(default 8000),MAX_OUTPUT_TOKENS_QUESTION(default 8000),MAX_OUTPUT_TOKENS_TRANSCRIPT(default 16000).- After the user says it is saved, rerun
--check-credentials.
- Choose the smallest useful mode:
brief: default evidence packet for understanding and discussion.question: answer one specific question with timestamped evidence.transcript: detailed transcript-like record when explicitly requested.
- For a general analysis, run:
python3 -B "$SKILL_DIR/scripts/gemini_youtube.py" \
--url 'https://www.youtube.com/watch?v=VIDEO_ID' \
--mode briefFor a focused question, run:
python3 -B "$SKILL_DIR/scripts/gemini_youtube.py" \
--url 'https://youtu.be/VIDEO_ID' \
--mode question \
--question 'What operating model does the speaker recommend?'For long output, use --output with a temporary file and read only the sections needed.
- Synthesize the result for the user.
Distinguish explicit statements from Gemini's inference and preserve useful timestamps.
Boundaries
- Read public YouTube videos only.
Do not sign in, bypass access controls, or process private or unlisted videos.
- The wrapper sends
store=false.
Never remove that privacy control.
- Never print or include the Gemini API key in commands, logs, or responses.
The local .env file is intentionally ignored by Git.
- Do not paste a complete copyrighted transcript into chat.
Use it for analysis, provide summaries, and quote only short necessary excerpts.
- If Gemini cannot process the video, report the limitation and ask for a public URL or user-provided source.
Do not silently download audio or switch to another ingestion method.