felo-youtube-subtitling

Q: How do I install felo-youtube-subtitling?

Run npx skills add https://github.com/felo-inc/felo-skills --skill felo-youtube-subtitling in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/felo-youtube-subtitling/ (personal) or .claude/skills/felo-youtube-subtitling/ (project).

by felo-incMedia & Creative

Fetch YouTube video subtitles/captions using Felo YouTube Subtitling API. Use when users ask to get YouTube subtitles, extract captions from a video, fetch transcript by video ID or URL, or when explicit commands like /felo-youtube-subtitling are used. Supports language and optional timestamps.

Installs: 84
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/felo-inc/felo-skills --skill felo-youtube-subtitling

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads felo-youtube-subtitling automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Felo YouTube Subtitling Skill

When to Use

Trigger this skill when the user wants to:

Get subtitles or captions from a YouTube video
Extract transcript by video ID or video URL
Fetch subtitles in a specific language (e.g. en, zh-CN)
Get subtitles with timestamps for analysis or translation

Trigger keywords (examples):

YouTube subtitles, get captions, video transcript, extract subtitles, YouTube 字幕
Explicit: /felo-youtube-subtitling, "use felo youtube subtitling"

Do NOT use for:

Real-time search (use felo-search)
Web page content (use felo-web-fetch)
Generating slides (use felo-slides)

Setup

1. Get API key

Visit felo.ai
Open Settings -> API Keys
Create and copy your API key

2. Configure environment variable

Linux/macOS:

export FELO_API_KEY="your-api-key-here"

Windows PowerShell:

$env:FELO_API_KEY="your-api-key-here"

How to Execute

Option A: Use the bundled script or packaged CLI

Script (from repo):

node felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs --video-code "dQw4w9WgXcQ" [options]

Packaged CLI (after npm install -g felo-ai):

felo youtube-subtitling -v "dQw4w9WgXcQ" [options]
# Short forms: -v (video-code), -l (language), -j (json)

Options:

Option	Default	Description
`--video-code` / `-v`	(required)	YouTube video URL or video ID (e.g. `https://youtube.com/watch?v=ID` or `dQw4w9WgXcQ`)
`--language` / `-l`	-	Subtitle language code (e.g. `en`, `zh-CN`)
`--with-time`	false	Include start/duration timestamps in each segment
`--json` / `-j`	false	Print full API response as JSON

You can pass either a full YouTube link or the 11-character video ID:

Supported URLs: https://www.youtube.com/watch?v=ID, https://youtu.be/ID, https://youtube.com/embed/ID
Or plain ID: dQw4w9WgXcQ

Examples:

# With video URL
node felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs --video-code "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
felo youtube-subtitling -v "https://youtu.be/dQw4w9WgXcQ"

# With video ID
node felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs -v "dQw4w9WgXcQ" --language zh-CN

# With timestamps
node felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs -v "dQw4w9WgXcQ" --with-time --json

Option B: Call API with curl

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ" \
  -H "Authorization: Bearer $FELO_API_KEY"

API Reference (summary)

Endpoint: GET /v2/youtube/subtitling
Base URL: https://openapi.felo.ai. Override with FELO_API_BASE env if needed.
Auth: Authorization: Bearer YOUR_API_KEY

Query parameters

Parameter	Type	Required	Default	Description
video_code	string	Yes	-	YouTube video ID (e.g. dQw4w9WgXcQ)
language	string	No	-	Language code (e.g. en, zh-CN)
with_time	boolean	No	false	Include start/duration per segment

Response (200)

{
  "code": 0,
  "message": "success",
  "data": {
    "title": "Video title",
    "contents": [
      { "start": 0.32, "duration": 14.26, "text": "Subtitle text" }
    ]
  }
}

With with_time=false, start/duration may be absent or zero. contents[].text is always present.

Error codes

HTTP	Code	Description
400	-	Parameter validation failed (e.g. missing video_code)
401	INVALID_API_KEY	API key invalid or revoked
500/502	YOUTUBE_SUBTITLING_FAILED	Service error or subtitles unavailable for video

Output Format

Without --json: print title and then each segment's text (one per line or concatenated). If --with-time, output includes timestamps.
With --json: print full API response.

On failure (no subtitles, API error): stderr message and exit 1. Example:

YouTube subtitling failed for video dQw4w9WgXcQ: YOUTUBE_SUBTITLING_FAILED

Important Notes

Not all videos have subtitles; the API may return an error for some videos.
Language code must match a subtitle track available for the video.
Same FELO_API_KEY as other Felo skills.

References

FAQ

What does the felo-youtube-subtitling skill do?

How do I install felo-youtube-subtitling?

Run npx skills add https://github.com/felo-inc/felo-skills --skill felo-youtube-subtitling in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/felo-youtube-subtitling/ (personal) or .claude/skills/felo-youtube-subtitling/ (project).

Which AI agents can use felo-youtube-subtitling?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is felo-youtube-subtitling safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains felo-youtube-subtitling?

It is published by felo-inc in felo-inc/felo-skills. It has 84 recorded installs.

More from felo-inc/felo-skills

View all →

felo-slides

felo-inc/felo-skills

Generate PPT/slides from prompts, local images, PDFs, and other files with the Felo PPT Task API. Use when users ask to create, make, generate, or export presentations or slide decks; turn an attached/local file into slides; include an original image in a PPT; or explicitly invoke /felo-slides. Handles file upload, API key checks, task creation, polling, and final ppturl output.

Docs & Writing1K installs

felo-search

felo-inc/felo-skills

Open the skill to read its SKILL.md instructions.

278 installs

felo-web-fetch

felo-inc/felo-skills

Extract webpage content with Felo Web Extract API. Use for turning URLs into html/markdown/text, selecting specific page areas with CSS selectors, and controlling extraction options like crawl mode, cookies, user-agent, and timeout.

Frontend & Design109 installs

felo-x-search

felo-inc/felo-skills

Search X (Twitter) data using Felo X Search API. Use when users ask about X/Twitter users, tweets, trending topics on X, tweet replies, or when explicit commands like /felo-x-search are used. Supports user lookup, user search, user tweets, tweet search, and tweet replies.

Marketing & SEO99 installs

felo-superagent

felo-inc/felo-skills

Open the skill to read its SKILL.md instructions.

98 installs

felo-content-to-slides

felo-inc/felo-skills

Fetch content from a webpage or YouTube video, then generate a PPT from that content using Felo APIs. Use when the user wants to turn a URL (article/page or YouTube) into a presentation, or explicit /felo-content-to-slides.

Docs & Writing89 installs

Popular media & creative skills

View category →

hyperframes

heygen-com/hyperframes

Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.

Media & Creative1.2M installs

media-use

heygen-com/hyperframes

Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.

Media & Creative1.1M installs

hyperframes-registry

heygen-com/hyperframes

About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.

Media & Creative1M installs

hyperframes-creative

heygen-com/hyperframes

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.

Media & Creative916.5K installs

ai-video-generation

101-skills/superpowers

Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse

Media & Creative881.5K installs

ai-image-generation

101-skills/superpowers

Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image

Media & Creative880.3K installs

felo-youtube-subtitling

Install

Install

Describe the task

Review the result

SKILL.md

Felo YouTube Subtitling Skill

When to Use

Setup

1. Get API key

2. Configure environment variable

How to Execute

Option A: Use the bundled script or packaged CLI

Option B: Call API with curl

API Reference (summary)

Query parameters

Response (200)

Error codes

Output Format

Important Notes

References

FAQ

More from felo-inc/felo-skills

Popular media & creative skills