사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
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.