본문으로 건너뛰기

유튜브 강의노트 Skill을 만들다가, 자막이 아니라 "내 환경"이 무너지는 걸 봤습니다

유피테르

2026.07.27

한 줄 요약

유튜브 강의를 학습용 노트로 바꿔주는 Skill을 만들고 첫 실행을 돌렸는데, 노트는 못 만들었습니다.
대신 초안에 없던 설계 결함 3개를 첫 실행 한 번에 찾았고, 실패의 원인이 "자막이 없어서"가 아니라 "내 Skill이 남의 도구에 통째로 매달려 있어서"라는 걸 확인했습니다.

시작 전 상태

유튜브 강의를 볼 때마다 AI에게 이렇게 말하고 있었습니다.

"이 강의 정리해줘. 아, 중간에 화면도 넣고… 어려운 개념은 쉽게 풀어주고…"

매번 처음부터 다시 설명했습니다. 결과 형식도 그때그때 달랐고, 무엇보다 "이 정도면 됐다"는 기준이 없었습니다.
1주차 강의 내용에 나온 세 가지 증상 — 반복 / 흔들림 / 누락 — 이 그대로였습니다.

입력과 맥락

  • 런타임: Claude Code (CLI), macOS

  • 입력: 공개 유튜브 강의 1개 (17분 51초, 바이브코딩 입문 강의)

  • 민감정보 없음. 실행은 전부 로컬.

내가 직접 내린 판단

Skill을 만들면서 애매했던 지점 3개를 직접 결정했습니다. 이걸 안 정하면 결과가 매번 흔들린다는 걸 배웠습니다.

결정할 것

내 선택

왜

보조교사는 언제 끼어드나

세 조건 OR — ① 정의 없이 처음 나온 용어 ② 강사가 "이건 좀 어렵다" 신호 ③ 내 사전지식 수준 초과

"어려우면 설명해줘"는 판단 기준이 아니라 기분이다. 관찰 가능한 조건으로 바꿔야 매번 같게 움직인다

화면 캡처를 어디에 넣나

강사가 화면·슬라이드를 가리키며 설명하는 대목

섹션마다 기계적으로 1장 넣으면 강사 얼굴만 잔뜩 남는다

노트 형식

Markdown + HTML 둘 다

MD는 나중에 고치고 검색하려고, HTML은 캡처가 붙은 상태로 읽으려고

특히 ②는 결정하고 나서 문제가 보였습니다. "화면을 가리키는 대목"은 자막 텍스트만으로는 알 수 없습니다.
그래서 2단계로 쪼갰습니다: 자막에서 "여기 보시면", "이 그래프가" 같은 지시어로 후보 시점을 뽑고 → 그 시점의 실제 화면을 확인해서 볼 만한 게 있을 때만 채택.

만든 것

youtube-lecture-notes Skill 초안. 강의에서 배운 5칸을 채웠습니다.

  • 언제 — 유튜브 강의를 학습용 노트로 원할 때 / 자막 원문만 필요할 땐 쓰지 않음

  • 입력 — 필수: URL / 선택: 사전지식 수준

  • 판단 — 보조교사 개입 3조건, 캡처 2단계 판정

  • 출력 — 섹션별 노트 + 캡처 + 보조교사 블록 + 용어집 + 스스로 점검 질문 5개

  • 완료 — "원본 영상 없이 이 노트만으로 강의를 설명할 수 있는가"

DO NOT USE를 적은 이유가 따로 있습니다. 제 환경에 이미 "유튜브 자막 뽑아줘"로 반응하는 다른 Skill이 깔려 있었거든요. 그대로 두면 제 Skill 대신 그게 먼저 잡힙니다.

증거와 관찰 — 첫 실행

실제로 돌렸고, 1단계에서 멈췄습니다. 순서대로 무너졌습니다.

① 기본 호출부터 실패
The page needs to be reloaded — 유튜브 정책 변경으로 기본 경로가 막혀 있었습니다.
player_client=android,ios 옵션으로 우회 → 제목·채널·길이·공식 챕터 12개 취득 성공.

② 자막이 0건

has no automatic captions
has no subtitles

제가 적어둔 실패 처리(blocked: no_transcript)가 첫 입력에서 바로 발동했습니다.
그런데 여기서 제 Skill이 틀렸다는 걸 알았습니다. 챕터 12개가 이미 있었고, 제 노트북엔 로컬 음성인식 도구도 깔려 있었습니다. 자막이 없어도 만들 수 있는데 제가 막아둔 겁니다.

③ 진짜 벽 — 오디오를 못 가져옴
음성인식을 쓰려고 오디오를 받으려 했더니, 이번엔 메타데이터는 되는데 오디오만 막혔습니다.
가설을 세워 하나씩 지웠습니다.

  • 영상 자체 문제? → 아님. 제목·챕터는 멀쩡히 가져와졌습니다. 영상은 접근되고 스트림만 막힌 겁니다.

  • 도구가 낡아서? → 유력. 설치본이 9개월 구버전.

  • 유튜브 봇 검증? → 유력. 도구가 직접 "토큰이 필요하다"고 말했습니다.

낡은 도구를 업데이트하려 했더니 또 막혔습니다.

  • pip install -U → "이미 최신입니다". 알고 보니 제 파이썬이 3.9인데 최신 버전은 3.10 이상을 요구해서, 업데이트가 조용히 아무 일도 안 하고 끝난 거였습니다.

  • 다른 파이썬으로 재시도 → 시스템 보호 정책(PEP 668)이 설치를 차단.

여기서 멈췄습니다. 뚫는 방법은 있지만 시스템을 건드려야 해서, 이번 주 학습 범위를 넘는다고 판단했습니다.

실패·막힘·수정

노트는 못 만들었습니다. 그런데 이 실패가 알려준 게 초안보다 훨씬 큽니다.

제 Skill의 약점은 "자막이 없는 영상"이 아니라, 유튜브 정책 · 추출 도구 버전 · 파이썬 버전 · 패키지 정책이라는 4개 층 중 하나만 흔들려도 통째로 멈춘다는 것이었습니다.
그리고 초안 SKILL.md에는 이 중 단 하나도 적혀 있지 않았습니다. 절차만 잔뜩 적고, 그 절차가 돌아갈 수 있는 환경인지 확인하는 칸이 없었습니다.

v0.2로 세 군데를 고쳤습니다.

  1. 전제 조건 절 신설 — 도구 확인을 절차 0단계로 승격. 도구 버전이 6개월 이상 낡았으면 실행 전에 경고

  2. 소스 사다리 — 공식 자막 → 자동 자막 → 로컬 음성인식 → 그래도 없으면 중단. 자막 없다고 즉시 포기하지 않음

  3. 실패를 둘로 분리 — 환경 문제(내가 고칠 수 있음, 고칠 명령까지 알려줌) vs 자료 문제(입력 자체가 안 됨)

회고 — 잘된 점 / 막힌 점 / 다음 한 가지

잘된 점
Skill을 만들기 전에 지금 이 세션에 뭐가 실제로 로딩되는지부터 진단했는데, 그게 결정적이었습니다.
설치된 Skill이 43개인데 본문이 다 읽히는 게 아니라 이름과 한 줄 설명만 올라간다는 걸 확인했고, 그래서 "설명 문장이 곧 선택 여부를 결정한다"는 걸 알았습니다. 겹치는 Skill을 미리 찾아 DO NOT USE를 적어둔 것도 여기서 나왔습니다.

막힌 점
첫 실행이 결과물까지 못 갔습니다. 다만 강의에서 말한 첫 실행의 목적이 "완벽한 결과"가 아니라 "첫 병목 하나 관찰"이었는데, 그건 3개나 건졌습니다.

다음 한 가지
격리된 환경(venv)에 최신 도구를 설치해 같은 영상으로 다시 돌립니다. 같은 입력이어야 v0.1과 v0.2의 차이가 보이니까요.
그리고 이번엔 소스 사다리가 실제로 3단계(로컬 음성인식)까지 내려가는지를 확인할 겁니다.


가장 크게 배운 건 이겁니다.
Skill은 "잘 됐던 프롬프트를 저장하는 것"이 아니라 "안 될 때 어떻게 되는지까지 적어두는 것"이었습니다.
제 초안이 부실했던 곳은 잘 되는 경로가 아니라, 전부 안 되는 경로였습니다.

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

Giacomo 프로필 이미지
Giacomo2026.07.28

노트를 만들지 못한 첫 실행을 실패로 숨기지 않고, 기본 호출과 자막, 오디오 수집이 서로 다른 층에서 막혔다는 점을 차례로 확인하신 과정이 좋았어요. 특히 자막이 없으면 중단하도록 만든 자신의 설계가 실제 환경에서는 너무 일찍 포기하는 규칙이었다는 사실을 발견하고, 도구 점검과 대체 소스 순서를 실패 경로에 넣은 것이 의미 있는 개선입니다.

아직 수정본으로 같은 영상을 다시 돌리지 않아 강의노트와 캡처가 실제로 만들어지는지는 확인되지 않았어요. 다음에는 계획하신 격리 환경에서 동일 영상을 한 번 더 실행해 각 소스 단계의 진입·실패·전환을 기록하고, 최종 산출물이 나오지 않더라도 어디까지 진행됐는지 비교해주시면 수정의 효과를 정확히 볼 수 있겠습니다.

자연어회계처리 프로필 이미지

유피테르님 글을 읽는데 실패 과정을 시스템의 설계 결함으로 끈질기게 분석해 내는 흐름에 완전히 몰입해서 봤습니다. 특히 보조교사 개입을 기분이 아니라 '관찰 가능한 조건'으로 정의하고 '소스 사다리'로 다중화하신 설계는 진짜 무릎을 탁 치게 만드네요. 실패 원인을 환경과 자료 문제로 쪼개서 바로 v0.2의 전제 조건으로 승격시키는 빌드업 과정이 정말 체계적입니다. 단순한 제작기를 넘어 단단한 엔지니어링 에세이를 읽은 듯해 좋은 자극을 잔뜩 얻었습니다.

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요