使用方法
- 复制安装命令,在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/yayamaz/analyze-youtube-skill --skill analyze-youtube开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。
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.