Come usare
- Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
- Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
- Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/yayamaz/analyze-youtube-skill --skill analyze-youtubePrima di iniziare
- L’installazione non include abbonamenti, quote API o accesso ai file.
- Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.
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.