Agent Skills
스크립트와 리서치를 위한 transcript.im Agent Skills
Agent Skills는 transcript.im의 기능을 에이전트가 필요할 때 불러오는 지침으로 묶어 줍니다. 스킬은 언제 스크립트를 가져와야 하는지, 어떤 도구를 호출하는지, 좋은 결과가 어떤 모습인지 에이전트에게 알려 줍니다. 스킬은 transcript.im MCP 서버가 설정되어 있으면 이를 호출하고, 없으면 REST API로 대체하므로 같은 팩이 Claude Code, Cursor, Codex, Copilot, Gemini CLI 등 여러 Agent Skills 런타임에서 도구별 재작성 없이 동작합니다.
- 플랫폼 팩 세 개 — YouTube, TikTok, Instagram — 에 더해 크로스 플랫폼 리서치와 작성을 위한 워크플로 팩.
- 스킬은 transcript.im MCP 서버를 먼저 호출하고 같은 키로 REST API로 대체합니다.
- 스크립트 추출은 YouTube, TikTok, Instagram, LinkedIn, Twitter/X를 지원합니다. YouTube 탐색은 검색, 채널, 업로드, 재생목록, 자막 메타데이터를 더합니다.
- 워크플로 스킬은 브리프, 노트, 재활용 콘텐츠 같은 결과물을 출처 인용과 함께 반환합니다.
- 각 팩은 순수한
SKILL.md파일이라 Agent Skills 형식을 지원하는 모든 런타임에서 불러올 수 있습니다.
transcript.im Agent Skills란 무엇인가요?
Agent Skills는 에이전트가 이미 이해하는 언어로 기능을 설명하는 순수한 SKILL.md 파일입니다. 언제 사용할지, 무엇을 호출할지, 무엇을 반환할지를 담습니다. transcript.im은 이런 스킬 세트를 유지 관리하므로 코딩 에이전트가 플랫폼마다 맞춤 연동을 만들지 않고도 영상 스크립트를 다룰 수 있습니다.
- 지침이지 인프라가 아닙니다 — 스킬은 에이전트에게 할 일을 알려 주고, 추출은 transcript.im이 합니다.
- 플랫폼 팩과 워크플로 팩 — YouTube, TikTok, Instagram용 팩에 더해 여러 단계의 리서치와 작성용 스킬.
- MCP 우선, REST 대체 — 스킬은 MCP 서버를 우선하고 MCP를 쓸 수 없을 때 REST API로 접근합니다.
- 출처가 붙은 결과물 — 워크플로 스킬은 만들어 낸 결과에 원본 링크와 그대로의 표현을 붙여 둡니다.
플랫폼 스킬 팩
YouTube, TikTok, Instagram에는 전용 팩이 있습니다. 스크립트 추출은 API가 지원하는 다섯 플랫폼 모두에 적용되고, 탐색 스킬 — 검색, 채널, 업로드, 재생목록, 자막 메타데이터 — 은 YouTube에만 있습니다. 공개 API가 탐색을 제공하는 플랫폼이 YouTube뿐이기 때문입니다.
YouTube 스킬
가장 폭넓은 팩입니다. 타임스탬프가 있든 없든 스크립트를 다루고, YouTube 탐색 영역까지 포함합니다. 영상·채널 검색, 채널 확인, 채널 업로드, 재생목록 항목, 자막 메타데이터를 하나로 묶는 전체 진입 스킬도 있습니다. youtube-transcript와 youtube-api는 흔한 표현을 위한 별칭 항목이라 사용자가 "YouTube transcript"나 "YouTube API"라고 말해도 에이전트가 활성화됩니다.
TikTok 스킬
TikTok 스킬은 스크립트에 집중합니다. 자막을 먼저 읽고, 자막이 없는 영상은 음성 인식으로 처리합니다. TikTok 링크를 붙여 넣으면 에이전트가 인용하거나 번역하거나 재활용할 수 있는 깔끔한 타임스탬프 텍스트를 반환합니다. 스킬은 스크립트가 정답인 상황을 알기 때문에 사용자가 스크립트라는 말을 하지 않아도 붙여 넣은 링크에서 활성화됩니다.
Instagram 스킬
Instagram에는 읽을 자막 트랙이 없어서 그 스킬들은 비동기 음성 인식을 중심으로 만들어졌습니다. reel과 transcript 스킬이 공개 Reel이나 영상 게시물을 타임스탬프 텍스트로 바꾸고, 전체 진입 스킬이 팩을 묶습니다. 에이전트는 링크를 제출하고 다른 작업을 하면서 작업 상태를 확인한 뒤 완성된 텍스트를 반환합니다.
결과물을 만들어 내는 워크플로 스킬
스크립트 인텔리전스
YouTube, TikTok, Instagram, LinkedIn, Twitter/X의 스크립트를 요약하고 분석해 요약, 핵심 포인트, 그대로의 인용, 훅, 재사용할 수 있는 콘텐츠 조각을 담은 보고서를 만듭니다. 각 항목은 출처와 연결됩니다. 한 시간 분량을 읽는 대신 논지, 근거, 재사용할 만한 문장을 한 번에 얻습니다.
경쟁사 리서치
직접 가져온 영상으로 경쟁사나 크리에이터를 비교하고, 한 분야에서 무엇이 통하는지 찾아내며, 주제·형식·훅·논점을 벤치마킹합니다. YouTube 탐색은 채널과 재생목록 훑기를 제공하고, 다른 플랫폼은 지정한 스크립트로 기여합니다. 결과는 출처가 붙은 경쟁 분석 브리프라서 어떤 주장이든 영상과 발언 지점까지 거슬러 확인할 수 있습니다.
콘텐츠 재활용
스크립트나 리서치를 재사용 가능한 콘텐츠로 바꿉니다. 블로그 글, X/Twitter 스레드, 숏폼 영상 스크립트, 뉴스레터, 콘텐츠 캘린더를 출처 표기와 함께 바로 편집할 수 있는 초안으로 만듭니다. 초안은 중요한 대목에서 화자의 표현을 그대로 살려, 결과물이 일반적인 요약이 아니라 원본처럼 들리게 합니다.
- 회의 노트 — 회의나 통화 스크립트에서 결정 사항, 담당자가 있는 할 일, 미해결 질문, 위험 요소, 인용을 정리합니다.
- 강의 노트 — 강의나 튜토리얼에서 구조화된 학습 노트, 정의, 핵심 논점, 예시, 복습 질문을 만듭니다.
- 스크립트 API 라우팅 — 모든 워크플로가 스크립트를 가져오거나 배치를 실행하거나 YouTube 영상·채널·재생목록을 탐색할 때 호출하는 데이터 계층 스킬입니다.
스킬이 transcript.im에 도달하는 방식
스킬은 플랫폼과 직접 대화하지 않습니다. transcript.im에 도달하면 transcript.im이 원본을 처리합니다.
- MCP 우선 — transcript.im MCP 서버가 설정되어 있으면 스킬이 그 도구를 직접 호출해 구조화된 결과를 받습니다.
- REST 대체 — MCP가 없으면 스킬이 같은 API 키로 동일한 REST 엔드포인트를 호출하므로, 동작이 런타임의 MCP 지원 여부에 좌우되지 않습니다.
- 자격 증명 하나 — 키는 환경 변수나 에이전트의 MCP 설정에서 읽으므로 스킬이 자체 비밀을 관리하거나 사용자에게 두 번째 로그인을 요구하지 않습니다.
- 같은 계정 — 스킬을 통한 호출은 API나 제품 자체에서 한 호출과 같은 계정, 같은 기록에 남습니다.
- 이식 가능한 팩 — 라우팅이 스킬 안에 있으므로 같은 팩이 코드 변경 없이 런타임 사이를 옮겨 다닙니다.
팩에 들어 있는 것
각 팩은 SKILL.md 파일 모음입니다. 팩의 스킬을 묶는 전체 진입 스킬 하나와, 에이전트가 따로 불러올 수 있는 집중 하위 스킬들로 이루어집니다. 팩은 Agent Skills 형식을 따르므로 이미 쓰고 있는 다른 스킬과 나란히 에이전트의 스킬 디렉터리에 둘 수 있고, 진입 스킬은 더 좁은 스킬로 넘길 시점을 여전히 압니다.
- YouTube — 전체 진입 스킬에 스크립트, 검색, 채널, 재생목록, 자막 스킬, 그리고
youtube-transcript와youtube-api별칭 항목. - TikTok — 전체 진입 스킬에 스크립트 스킬과 그 별칭. 자막을 우선하는 추출과 음성 인식 대체에 집중합니다.
- Instagram — 전체 진입 스킬에
reel과transcript스킬. 비동기 음성 인식을 중심으로 합니다. - 워크플로 —
transcript-api라우팅 스킬에 인텔리전스, 경쟁 분석, 콘텐츠 재활용, 회의 노트, 강의 노트.
이 스킬을 불러오는 런타임
스킬은 Agent Skills 관례를 따르므로 그 형식을 읽는 모든 런타임이 불러올 수 있습니다. Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI, Windsurf, OpenClaw, Hermes Agent 등이 포함됩니다. 스킬은 Markdown과 작은 스크립트로 된 폴더이지 플러그인 바이너리가 아니므로 새 런타임을 위해 컴파일할 것이 없고, 한 런타임용으로 작성한 팩은 도구를 바꿔도 그대로 따라옵니다. 실질적인 효과는 같은 스크립트 워크플로가 처음 설정한 어시스턴트에 묶이지 않고 도구 사이를 따라온다는 점이며, 각 도구마다 별도 연동을 유지할 필요가 없습니다.
관련 항목
Agent Skills 자주 묻는 질문
transcript.im Agent Skills란 무엇인가요?
transcript.im Agent Skills는 AI 에이전트에게 transcript.im을 언제 어떻게 사용해 스크립트를 가져오고, 배치를 실행하고, YouTube 영상을 탐색하고, 리서치 결과물을 만들지 알려 주는 SKILL.md 팩입니다.
어떤 에이전트 런타임에서 이 스킬을 불러올 수 있나요?
Agent Skills 형식을 지원하는 모든 런타임에서 가능하며, Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI, Windsurf, OpenClaw, Hermes Agent 등이 포함됩니다.
스킬에 MCP 서버가 필요한가요?
아니요. 스킬은 MCP 서버가 설정되어 있으면 호출하고, 아니면 같은 API 키로 동일한 REST API에 직접 접근합니다.
Agent Skills는 어떤 플랫폼을 지원하나요?
YouTube, TikTok, Instagram 전용 팩이 있고, YouTube, TikTok, Instagram, LinkedIn, Twitter/X에서 동작하는 워크플로 모음이 있습니다. 스크립트 추출은 다섯 플랫폼을 모두 지원하고, YouTube 탐색은 검색, 채널, 업로드, 재생목록, 자막 메타데이터를 더합니다.
워크플로 스킬은 무엇을 만들어 내나요?
워크플로 스킬은 인텔리전스 보고서, 출처가 붙은 경쟁 분석 브리프, 재활용 콘텐츠 초안, 회의 노트, 강의 노트를 만들며 각각 출처 인용을 유지합니다.
스크립트 스킬 팩은 어떻게 구성되나요?
각 팩은 전체 진입 스킬 하나와 집중 하위 스킬들을 포함하므로, 에이전트가 플랫폼 전체를 활성화하거나 작업에 필요한 부분만 쓸 수 있습니다.
스킬은 transcript.im에 어떻게 인증하나요?
스킬은 환경 변수나 에이전트의 MCP 설정에서 API 키를 읽어 transcript.im으로 보내므로, 스킬을 통한 호출은 직접 API를 호출할 때와 같은 계정을 사용합니다.
transcript.im 위에 직접 워크플로 스킬을 작성할 수 있나요?
네. 팩은 작은 도우미 스크립트가 딸린 순수한 SKILL.md 파일이라, 같은 형식으로 스킬을 작성하고 언제 불러올지 설명해 플랫폼 팩과 나란히 실행할 수 있습니다.