← Back to Skills Marketplace
dennisooki

OpenSubtitles Read-only

by Magolo Dennis Ooki · GitHub ↗ · v1.0.4
cross-platform ✓ Security Clean
411
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install opensubtitles
Description
Read-only OpenSubtitles skill to search and download subtitles via API, then extract scene context by timestamp to answer user questions regarding a show in...
Usage Guidance
This skill appears to do what it claims: it calls the OpenSubtitles API, optionally logs in to obtain a token for downloads, saves .srt files to a local cache, and extracts subtitle text around a timestamp. Before installing: (1) Understand that the skill needs your OPENSUBTITLES_API_KEY and a User-Agent string — treat the API key like any sensitive credential and don't share it; (2) if you plan to use downloads, you may need to supply username/password or a token — those are only required for login/download and are optional otherwise; (3) the scripts will create and read files under {baseDir}/storage/subtitles — ensure you are comfortable with subtitle files being stored there; (4) ensure awk is available on systems that will run subtitle-context.sh (the top-level check in one script omitted awk); (5) although this is read-only and enforces a storage-directory check to avoid arbitrary file reads, follow the guardrails (don’t log keys, don’t share tokens). If you want extra assurance, inspect/run the included scripts in a restricted environment (or review their output on a single test query) before granting the API key to an agent.
Capability Analysis
Type: OpenClaw Skill Name: opensubtitles Version: 1.0.4 This OpenClaw skill bundle is benign. The `SKILL.md` provides clear guardrails for the AI agent, explicitly instructing it to avoid arbitrary file access and prevent logging/exposing sensitive credentials. The `opensubtitles-api.sh` script safely constructs API requests using `jq` for URL and JSON encoding, mitigating shell injection risks. Crucially, `subtitle-context.sh` implements robust path validation, ensuring that subtitle files are only read from the designated `{baseDir}/storage/subtitles/` directory and have a `.srt` extension, preventing arbitrary file reads. There is no evidence of malicious intent, data exfiltration, or unauthorized actions.
Capability Assessment
Purpose & Capability
Name/description (OpenSubtitles read-only subtitle search/download and context extraction) match the required binaries (curl, jq, awk), the declared environment variables (API key and User-Agent), and the included scripts which call the OpenSubtitles API and extract .srt context. Optional credentials (username/password/token) are appropriate for login/download flows.
Instruction Scope
SKILL.md and the scripts keep behavior within the stated scope: API calls only target the OpenSubtitles endpoints, downloads are saved to a localized cache, subtitle reads are constrained to the storage directory, and guardrails explicitly forbid logging/exposing secrets. The agent instructions do ask it to append remaining download quota to user responses (a UI/response behavior, not an exfiltration risk).
Install Mechanism
This is an instruction-only skill with shell scripts included; there is no install spec that downloads or executes external code. No high-risk installation behavior detected.
Credentials
Requested env vars (OPENSUBTITLES_API_KEY and OPENSUBTITLES_USER_AGENT) are proportional and expected. Optional login creds/token are reasonable for download flows. Minor inconsistency: SKILL metadata lists awk as a required binary, and subtitle-context.sh uses awk, but the API script's internal dependency check only verifies curl and jq (it omits awk). This is an implementation oversight but not a malign issue.
Persistence & Privilege
The skill does not request always:true or any elevated platform privileges. It stores downloaded subtitles under its own storage path as expected and does not modify other skills or global configuration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install opensubtitles
  3. After installation, invoke the skill by name or use /opensubtitles
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
Nomenclature updates
v1.0.3
Security enhancement-stricter read paths for subtitles enforced
v1.0.1
Updated nomenclature and description
v1.0.0
Initial release
Metadata
Slug opensubtitles
Version 1.0.4
License
All-time Installs 0
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is OpenSubtitles Read-only?

Read-only OpenSubtitles skill to search and download subtitles via API, then extract scene context by timestamp to answer user questions regarding a show in... It is an AI Agent Skill for Claude Code / OpenClaw, with 411 downloads so far.

How do I install OpenSubtitles Read-only?

Run "/install opensubtitles" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is OpenSubtitles Read-only free?

Yes, OpenSubtitles Read-only is completely free (open-source). You can download, install and use it at no cost.

Which platforms does OpenSubtitles Read-only support?

OpenSubtitles Read-only is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created OpenSubtitles Read-only?

It is built and maintained by Magolo Dennis Ooki (@dennisooki); the current version is v1.0.4.

💬 Comments