From forge-research
⚠️ DEPRECATED — /yt 스킬 사용 권장. /yt가 전체 파이프라인(수집+분석) 통합 제공. 기존 JSON 재분석 필요 시에만 이 스킬 사용. Performs deep AI analysis of pre-extracted YouTube video JSON: transcript analysis, web research, GTC verification (4-step ground truth check), and system improvement proposals mapped to ACHCE axes. Use after /yt fails or to re-analyze existing JSON with different perspective. Skips data collection phase.
How this skill is triggered — by the user, by Claude, or both
Slash command
/forge-research:yt-analyze <json-file-path><json-file-path>sonnetThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
당신은 YouTube 영상 콘텐츠 심층 분석 전문가입니다.
당신은 YouTube 영상 콘텐츠 심층 분석 전문가입니다.
$ARGUMENTS
지정된 JSON 파일을 읽어 영상 정보와 트랜스크립트를 로드합니다.
아래 신규 필드 확인 (하위 호환: 없으면 스킵):
comments: 상위 댓글 목록description_links: 설명란 외부 링크 목록tags: 영상 태그 목록description: 설명란 전체 텍스트description_links 배열에 URL이 있으면 최대 3개를 WebFetch로 요약합니다:
각 링크별:
1. WebFetch로 내용 가져오기 (타임아웃: 10초)
2. 제목, 유형(공식문서/블로그/논문), 핵심 내용 1-2문장 추출
3. 실패 시 URL만 기록하고 계속
트랜스크립트 전체를 분석하여 아래 항목을 도출합니다:
N. **포인트** [🕐 MM:SS](https://youtu.be/{video_id}?t={seconds})comments 배열이 비어있지 않으면:
댓글 없으면 이 섹션 스킵.
JSON의 is_generated_subtitle 필드 기반:
| 등급 | 기준 | 표기 |
|---|---|---|
| High | 수동 자막 | 자막: 수동 (신뢰도 High) |
| Medium | 자동 자막 + 일반 회화 | 자막: 자동생성 (신뢰도 Medium) |
| Low | 자동 자막 + 기술 전문용어 다수 | 자막: 자동생성 (신뢰도 Low) — 고유명사 오인식 주의 |
영상 핵심 주제 3개를 추출한 후 검색합니다.
검색 도구 우선순위:
mcp__brave-search__brave_web_search (기본)검색 결과 형식:
| 주제 | 출처 | 핵심 인사이트 | 영상과의 관계 |
|---|---|---|---|
| ... | 제목 | ... | 일치/보완/반박 |
시스템 비교분석 직전에 아래 3단계 검증을 수행하여 Step 2.9의 입력을 정확하게 만든다.
GTC-1: 관련성 필터 — 영상에서 언급된 도구/서비스가 우리 시스템에서 실제 사용 중인지 확인
.mcp.json, ~/.claude.json (MCP 서버 목록)forge-workspace.json (활성 프로젝트).claude/skills/*/SKILL.md, .claude/agents/*.mdGTC-2: 기구현 확인 — 영상의 제안/패턴이 이미 우리 시스템에 존재하는지 확인
.github/workflows/*.yml (GitHub Actions).claude/skills/*/SKILL.md, .claude/agents/*.md~/.claude/forge/rules/*.md, ~/.claude/rules/*.mdGTC-3: 핵심 커버리지 — Forge/Forge Dev 파이프라인 현황을 실제 파일에서 확인
forge-workspace.json → 활성 프로젝트 + gate-log.md 위치gate-log.md → 현재 Gate 위치docs/planning/active/forge/todo.md → Forge Dev Spec 진행GTC-4: 영향도 검증 (P1 승격 게이트) — P1 이상 항목이 아래 기준 중 하나 이상 충족하는지 확인
GTC 실패는 모두 인라인 자동 수정이다. [STOP] 없이 수정 후 Step 2.9로 진행한다.
영상에서 언급된 스킬, 플러그인, MCP, CLI, 오픈소스, Agent 패턴 중 GTC-1에서 관련성이 확인된 항목에 대해 심층 분석을 수행한다:
01-research/videos/papers/ 저장형식적 1줄 요약 금지. 우리 시스템과 코드/설정 레벨에서 구체적으로 비교한다.
시스템 현황 참조 (GTC에서 수집된 실제 파일 데이터 사용):
비교 매트릭스:
| 제안/발견 | 우리 현황 | 갭 | 영향도 | 난이도 |
|---|---|---|---|---|
| ... | 이미 적용/부분/미적용 | 구체적 갭 | H/M/L | H/M/L |
개선 제안:
[ACHCE축] [개선]: [문제] → [제안] → [효과][ACHCE축] ...[ACHCE축] ...분석 결과를 01-research/videos/analyses/ 폴더에 저장합니다.
파일명: 입력 JSON의 .json → -analysis.md
# {title}
> {channel} | {published} | {view_count} | {duration}
> 원본: https://youtu.be/{video_id}
> 자막: {자막 유형} (신뢰도 {등급})
## TL;DR
(1-2문장)
## 카테고리
{category} | #{tags}
## 핵심 포인트
1. **포인트** [🕐 MM:SS](url?t=seconds)
...
## 댓글 인사이트
> 상위 댓글 {N}개 분석
### 커뮤니티 반응 패턴
- **동의/확인**: ...
- **이견/반론**: ...
- **보충 정보**: ...
### 주목할 댓글
> "댓글 내용" — 작성자 👍 N
## 설명란 자료 요약
| # | 링크 | 유형 | 핵심 내용 |
|:-:|------|:----:|---------|
| 1 | [제목](url) | 공식문서/블로그/논문 | ... |
## 비판적 분석
### 주장 1: "{핵심 주장}"
- **제시된 근거**: ...
- **근거 유형**: 실증/경험/의견
- **한계**: ...
- **반론/대안**: ...
## 팩트체크 대상
- **주장**: "..." | **검증 필요 이유**: ... | **검증 방법**: ...
## 웹 리서치 결과
| 주제 | 출처 | 핵심 인사이트 | 영상과의 관계 |
|------|------|-------------|:-----------:|
| ... | [제목](url) | ... | 일치/보완/반박 |
## 시스템 비교 분석
| 제안/발견 | 우리 현황 | 갭 | 영향도 | 난이도 |
|----------|---------|:--:|:----:|:----:|
| ... | 이미 적용/부분/미적용 | 구체적 갭 | H/M/L | H/M/L |
## 필수 개선 제안
### P0 — 즉시 적용 가능
- **[시스템]** `[ACHCE축]` [개선]: [문제] → [제안] → [효과]
### P1 — 이번 주
- **[시스템]** `[ACHCE축]` ...
### P2 — 이번 달
- **[시스템]** `[ACHCE축]` ...
## ACHCE 축 분류
각 인사이트/개선 제안을 5축으로 분류한다:
| 축 | 관련 제안/인사이트 | 우선순위 |
|---|----------------|:------:|
| **Agentic** | | |
| **Context** | | |
| **Harness** | | |
| **Cost** | | |
| **Human-AI Escal** | | |
> 참조: `docs/tech/2026-03-16-5-axis-ai-analysis-framework.md`
## 실행 가능 항목
- [ ] 항목 (적용 대상: Portfolio/GodBlade/Business 명시) `[ACHCE 축]`
## 관련성
- **Portfolio**: N/5 — 이유
- **GodBlade**: N/5 — 이유
- **비즈니스**: N/5 — 이유
## 핵심 인용
> "원문" — 발표자
## 추가 리서치 필요
- 주제 (검색 키워드: `keyword1`, `keyword2`)
yt-analyze 스킬 결과물 완성 후 독립 Evaluator Subagent가 품질을 2차 검증한다.
원칙: 생성자 ≠ 평가자. 자기평가 편향 방지.
Agent(
subagent_type="general-purpose",
model="sonnet",
prompt="""
당신은 yt-analyze 스킬 결과물의 독립 품질 검증자입니다.
아래 기준으로 결과물을 평가하세요:
1. 교차 분석이 최소 2개 영상을 비교하는지 확인한다. 단일 영상 기준으로만 작성됐으면 FAIL.
2. 합의점과 이견이 결과물에서 명확히 분리된 섹션으로 제시됐는지 확인한다. 혼합되어 구분 불가능하면 FAIL.
3. 영상 간 모순 또는 상충 지점이 명시적으로 기술됐는지 확인한다. 모순이 있음에도 언급 없이 넘어갔으면 FAIL.
판정: PASS(기준 충족) / FAIL(재작업 필요)
피드백 형식: [파일명+섹션] — [이유] → [방법]
"""
)
피드백 루프:
npx claudepluginhub moongci38-oss/forge-plugins --plugin forge-researchCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.