Agent skill

Youtube Collector

by greatSumini in greatSumini/cc-system

유튜브 채널을 등록하고 새 컨텐츠를 수집하여 자막 기반 요약을 생성하는 skill. An agent skill from greatSumini/cc-system.

MITAuto-check passed

Install Youtube Collector

skills CLI
$ npx skills add greatSumini/cc-system --skill youtube-collector -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install greatSumini/cc-system youtube-collector --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/greatSumini/cc-system.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/youtube-collector .claude/skills/youtube-collector && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
youtube-collector
GitHub stars
438
Token cost
~846 tokens
SKILL.md length
229 words
Files
8 (incl. scripts, references)
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

유튜브 채널을 등록하고 새 컨텐츠를 수집하여 자막 기반 요약을 생성하는 skill. An agent skill from greatSumini/cc-system.

  • Works in 4 steps: 채널 등록 → 컨텐츠 수집 → 요약 생성 → …
  • SKILL.md covers 사전 요구사항, 워크플로우, 스크립트 옵션 and 데이터 구조, plus 1 more section
  • Runs Python scripts from its folder; calls python3 and pip; reaches youtube.com

What it does

Youtube Collector is an agent skill from greatSumini/cc-system. 유튜브 채널을 등록하고 새 컨텐츠를 수집하여 자막 기반 요약을 생성하는 skill. 사용자가 (1) 유튜브 채널 등록/관리를 요청하거나, (2) 등록된 채널의 새 영상 수집을 요청하거나, (3) 유튜브 영상 요약을 요청할 때 사용. 데이터는 .reference/ 폴더에 YAML 형식으로 저장됨.

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including scripts and reference files (for example `README.md`, `references/data-schema.md` and `scripts/collect_videos.py`).

It works with YouTube. The licence is MIT.

Example prompts

  • “/youtube-collector”

Requirements

  • Python 3
  • A credential in YOUR_API_KEY

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. 채널 등록
  2. 컨텐츠 수집
  3. 요약 생성
  4. 데이터 조회

What it can do on your machine

Read from SKILL.md and the folder at commit 172bdd4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 5 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • youtube.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Youtube Collector loads about 846 tokens when it runs, and up to ~1.5k if it reads all its reference files. Until then it costs about 46 tokens; SKILL.md has 229 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~846
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from greatSumini/cc-system at commit 172bdd4, republished under its MIT licence (© greatSumini). 229 words, ~846 tokens.

Download SKILL.mdSave it as .claude/skills/youtube-collector/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
youtube-collector
description
유튜브 채널을 등록하고 새 컨텐츠를 수집하여 자막 기반 요약을 생성하는 skill. 사용자가 (1) 유튜브 채널 등록/관리를 요청하거나, (2) 등록된 채널의 새 영상 수집을 요청하거나, (3) 유튜브 영상 요약을 요청할 때 사용. 데이터는 .reference/ 폴더에 YAML 형식으로 저장됨.

YouTube Collector

등록된 유튜브 채널의 새 컨텐츠를 수집하고 자막 기반 요약을 생성.

사전 요구사항

필수 패키지:

bash
pip install google-api-python-client youtube-transcript-api pyyaml

API 키 설정: 보안을 위해 API 키는 사용자 홈 디렉토리에 저장됨.

bash
# API 키 설정 (대화형)
python3 scripts/setup_api_key.py

# 또는 직접 지정
python3 scripts/setup_api_key.py --api-key YOUR_API_KEY

# 현재 설정 확인
python3 scripts/setup_api_key.py --show

설정 파일 경로:

  • macOS/Linux: ~/.config/youtube-collector/config.yaml
  • Windows: %APPDATA%\youtube-collector\config.yaml

워크플로우

1. 채널 등록

채널 URL 또는 핸들로 등록:

bash
# 핸들로 등록
python3 scripts/register_channel.py --channel-handle @channelname --output-dir .reference/

# URL로 등록
python3 scripts/register_channel.py --channel-url "https://youtube.com/@channelname" --output-dir .reference/

결과: .reference/channels.yaml에 채널 정보가 추가됨.

2. 컨텐츠 수집

스크립트가 영상 목록 조회 + 자막 수집 + YAML 파일 저장을 자동으로 처리:

bash
# 특정 채널 수집
python3 scripts/collect_videos.py --channel-handle @channelname --output-dir .reference/ --max-results 10

# 등록된 모든 채널 수집
python3 scripts/collect_videos.py --all --output-dir .reference/

결과: .reference/contents/{channel_handle}/{video_id}.yaml 파일들이 생성됨.

3. 요약 생성

수집 결과 JSON에서 새로 추가된 영상 확인 후, 각 영상의 YAML 파일에 summary 필드 추가:

yaml
summary:
  source: "transcript"  # 또는 "description" (자막 없을 때)
  content: |
    ## 서론
    - 문제 제기 또는 주제 소개
    - 영상의 목적/배경

    ## 본론
    - 핵심 내용 상세 설명
    - 해결책, 방법론, 예시 등
    - 주요 포인트별 정리

    ## 결론
    - 핵심 요약
    - 시사점 또는 다음 단계

요약 생성 기준:

  • transcript.available: true → 자막 기반 요약, summary.source: "transcript"
  • transcript.available: false → 설명 기반 요약, summary.source: "description"
4. 데이터 조회

수집된 컨텐츠 확인:

  • .reference/contents/ 폴더 구조 확인
  • 특정 채널/영상의 YAML 파일 읽어서 정보 제공

스크립트 옵션

register_channel.py
옵션설명
--channel-handle채널 핸들 (@username)
--channel-url채널 URL
--channel-id채널 ID (UC...)
--output-dir저장 디렉토리 (기본: .reference)
collect_videos.py
옵션설명
--channel-handle특정 채널 핸들
--channel-id특정 채널 ID
--allchannels.yaml의 모든 채널 처리
--output-dir저장 디렉토리 (기본: .reference)
--max-results채널당 최대 수집 개수 (기본: 10)
--language자막 우선 언어 (기본: ko)
--no-skip-existing기존 파일 덮어쓰기

데이터 구조

상세 스키마: references/data-schema.md

영상 데이터 예시
yaml
video_id: "abc123"
title: "영상 제목"
published_at: "2025-12-10T10:00:00Z"
url: "https://youtube.com/watch?v=abc123"
thumbnail: "https://..."
description: "영상 설명..."
duration: "PT10M30S"
collected_at: "2025-12-13T15:00:00Z"
transcript:
  available: true
  language: "ko"
  text: "자막 전체..."
summary:
  source: "transcript"
  content: |
    ## 서론
    - 영상의 배경 및 목적

    ## 본론
    - 핵심 내용 1
    - 핵심 내용 2

    ## 결론
    - 핵심 요약

에러 처리

상황안내 메시지
API 키 미설정"YouTube Data API 키가 필요합니다. python3 scripts/setup_api_key.py로 설정해주세요."
채널 미등록"등록된 채널이 없습니다. 먼저 채널을 등록해주세요."
패키지 미설치"필요한 패키지를 설치해주세요: pip install google-api-python-client youtube-transcript-api pyyaml"
API 할당량 초과"YouTube API 할당량이 초과되었습니다. 내일 다시 시도해주세요."

© greatSumini, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (scripts, references) in .claude/skills/youtube-collector of greatSumini/cc-system.

  • SKILL.md
  • README.md
  • references/data-schema.md
  • scripts/collect_videos.py
  • scripts/fetch_transcript.py
  • scripts/fetch_videos.py
  • scripts/register_channel.py
  • scripts/setup_api_key.py

Open the folder on GitHubat commit 172bdd4

Compare with similar skills

Youtube Collector next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Youtube Collector compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Youtube Collector this skillgreatSumini/cc-system438—~846Automated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Banner Design Systemnextlevelbuilder/ui-ux-pro-max-skill135k1 repos~1.8kAutomated safety check: PassMIT
Agent ReachPanniantong/Agent-Reach95k—~1.4kAutomated safety check: PassMIT
Last30daysmvanhorn/last30days-skill64k—~7.9kAutomated safety check: NotesMIT
Baoyu URL To Markdownsdyckjq-lab/llm-wiki-skill2.5k2 repos~3.2kAutomated safety check: PassNone

Similar skills

  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Banner Design System

    nextlevelbuilder/ui-ux-pro-max-skill

    Walks through designing a banner for social media, ads, a website hero or print, from gathering requirements to building 2 or 3 art-direction options in HTML and CSS.

    135k GitHub starsUsed in 1 repo~1.8k tokens
    Frontend & DesignAuto-check passed
  • Agent Reach

    Panniantong/Agent-Reach

    Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

    95k GitHub stars~1.4k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed
  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.9k tokensUpdated yesterday
    Research & ScienceAuto-check: notes
  • Baoyu URL To Markdown

    sdyckjq-lab/llm-wiki-skill

    Fetch any URL and convert to markdown using Chrome CDP. An agent skill from sdyckjq-lab/llm-wiki-skill.

    2.5k GitHub starsUsed in 2 repos~3.2k tokens
    Knowledge ManagementAuto-check passed
  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    19k GitHub starsUsed in 1 repo~4.2k tokens
    Marketing & SEOAuto-check passed

More from greatSumini/cc-system

All 12 skills in this repo
  • Slash Command Creator

    greatSumini/cc-system

    Guide for creating Claude Code slash commands. An agent skill from greatSumini/cc-system.

    438 GitHub stars~773 tokensUpdated 4 mo ago
    Auto-check passed
  • Subagent Creator

    greatSumini/cc-system

    Create specialized Claude Code sub-agents with custom system prompts and tool configurations.

    438 GitHub stars~958 tokensUpdated 4 mo ago
    Auto-check passed
  • Cc Usage Audit

    greatSumini/cc-system

    한 프로젝트에서 사용자가 Claude Code에 입력한 프롬프트·작업 이력을 분석해 (1) 사용 패턴 정량화, (2) 사용자의 개발 철학 추출(근거 인용), (3) 그 철학을 렌즈로 한 메타 시스템(하니스·게이트·CI·프로세스) audit, (4) 우선순위가 매겨진 개선점 발굴을 수행한다.

    438 GitHub stars~586 tokensUpdated 4 mo ago
    Auto-check passed
  • Hook Creator

    greatSumini/cc-system

    Create and configure Claude Code hooks for customizing agent behavior.

    438 GitHub stars~662 tokensUpdated 4 mo ago
    Auto-check: notes
  • Ship

    greatSumini/cc-system

    지금까지의 작업을 한 번에 출하한다 — 커밋 → push → PR 생성 → squash merge. An agent skill from greatSumini/cc-system.

    438 GitHub stars~697 tokensUpdated 4 mo ago
    Auto-check passed
  • Gmail

    greatSumini/cc-system

    gogcli를 사용하여 Gmail 메일을 검색, 조회, 발송하는 skill. An agent skill from greatSumini/cc-system.

    438 GitHub stars~838 tokensUpdated 4 mo ago
    Auto-check passed

Works with

Questions about Youtube Collector

What does Youtube Collector do?

유튜브 채널을 등록하고 새 컨텐츠를 수집하여 자막 기반 요약을 생성하는 skill. An agent skill from greatSumini/cc-system. Youtube Collector is an agent skill from greatSumini/cc-system. 유튜브 채널을 등록하고 새 컨텐츠를 수집하여 자막 기반 요약을 생성하는 skill.

How do I install Youtube Collector in Claude Code?

Run `npx skills add greatSumini/cc-system --skill youtube-collector -a claude-code`. Or copy the skill folder (.claude/skills/youtube-collector in greatSumini/cc-system) into .claude/skills/youtube-collector in your project. Claude Code loads it when a task matches its description.

How do I install Youtube Collector in Codex?

Run `npx skills add greatSumini/cc-system --skill youtube-collector -a codex`. Or copy the skill folder (.claude/skills/youtube-collector in greatSumini/cc-system) into .agents/skills/youtube-collector in your project. Codex loads it when a task matches its description.

Can I use Youtube Collector in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add greatSumini/cc-system --skill youtube-collector -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/youtube-collector, .gemini/skills/youtube-collector, .github/skills/youtube-collector and .opencode/skills/youtube-collector in your project.

What does Youtube Collector need to run?

Going by SKILL.md and its folder, Youtube Collector needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and pip). Our summary lists: Python 3; A credential in YOUR_API_KEY.

Does Youtube Collector access the network?

SKILL.md names 1 domain. In commands or code: youtube.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Youtube Collector safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Youtube Collector use?

Youtube Collector is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Youtube Collector use?

About 846 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 648 tokens, read only when the agent opens those files.

What are the alternatives to Youtube Collector?

Skills that share tags, products or a category with Youtube Collector: Markitdown (ImCa0/just-laws, 781 stars), Banner Design System (nextlevelbuilder/ui-ux-pro-max-skill, 135k stars), Agent Reach (Panniantong/Agent-Reach, 95k stars) and Last30days (mvanhorn/last30days-skill, 64k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Youtube Collector?

greatSumini (a GitHub user) maintains it in greatSumini/cc-system, which has 438 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on June 9, 2026.

Source: greatSumini/cc-system on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.