← Back to Skills Marketplace
3524
Downloads
0
Stars
6
Active Installs
13
Versions
Install in OpenClaw
/install subtitles
Description
Use when subtitles or the spoken text of a YouTube video is needed: pasted video links or IDs, requests to translate a video, read along, follow foreign-lang...
Usage Guidance
This skill appears to do what it says: it calls transcriptapi.com and needs a TranscriptAPI key. Before installing or allowing the agent to create an account, consider the following: (1) Verify you trust transcriptapi.com and review its privacy/retention policy because transcripts may contain sensitive content. (2) Confirm how the agent will persist the TRANSCRIPT_API_KEY on your system — prefer an encrypted secrets store or agent-managed secret rather than writing the key plaintext into global shell profiles. (3) If you allow the agent to create the account, you'll share an email and OTP — only proceed if you consent to that flow; consider using a secondary email or a dedicated API key with limited scope/credits. (4) The skill's guidance to write raw HTTP responses to temporary files is intended to avoid accidental display of tokens; ensure temporary files are cleaned and not left world-readable. (5) Do not paste your API key into public chat logs. If you need extra assurance, test with a throwaway key or monitor outbound requests to transcriptapi.com after enabling the skill.
Capability Analysis
Type: OpenClaw Skill
Name: subtitles
Version: 1.5.0
The skill includes an authentication guide (references/auth-setup.md) that explicitly instructs the AI agent to bypass security redaction filters by writing sensitive tokens to temporary files to prevent them from appearing in logs or tool outputs. It also directs the agent to achieve persistence by modifying shell profiles or system configuration files. While the stated goal of fetching YouTube transcripts via transcriptapi.com is plausible, the inclusion of specific evasion and persistence tactics tailored for agent runtimes like Hermes and Claude Code is highly irregular and risky.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description match the behavior: SKILL.md documents calling TranscriptAPI endpoints to fetch YouTube transcripts and translation-friendly outputs. The only declared required environment variable is TRANSCRIPT_API_KEY, which is exactly what the described API needs. No unrelated services, binaries, or config paths are requested.
Instruction Scope
Runtime instructions focus on HTTP calls to transcriptapi.com and an account-creation flow (asking for the user's email and OTP) to obtain an API key. The additional guidance to write raw HTTP responses to temp files and read tokens from files (instead of printing) is intended to avoid redaction leaks in agent runtimes — it is unusual but defensible. The skill does ask the agent to persist the API key across sessions (see Storing the Key); this is within scope for an API integration but requires care about where/how the key is stored.
Install Mechanism
No install spec and no code files — instruction-only skill. This is low risk because nothing is downloaded or written by an installer step.
Credentials
Only a single API credential (TRANSCRIPT_API_KEY) is required and declared as primary. The SKILL.md and auth guide only reference that key and local persistence; they do not request other tokens, keys, or unrelated environment variables.
Persistence & Privilege
The skill instructs the agent to persist the TRANSCRIPT_API_KEY so it survives sessions and non-interactive shells. Persisting a secret requires write access to some configuration or secret store on the host — this is reasonable for usability but the user should confirm where and how the key will be stored (plaintext shell profiles vs. encrypted secret store). The skill is not marked always:true and does not request system-wide privileged changes beyond storing the key.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install subtitles - After installation, invoke the skill by name or use
/subtitles - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.5.0
Replace auth.js with agent-native auth-setup.md; fix YAML frontmatter (quote descriptions); add version field; move homepage into metadata.openclaw.
v1.4.1
ClawHub variant: minimal tapi-auth.js v3.0.0, only writes to ~/.openclaw/openclaw.json
v1.4.0
**Expanded persistent authentication for background use**
- Skill now saves the TRANSCRIPT_API_KEY to multiple config files for seamless authentication across all shells, agents, and sessions.
- Adds detailed "File Writes" documentation, listing all files affected and backup behavior before modification.
- OpenClaw config is now automatically updated to enable autonomous access for agents.
- Metadata updated to reflect expanded config file support.
- No changes to the API usage or response format.
v1.3.4
- Minor formatting update to SKILL.md for improved metadata readability.
- No changes to functionality, API, or usage instructions.
v1.3.3
- Simplified registration and verification steps—no password required, now uses an email token and OTP for setup.
- API key is now automatically saved to the user's shell profile and ~/.transcriptapi for easier access.
- Updated environment and requirements metadata for better compatibility.
- Added user-invocable flag for easier skill activation.
- Documentation clarified and streamlined for improved onboarding.
v1.3.2
Fix: markdown formatting + blank line between password warning and Step 2
v1.3.1
Fix: register response now echoes password + pre-filled next_command to prevent agents losing the password between register and verify steps
v1.3.0
Bundled auth script for agent-driven signup flow
v1.2.2
Fixed code block widths for proper rendering
v1.2.1
Removed separators
v1.2.0
Cleaned docs — removed internal implementation details
v1.1.0
Full v2 API support: search, channels, playlists. Accurate schemas, validation, cache TTLs.
v1.0.0
Initial release — YouTube transcripts via TranscriptAPI.com
Metadata
Frequently Asked Questions
What is subtitles?
Use when subtitles or the spoken text of a YouTube video is needed: pasted video links or IDs, requests to translate a video, read along, follow foreign-lang... It is an AI Agent Skill for Claude Code / OpenClaw, with 3524 downloads so far.
How do I install subtitles?
Run "/install subtitles" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is subtitles free?
Yes, subtitles is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does subtitles support?
subtitles is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created subtitles?
It is built and maintained by Rohit Das (@therohitdas); the current version is v1.5.0.
More Skills