elanous 0.2.9 → 0.2.11

package/skills/omni-digest/SKILL.md

@@ -20,13 +20,21 @@ category: digest
 # 요약기 = Grok(XAI_API_KEY 필수 · src/summarize.ts requireEnv). X 수집 BEARER_TOKEN·S3·OCR 은 선택(없으면 그 갈래만 빠진다).
 requires: [xai]
 boundary: core
-boundary_reason: 대표 2026-09-27 «omni-digest 는 배포판 필수» — 요약에 LLM 이 필요한 것은 제품 전제(elanous 는 LLM 자격 없이 일을 못 한다 · xai 행 boundary_note «THE FLOOR»). 후속 = 요약기를 Grok 고정에서 elanous 공급자 체인으로
+boundary_reason: 공식 결정 2026-09-27 «omni-digest 는 배포판 필수» — 요약에 LLM 이 필요한 것은 제품 전제(elanous 는 LLM 자격 없이 일을 못 한다 · xai 행 boundary_note «THE FLOOR»). 후속 = 요약기를 Grok 고정에서 elanous 공급자 체인으로
 ---
 
 # OmniDigest
 
 **모든 콘텐츠** → 자동 감지 → 요약 → 다중 타겟 출력 + 다이어그램.
 
+## 무료로 쓰는 길 (키 없이)
+
+본문 텍스트를 키 없는 Jina Reader 또는 로컬 파일 텍스트 추출로 확보하고, 로컬 `whisper`(영상 음성)나 로컬 OCR(이미지)이 있다면 이를 이용합니다. 얻은 텍스트를 읽고 에이전트에게 직접 요약을 요청합니다. 이 수동 경로는 API 키 없이 가능하지만, 아래 `scripts/main.ts`의 자동 요약은 현재 `XAI_API_KEY`를 요구하므로 키 없이 자동 실행되는 것으로 안내하지 않습니다.
+
+## 내 키로 쓰는 길
+
+자동 요약을 사용하려면 자신의 `XAI_API_KEY`를 실행 환경변수로 설정합니다. X 포스트 수집에는 추가로 `BEARER_TOKEN`, 이미지 OCR에는 `UPSTAGE_API_KEY` 또는 `OCR_API_KEY`를 사용할 수 있습니다. 키 값이나 자격 파일은 이 스킬 문서·사본에 넣지 않습니다.
+
 ## 트리거
 
 URL (X, YouTube, 웹, GitHub) 또는 파일 (PDF, DOCX, 이미지) + 요약/정리/분석 의도.
@@ -69,8 +77,10 @@ URL (X, YouTube, 웹, GitHub) 또는 파일 (PDF, DOCX, 이미지) + 요약/정
 
 ## 실행
 
+이 스킬 폴더에서 실행합니다.
+
 ```bash
-npx tsx ~/.claude/skills/omni-digest/scripts/main.ts "<INPUT>" --message "<의도>" --print
+npx tsx scripts/main.ts "<INPUT>" --message "<의도>" --print
 ```
 
 ### 예시
@@ -109,9 +119,9 @@ npx tsx scripts/main.ts "photo.png" --print
 
 ## 환경변수
 
-`.env` 하나로 관리. youtube-master/grok `.env` 자동 상속.
+필요한 환경변수 이름만 아래에 안내합니다. 값과 자격 파일은 이 팩에 포함하지 않습니다.
 
-필수: `XAI_API_KEY`, `BEARER_TOKEN` (X용)
+자동 요약: `XAI_API_KEY`. X 포스트 수집 시: `BEARER_TOKEN`.
 선택: `OBSIDIAN_VAULT_ROOT`, `UPSTAGE_API_KEY`, `OCR_API_KEY`, `AWS_S3_BUCKET`(X 첨부 이미지·영상 프레임 «시각 흡수» — 공개 읽기 버킷 ⊕ `aws` CLI 자격 · 없으면 그 갈래만 건너뛴다 · 기본값 없음)
 
 ## 흡수한 기능
@@ -156,7 +166,7 @@ X API media.variants → 최저 비트레이트 MP4 → ffmpeg 오디오 추출
 | `OMNI_DIGEST_MEDIA_MAX_MS` | `1200000` (20분) | 이보다 긴 영상은 전사 생략 |
 | `OMNI_DIGEST_WHISPER_MODEL` | `small` | 로컬 whisper 모델 |
 | `OMNI_DIGEST_STT_LANG` | `en` | 기본 전사 언어 |
-| `YOUTUBE_MASTER_ROOT` | `~/.claude/skills/youtube-master` | 폴백 STT 스킬 경로 |
+| `YOUTUBE_MASTER_ROOT` | 설치한 형제 `youtube-master` 스킬 폴더 | 폴백 STT 스킬 경로 |
 
 > **주의**: `--media-lang`을 실제 음성과 다르게 주면 엔진이 번역하거나 오전사한다.
 > 한국어 영상에 기본값 `en`이 걸리지 않도록, 한국어 콘텐츠는 `--media-lang ko`를 명시할 것.
@@ -177,7 +187,7 @@ X API media.variants → 최저 비트레이트 MP4 → ffmpeg 오디오 추출
 
 ### OCR (photo-intake-ocr 흡수)
 - Upstage Document OCR (TypeScript 네이티브 포팅)
-  - API 키: env → ~/.cache/upstage_api_key → ~/.zshrc 순 탐색
+  - API 키: 실행 환경의 `UPSTAGE_API_KEY` 사용 권장
   - 한국어+영어 혼합 문서 지원
 - OCR.space 자동 폴백
 - PDF → pdftotext 실패 시 OCR 자동 전환
@@ -246,15 +256,13 @@ npm i -g @steipete/summarize
 ### summarize CLI 설정 (선택)
 
 ```bash
-# ~/.summarize/config.json 에서 기본 모델/언어 등 설정 가능
 summarize --help
 ```
 
 ## 설치
 
 ```bash
-cd ~/.claude/skills/omni-digest
+cd <installed-skill-folder>
 npm install
-cp .env.example .env
 npx tsx scripts/main.ts --self-test
 ```

package/skills/omni-digest/digest.md

@@ -124,10 +124,10 @@ R1~R7은 “실패”가 아니라 자동 판단을 멈추는 안전한 보류
 |---|---|---|---|
 | ① 런 원장 | 런 종료 시 자동 기록, `run-ledger/<runId>.jsonl` | 끝났는가, 성공했는가, 몇 라운드였는가, `reviewed`였는가 | 왜 그렇게 되었는가 |
 | ② 골-런 스토어 | 종결 레코드 자동 확정, SQLite `GoalExecutionRecord` | 어떻게 끝났는가: stage·goalType·리뷰 계열·PR 번호 | 같은 실패가 재발했는가 |
-| ③ 영역 원장 | 사고 때 사람이 `내부 문서 `ISSUES``에 기록 | 같은 자리를 몇 번 밟았는가: 성격·재발·방어 주체 | 자동으로는 생기지 않음 |
+| ③ 영역 원장 | 사고 때 사람이 영역별 하니스 이슈 원장에 기록 | 같은 자리를 몇 번 밟았는가: 성격·재발·방어 주체 | 자동으로는 생기지 않음 |
 
 - 연합 미완 조회는 원장별 독립 판정의 유령 미완을 runId 가로 대조로 제거한다.
-- 반복되면 영역 원장의 사례를 `내부 문서 `PATTERNS``의 교훈으로 승격한다.
+- 반복되면 영역 원장의 사례를 하니스 반복 패턴 원장의 교훈으로 승격한다.
 
 **R1~R8과의 접점:** **판정 이력·재발 학습층. 직접 판정하지는 않지만, 모든 칸의 사후 검증과 개선에 필수다.**
 

package/skills/omni-digest/src/fetch.ts

@@ -1,6 +1,6 @@
 /** Content fetchers: Web (firecrawl → Jina fallback), GitHub (gh CLI), Local files */
 
-import { execSync } from 'node:child_process';
+import { execFileSync, execSync } from 'node:child_process';
 import { readFileSync, existsSync, unlinkSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -135,11 +135,38 @@ export async function fetchWebContent(url: string, preferSummarize = false): Pro
   return fetchWithJina(url);
 }
 
-/* ── GitHub: gh CLI ── */
+/* ── GitHub: gh CLI / unauthenticated public reads ── */
+
+function fetchPublicGitHub(url: string): string {
+  return execFileSync('curl', ['--fail', '--silent', '--show-error', '--location', '--max-time', '15', url], {
+    encoding: 'utf8', timeout: 20_000, maxBuffer: 2 * 1024 * 1024,
+  });
+}
 
 export function fetchGitHubRepo(owner: string, repo: string): { title: string; content: string } {
   console.log(`  GitHub 레포 ${owner}/${repo}...`);
-  const meta = JSON.parse(execSync(`gh repo view ${owner}/${repo} --json name,description,primaryLanguage,stargazerCount,forkCount,updatedAt`, { encoding: 'utf-8', timeout: 30_000 }));
+  let meta: { name: string; description?: string; language?: string; stargazers_count?: number; forks_count?: number; primaryLanguage?: { name: string }; stargazerCount?: number; forkCount?: number };
+  let publicRead = false;
+  try {
+    meta = JSON.parse(execSync(`gh repo view ${owner}/${repo} --json name,description,primaryLanguage,stargazerCount,forkCount,updatedAt`, { encoding: 'utf-8', timeout: 30_000, stdio: ['ignore', 'pipe', 'ignore'] }));
+  } catch {
+    meta = JSON.parse(fetchPublicGitHub(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}`));
+    publicRead = true;
+  }
+  if (publicRead) {
+    let readme = '';
+    try {
+      const file = JSON.parse(fetchPublicGitHub(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/readme`)) as { download_url?: string };
+      if (file.download_url?.startsWith('https://raw.githubusercontent.com/')) readme = fetchPublicGitHub(file.download_url);
+    } catch {}
+    let commits = '';
+    try {
+      const entries = JSON.parse(fetchPublicGitHub(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/commits?per_page=10`)) as Array<{ commit: { message: string; author: { date: string } } }>;
+      commits = entries.map(({ commit }) => `- ${commit.message.split('\n')[0]} (${commit.author.date.slice(0, 10)})`).join('\n');
+    } catch {}
+    const content = [`# ${meta.name}`, meta.description ? `> ${meta.description}` : '', '', `- Language: ${meta.language || 'N/A'}`, `- Stars: ${meta.stargazers_count || 0} | Forks: ${meta.forks_count || 0}`, commits ? `## Recent Commits\n${commits}` : '', readme ? `## README\n${readme}` : ''].filter(Boolean).join('\n');
+    return { title: `${owner}/${repo}`, content };
+  }
   let readme = ''; try { readme = execSync(`gh api repos/${owner}/${repo}/readme --header "Accept: application/vnd.github.raw" 2>/dev/null`, { encoding: 'utf-8', timeout: 15_000 }); } catch {}
   let commits = ''; try { commits = execSync(`gh api repos/${owner}/${repo}/commits?per_page=10 --jq '.[] | "- \\(.commit.message | split("\\n") | .[0]) (\\(.commit.author.date | .[0:10]))"'`, { encoding: 'utf-8', timeout: 15_000 }); } catch {}
   const content = [`# ${meta.name}`, meta.description ? `> ${meta.description}` : '', '', `- Language: ${meta.primaryLanguage?.name || 'N/A'}`, `- Stars: ${meta.stargazerCount || 0} | Forks: ${meta.forkCount || 0}`, commits ? `## Recent Commits\n${commits}` : '', readme ? `## README\n${readme}` : ''].filter(Boolean).join('\n');

package/skills/pitch-deck/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: pitch-deck
+description: "회사나 제품의 한국어 피치덱·투자 소개 슬라이드를 사실 출처와 함께 만들 때 사용한다. 피치덱, 발표 덱, pitch deck 요청에 대응한다."
+category: knowledge
+sideEffects: write
+triggers:
+  - 피치덱
+  - pitch deck
+requires: []
+---
+
+# Pitch deck — 근거를 지닌 짧은 발표
+
+## 언제 / 입력
+
+회사 또는 제품을 5~10분에 소개할 때 쓴다. 입력은 **회사 한 줄 정의**, 저장소의 **사실 원천 파일들**(읽은 판본과 줄 위치), **발표 길이**다. 독자·구매자·공개 가능 범위를 먼저 정한다. 확인되지 않은 값은 매출·고객·시장 실적처럼 말하지 않는다.
+
+## 장 구성
+
+슬라이드 순서는 **정의 → 실물 증거 → 문제 → 시장 → 기술/BM → 성과 → 성장 전략 → 팀 → 계획**이다. 기본 뼈대 **일곱**은 정의(한 줄로 무엇을 하나) → 문제(누가 왜 멈추나) → 시장(TAM·SAM·SOM, 출처 없으면 가정) → 기술/BM(해결법·경쟁력·BM·누가 지불하나) → 성과(검증된 사례·측정 또는 «아직 검증 전») → 성장 전략(어떤 순서로 누구에게 닿나) → 팀(누가 실행하나)이며, 실물 증거는 정의 바로 다음 별도 장이다. 기술과 BM은 필요하면 각 장으로 나눈다. **계획**은 기본 일곱 및 실물 증거와 *별도 마지막 장*: 제목·표지에 «계획 · 순서와 시기는 바뀔 수 있습니다»를 쓰고 월 단위 약속은 쓰지 않는다. 발표 길이에 맞게 최종 8~12장으로 만든다.
+
+첫 장은 **3초 안에 뜻이 전해지는 쉬운 한 줄**, 전문 용어 0. 다음 장에는 **실물 증거**를 둔다: 실제 화면의 자리와 시연할 행동을 명시하고, 이미지가 없으면 «화면 자리»라고 표기한다. 화면·시연은 검증 전이면 «계획»으로 구분하며 이미 된 일로 그리지 않는다. 사이트와 데모 대본의 메시지 순서(약속 → 증거 → 작동 원리 → 다음 행동)를 따른다. 설득 문장은 빠르고 쉬워도 기술적 아우라는 검증 가능한 실물로 뒷받침한다. 남의 이름·제휴 암시·«곧»·미측정 성과는 넣지 않는다.
+
+각 장: **한 장 한 메시지**, 제목은 명사 나열이 아니라 **주장 문장**. 본문·제목을 합쳐 **공백 기준 45낱말 이하**(출처 ID·진행표시·접근성 라벨 제외). 넘치면 장을 나누고 핵심을 고른다. 수치·날짜·비율은 읽은 파일의 **파일:줄** 또는 공개 링크를 SOURCES의 개별 주장과 짝짓는다. 출처가 없는 시장 규모·추정 TAM/SAM/SOM은 장에 **«가정»** 표시하고 SOURCES의 가정 목록에도 적는다. 근거가 없으면 수치를 만들지 말고 측정 방법을 제시한다. 고객·매출·계약·기술 성숙도를 과장하지 않는다.
+
+### 누구에게 파나 — ECP / ICP
+
+ECP(early customer profile)의 **시급한 문제·사건/구매 트리거·현재 우회 비용·도입 준비**를 묻고, ICP(ideal customer profile)의 **조직/업종·규모·구매자·사용자·의사결정 권한·도입 제약**을 적는다. 시장 장에서는 ECP → ICP → 접근 가능한 구매자(SOM) 순서로 좁힌다. 기술/BM 장에는 구매자와 사용자, 값이 생기는 순간, 과금 가설을 서로 구분한다. 인터뷰 전인 칸은 «가정»이라고 쓰며 공개되지 않은 연락처·고객사 내부 수치를 옮기지 않는다.
+
+## 작성 · 출력
+
+1. 참고본은 `.eml`의 본문·첨부를 파싱해 **슬라이드 구조만**, docx/xlsx에서는 **칸 이름만** 참고한다. 참고본의 사람 이름·연락처·주소·내부 수치·원문 문구는 전재하지 않는다. 저장소의 브랜드 정본과 공개 가능한 기능 근거를 읽고 계획을 현재 성과로 바꾸지 않는다.
+2. `template.html`의 CSS·JS를 각 덱 HTML에 **인라인 복사**하고 `<section class="slide" data-claim="…">`마다 하나의 메시지를 넣는다. 파일 밖 폰트·이미지·스크립트 의존성 없이 로컬 파일로 직접 연다. 제목의 주장 ID마다 SOURCES 표에 **같은 ID**, 출처와 그 줄에서 확인할 내용, 상태(사실/가정/계획)를 기록한다. 출처마다 **`근거 낱말:`** 뒤에 인용한 파일:줄 범위에 실제로 존재하는 짧은 원문 구절을 적는다. 줄 번호뿐 아니라 낱말까지 원천과 대조해 출처 범위가 주장을 지지하는지 확인한다. 숫자 하나라도 별도 근거가 필요하면 같은 행에서 항목별로 대응하고, 공개 실측 수치에는 측정 명령·시각·정확한 값과 공개 바닥 수(내림한 큰 수 ⊕ «+»)를 함께 남긴다. 덱은 바닥 수만 쓰고 재측 값이 그 바닥 수 이상인지 확인한다; 정확한 값에 고정하지 않는다. 코드 줄 수를 `xargs wc -l | tail -1`로 세지 않는다(배치가 나뉘면 마지막 배치만 남는다). `git ls-files -z`와 `wc -l --files0-from=-`로 전체를 세고, 배치별 `wc -l` 합계와 대조한다. 숫자는 해당 ID의 공개 가능한 실측 행에 같은 문자열이 있거나, «가정» 표지가 있거나, 인용 줄에 문자 그대로 있는 날짜여야 한다.
+3. 출력은 **한 파일 HTML 덱**, 키보드 방향키/스페이스로 넘김(화면 버튼도 제공), 16:9, 인쇄하면 한 쪽 한 장. 버튼·입력 요소에 초점이 있을 때는 슬라이드 단축키를 건너뛰어 기본 키보드 조작(«이전» 버튼에서 스페이스)을 보존한다. 인쇄 미리보기·첫/끝 넘김·숫자/개인 연락처를 확인한다. 디자인 시스템을 새로 만들지 않고 `내부 문서 `BRAND-CANON-elanvital-and-elanous-2026-09-30``의 색·서체 사용 기준을 따른다.
+
+기존 연결: `src/skills/index.ts`의 `buildSkillIndex` → `listSkillNames`/`parseSkillMd`가 이 폴더의 SKILL.md를 발견한다. 덱은 스킬이 작성해 직접 여는 **독립 문서**이며 HTML을 위한 신규 런타임 라우트는 만들지 않는다.

package/skills/pitch-deck/template.html

@@ -0,0 +1,80 @@
+<!doctype html>
+<html lang="ko">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>피치덱 — 회사명</title>
+<style>
+  :root { color-scheme: dark; font-family: Geist, "G sans", "Noto Sans KR", system-ui, sans-serif; background: #0c0c0e; color: #f2f1ee; }
+  * { box-sizing: border-box; }
+  body { margin: 0; }
+  main { min-height: 100svh; display: grid; place-items: center; padding: 4rem 1rem; }
+  .slide { display: none; width: min(100%, calc((100svh - 8rem) * 16 / 9)); aspect-ratio: 16 / 9; padding: clamp(1.4rem, 5vw, 5rem); background: #0c0c0e; border: 1px solid #f2f1ee; flex-direction: column; justify-content: space-between; overflow: hidden; }
+  .slide.active { display: flex; }
+  .eyebrow, .marker { color: #e95047; font-size: clamp(.8rem, 1.3vw, 1rem); font-weight: 650; letter-spacing: .08em; }
+  h1, h2 { max-width: 20ch; font-size: clamp(2rem, 4.4vw, 4.9rem); line-height: 1.15; letter-spacing: -.045em; margin: .4em 0; text-wrap: balance; word-break: keep-all; overflow-wrap: anywhere; }
+  p, li { max-width: 54ch; font-size: clamp(1rem, 1.7vw, 1.6rem); line-height: 1.55; word-break: keep-all; overflow-wrap: anywhere; }
+  ul { padding-left: 1.2em; }
+  .accent { color: #e95047; }
+  .screen-slot { border: 1px dashed #e95047; padding: .6rem 1rem; color: #f2f1ee; font-size: clamp(.9rem, 1.4vw, 1.2rem); }
+  .foot { display: flex; justify-content: space-between; align-items: end; gap: 1rem; color: #f2f1ee; font-size: .85rem; }
+  nav { position: fixed; bottom: 1rem; right: 1rem; display: flex; align-items: center; gap: .7rem; background: #0c0c0e; padding: .4rem; }
+  button { background: #0c0c0e; color: #f2f1ee; border: 1px solid #e95047; padding: .6rem .9rem; font: inherit; cursor: pointer; }
+  button:focus-visible { outline: 3px solid #e95047; outline-offset: 3px; }
+  button:disabled { opacity: .42; cursor: not-allowed; }
+  @media print {
+    @page { size: 16in 9in; margin: 0; }
+    body { width: 16in; }
+    :root { print-color-adjust: exact; -webkit-print-color-adjust: exact; }
+    main { display: block; padding: 0; min-height: 0; }
+    .slide, .slide.active { display: flex; width: 16in; height: 9in; aspect-ratio: auto; border: 0; break-after: page; page-break-after: always; }
+    .slide:last-child { break-after: auto; page-break-after: auto; }
+    nav { display: none; }
+  }
+</style>
+</head>
+<body>
+<main id="deck" aria-label="피치덱">
+  <section class="slide active" data-claim="T1" aria-label="정의" aria-hidden="false">
+    <span class="eyebrow">브랜드 · 정의</span>
+    <div><h1>한 줄로 무엇을 하는지 말합니다.</h1><p>검증 가능한 회사 한 줄 정의를 여기에 넣습니다.</p></div>
+    <div class="foot"><span>출처: SOURCES · T1</span><span class="marker">회사명</span></div>
+  </section>
+  <section class="slide" data-claim="T2" aria-label="계획" aria-hidden="true">
+    <span class="eyebrow">계획 · 순서와 시기는 바뀔 수 있습니다</span>
+    <div><h2>다음 걸음은 검증하며 정합니다.</h2><p>이 칸은 현재 제공 기능이 아니라 앞으로의 계획입니다.</p></div>
+    <div class="foot"><span>출처: SOURCES · T2</span><span class="marker">계획</span></div>
+  </section>
+</main>
+<nav aria-label="슬라이드 이동"><button id="prev" type="button" aria-label="이전 장">← 이전</button><output id="position" aria-live="polite"></output><button id="next" type="button" aria-label="다음 장">다음 →</button></nav>
+<script>
+(() => {
+  const slides = [...document.querySelectorAll('section.slide')];
+  const prev = document.getElementById('prev');
+  const next = document.getElementById('next');
+  const position = document.getElementById('position');
+  let current = 0;
+  function show(index) {
+    current = Math.max(0, Math.min(slides.length - 1, index));
+    slides.forEach((slide, i) => {
+      slide.classList.toggle('active', i === current);
+      slide.setAttribute('aria-hidden', String(i !== current));
+    });
+    prev.disabled = current === 0;
+    next.disabled = current === slides.length - 1;
+    position.textContent = `${current + 1} / ${slides.length}`;
+  }
+  prev.addEventListener('click', () => show(current - 1));
+  next.addEventListener('click', () => show(current + 1));
+  document.addEventListener('keydown', event => {
+    if (event.target instanceof Element && event.target.closest('button, a, input, textarea, select, [contenteditable="true"]')) return;
+    if (['ArrowRight', 'ArrowDown', ' ', 'PageDown'].includes(event.key)) { event.preventDefault(); show(current + 1); }
+    if (['ArrowLeft', 'ArrowUp', 'PageUp'].includes(event.key)) { event.preventDefault(); show(current - 1); }
+    if (event.key === 'Home') show(0);
+    if (event.key === 'End') show(slides.length - 1);
+  });
+  show(0);
+})();
+</script>
+</body>
+</html>

package/skills/youtube-master/SKILL.md

@@ -0,0 +1,163 @@
+---
+name: youtube-master
+description: >
+  통합 YouTube 처리 스킬. YouTube URL에서 자막 추출, 요약(brief/cards/detailed),
+  학습노트 생성까지 하나의 엔트리포인트로 처리. 출력 타겟은 Obsidian, markdown,
+  web, pdf. 전사 품질은 Supadata 우선, 필요 시 Cloud STT 자동 전환.
+  Default owner for one youtube.com / youtu.be URL requesting transcript, summary,
+  analysis, or a study note: 요약, 정리, 노트, 학습노트, study note, 자막,
+  transcript, 상세 분석, 간단 요약, cc웹, ccv웹, pdf, 자막 강화, 전사 강화.
+  Explicit YouTube absorb, channel, or subscription work belongs to yt-vault.
+minTier: T2
+composes: [omni-digest, diagram-master]
+category: digest
+requires: []
+---
+
+# youtube-master
+
+YouTube URL 하나로 **자막 추출**, **요약**, **학습노트**, **웹/PDF 배포**까지 처리하는 통합 스킬.
+
+## 트리거 조건
+
+YouTube URL(`youtube.com`, `youtu.be`, `/shorts/`, `/embed/`)이 포함된 모든 요청에 이 스킬을 사용합니다.
+
+## 3축 자동 라우팅
+
+### 출력 형식 (Format)
+
+| 형식 | 설명 | 트리거 키워드 |
+|------|------|-------------|
+| **brief** | 서머리 요약 (한 줄 결론 + 불릿 5~8개) | 간단히, 짧게, 요약만, brief |
+| **cards** | 상세 카드별 요약 (8~16장 + 타임라인) — **기본값** | (기본), 요약, 카드 |
+| **detailed** | 심층 분석 (풀 텍스트 + 데이터 근거 + SCQA) | 상세, 자세히, 깊게, 분석 |
+| **study-note** | 학습노트 (챕터별 해설 + 타임스탬프 + 인사이트) | 노트, 학습노트, study note, 정리해줘 |
+| **transcript** | 자막 원문만 추출 | 자막, transcript, 자막만 |
+| **metadata** | 메타데이터 JSON만 | 메타데이터, metadata |
+
+### 출력 타겟 (Target)
+
+| 타겟 | 설명 | 트리거 키워드 |
+|------|------|-------------|
+| **obsidian** | Obsidian vault에 .md 저장 — **기본값** | (기본), Obsidian, 저장 |
+| **markdown** | stdout 출력 | markdown, md로 |
+| **web** | 웹페이지 생성/배포 | cc웹, ccv웹 |
+| **pdf** | PDF 파일 생성 | pdf, PDF로 |
+
+> **전달은 호출 서피스가 범용 처리**: 이 스킬은 요약 결과(마크다운 + Obsidian 저장 경로)만 산출한다.
+> 특정 봇/채널로의 전송은 스킬이 하드코딩하지 않는다 — **호출한 서피스(monad 세션 sink·Claude Code 등)가
+> 자기 채널에 맞게 렌더·전달**한다. 별도 전달 스크립트나 특정 봇에 결합하지 않는다(범용화).
+
+### 전사 전략 (자동 결정)
+
+- Supadata 자막 우선 (빠르고 무료)
+- 자막 부족/부재 → 자동 Cloud STT 전환 (ElevenLabs → OpenAI → Gemini)
+- 영상 1시간 이상 → 자동 Cloud STT
+- 사용자가 "자막 강화" / "전사 강화" → Cloud STT 강제
+
+## 실행
+
+이 스킬 폴더에서 실행합니다.
+
+```bash
+npx tsx ./scripts/main.ts "<URL>" --message "<사용자 의도>" --print
+```
+
+### 자동 라우팅 예시
+
+```bash
+# 기본 카드형 요약 → Obsidian 저장
+npx tsx scripts/main.ts "https://youtu.be/VIDEO_ID" --print
+
+# 간단 요약
+npx tsx scripts/main.ts "https://youtu.be/VIDEO_ID" --message "짧게 요약" --print
+
+# 학습노트 생성
+npx tsx scripts/main.ts "https://youtu.be/VIDEO_ID" --message "학습노트로 정리해줘" --print
+
+# 상세 분석
+npx tsx scripts/main.ts "https://youtu.be/VIDEO_ID" --message "상세 분석" --print
+
+# 자막 강화 요약
+npx tsx scripts/main.ts "https://youtu.be/VIDEO_ID" --message "자막 강화해서 요약" --print
+```
+
+### 부분 스킬 (자막/메타데이터만)
+
+```bash
+# 자막만 추출
+npx tsx scripts/main.ts "https://youtu.be/VIDEO_ID" --only transcript --print
+
+# 메타데이터만
+npx tsx scripts/main.ts "https://youtu.be/VIDEO_ID" --only metadata
+```
+
+### 강제 옵션
+
+```bash
+# 형식 강제
+npx tsx scripts/main.ts "https://youtu.be/VIDEO_ID" --format detailed --print
+
+# 타겟 강제
+npx tsx scripts/main.ts "https://youtu.be/VIDEO_ID" --target pdf --print
+
+# Cloud STT 강제
+npx tsx scripts/main.ts "https://youtu.be/VIDEO_ID" --cloud-stt --print
+
+# 라우팅 확인만 (실행 없이)
+npx tsx scripts/main.ts "https://youtu.be/VIDEO_ID" --message "학습노트" --dry-run
+```
+
+## 옵션 정리
+
+| 옵션 | 설명 |
+|------|------|
+| `--message, -m <text>` | 사용자 의도 (자동 라우팅 힌트) |
+| `--only <sub>` | 부분 실행: transcript, metadata |
+| `--format <fmt>` | 출력 형식 강제: brief, cards, detailed, study-note |
+| `--target <tgt>` | 출력 타겟 강제: obsidian, markdown, web, pdf |
+| `--cloud-stt` | Cloud STT 전사 강제 |
+| `--transcript-file <path>` | 기존 자막 파일 공급 |
+| `--print` | 결과 stdout 출력 |
+| `--dry-run` | 라우팅 결정 JSON만 출력 |
+| `--no-obsidian` | Obsidian 저장 생략 |
+| `--output-dir <path>` | 저장 디렉토리 오버라이드 |
+| `--self-test` | 라우팅 smoke test |
+
+## 무료로 쓰는 길 (키 없이)
+
+공개 자막이 있으면 해당 자막을 받아 로컬에서 정리하거나, 오디오를 `yt-dlp`로 받아 로컬 `whisper`로 전사한 뒤 에이전트에게 텍스트 요약을 요청합니다. 이 수동 경로에는 API 키가 필요 없습니다. 아래 `scripts/main.ts` 자동 파이프라인은 YouTube 메타데이터·Supadata 자막·요약 API 키를 요구하므로 키 없는 자동 실행을 보장하지 않습니다.
+
+## 내 키로 쓰는 길
+
+자동 파이프라인을 사용하려면 실행 환경에 `YOUTUBE_API_KEY`(YouTube 메타데이터), `SUPADATA_API_KEY`(자막), `XAI_API_KEY`(요약)를 설정합니다. Cloud STT 및 대체 요약은 `ELEVENLABS_API_KEY`, `OPENAI_API_KEY`, `GEMINI_API_KEY`를 각각 사용하는 선택 경로입니다. 값이나 자격 파일을 이 스킬 사본에 넣지 않습니다.
+
+## 환경변수
+
+필요한 API 자격은 실행 환경변수로 전달합니다. 저장 위치를 바꾸려면 `OBSIDIAN_VAULT_ROOT`를 설정합니다.
+
+## 웹 배포 (cc웹/ccv웹)
+
+cc웹/ccv웹 요청 시:
+1. 이 스킬로 요약 마크다운 생성 + Obsidian 저장
+2. stdout에 `---SIGNAL: webDeploy=html-only---` 또는 `---SIGNAL: webDeploy=deploy---` 출력
+3. Claude가 `content-to-web` 스킬을 별도 호출하여 웹페이지 생성/배포
+
+## 저장 위치
+
+- 요약: `OBSIDIAN_VAULT_ROOT/YOUTUBE_SAVE_SUBDIR/YYYYMMDD_제목.md`
+- 학습노트: `OBSIDIAN_VAULT_ROOT/YOUTUBE_STUDY_NOTE_SUBDIR/YYYYMMDD_제목_study-note.md`
+- Cloud STT 아티팩트: `YOUTUBE_SAVE_SUBDIR/_youtube-cloud-stt/<timestamp>_<videoId>_<title>/`
+
+## 설치
+
+```bash
+cd .
+npm install
+npx tsx scripts/main.ts --self-test
+```
+
+Cloud STT 경로 사용 시:
+```bash
+brew install yt-dlp ffmpeg
+```