Como usar
- Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
- Consulte no original as ferramentas, credenciais e ambientes necessários.
- Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/yayamaz/analyze-youtube-skill --skill analyze-youtubeAntes de começar
- A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
- Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.
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.