elanous 0.2.10 → 0.2.12

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

@@ -17,7 +17,7 @@ requires: []
 
 ## 장 구성
 
-기본 뼈대 **일곱**: **정의**(한 줄로 무엇을 하나) → **문제**(누가 왜 멈추나) → **시장**(TAM·SAM·SOM, 출처 없으면 가정) → **기술/BM**(해결법·경쟁력·BM·누가 지불하나) → **성과**(검증된 사례·측정 또는 «아직 검증 전») → **성장 전략**(어떤 순서로 누구에게 닿나) → **팀**(누가 실행하나). **계획**은 기본 일곱과 *별도 마지막 장*: 제목·표지에 «계획 · 순서와 시기는 바뀔 수 있습니다»를 쓰고 월 단위 약속은 쓰지 않는다. 발표 길이에 맞게 기본 장 하나를 둘로 나누거나 오프닝을 더해 최종 8~12장으로 만든다.
+슬라이드 순서는 **정의 → 실물 증거 → 문제 → 시장 → 기술/BM → 성과 → 성장 전략 → 팀 → 계획**이다. 기본 뼈대 **일곱**은 정의(한 줄로 무엇을 하나) → 문제(누가 왜 멈추나) → 시장(TAM·SAM·SOM, 출처 없으면 가정) → 기술/BM(해결법·경쟁력·BM·누가 지불하나) → 성과(검증된 사례·측정 또는 «아직 검증 전») → 성장 전략(어떤 순서로 누구에게 닿나) → 팀(누가 실행하나)이며, 실물 증거는 정의 바로 다음 별도 장이다. 기술과 BM은 필요하면 각 장으로 나눈다. **계획**은 기본 일곱 및 실물 증거와 *별도 마지막 장*: 제목·표지에 «계획 · 순서와 시기는 바뀔 수 있습니다»를 쓰고 월 단위 약속은 쓰지 않는다. 발표 길이에 맞게 최종 8~12장으로 만든다.
 
 첫 장은 **3초 안에 뜻이 전해지는 쉬운 한 줄**, 전문 용어 0. 다음 장에는 **실물 증거**를 둔다: 실제 화면의 자리와 시연할 행동을 명시하고, 이미지가 없으면 «화면 자리»라고 표기한다. 화면·시연은 검증 전이면 «계획»으로 구분하며 이미 된 일로 그리지 않는다. 사이트와 데모 대본의 메시지 순서(약속 → 증거 → 작동 원리 → 다음 행동)를 따른다. 설득 문장은 빠르고 쉬워도 기술적 아우라는 검증 가능한 실물로 뒷받침한다. 남의 이름·제휴 암시·«곧»·미측정 성과는 넣지 않는다.
 
@@ -30,7 +30,7 @@ ECP(early customer profile)의 **시급한 문제·사건/구매 트리거·현
 ## 작성 · 출력
 
 1. 참고본은 `.eml`의 본문·첨부를 파싱해 **슬라이드 구조만**, docx/xlsx에서는 **칸 이름만** 참고한다. 참고본의 사람 이름·연락처·주소·내부 수치·원문 문구는 전재하지 않는다. 저장소의 브랜드 정본과 공개 가능한 기능 근거를 읽고 계획을 현재 성과로 바꾸지 않는다.
-2. `template.html`의 CSS·JS를 각 덱 HTML에 **인라인 복사**하고 `<section class="slide" data-claim="…">`마다 하나의 메시지를 넣는다. 파일 밖 폰트·이미지·스크립트 의존성 없이 로컬 파일로 직접 연다. 제목의 주장 ID마다 SOURCES 표에 **같은 ID**, 출처와 그 줄에서 확인할 내용, 상태(사실/가정/계획)를 기록한다. 숫자 하나라도 별도 근거가 필요하면 같은 행에서 항목별로 대응한다.
+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

@@ -12,8 +12,8 @@
   .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; }
-  p, li { max-width: 54ch; font-size: clamp(1rem, 1.7vw, 1.6rem); line-height: 1.55; }
+  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); }

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
+```