← Back to Skills Marketplace
328
Downloads
0
Stars
2
Active Installs
3
Versions
Install in OpenClaw
/install surge
Description
Blazing fast TUI download manager with multi-connection, queue management, server mode, multiple mirrors, and a beautiful terminal interface.
Usage Guidance
This skill appears to be a thin wrapper around a local 'surge' download manager and is generally coherent with that purpose, but there are small metadata inconsistencies (missing required-bins in registry metadata vs SKILL.md) and no install is provided, so the wrapper will call whatever 'surge' binary is on PATH. Before installing or running this skill: (1) Verify the upstream project/release you plan to install (prefer official GitHub releases or your OS package manager), (2) avoid running an untrusted 'surge' binary — inspect or build it from source if possible, (3) be aware the wrapper launches the surge binary with user-provided URLs/args (no extra sanitization), so run it with least privilege and avoid running as root, (4) confirm the SKILL.md homepage and registry info match the repository you download from. If you want higher assurance, request an install spec that pins a vetted package or includes a checksum for the binary.
Capability Analysis
Type: OpenClaw Skill
Name: surge
Version: 1.1.0
The OpenClaw skill 'surge' is a wrapper for the legitimate 'surge' download manager. The SKILL.md provides clear instructions for installation and usage, without any prompt injection attempts to subvert the agent's behavior. The `scripts/surge.py` uses `subprocess.run` and `subprocess.Popen` with lists of arguments, which is the secure method to execute external commands, preventing shell injection vulnerabilities. The script's functionality is entirely aligned with managing downloads and shows no evidence of malicious intent such as data exfiltration, unauthorized execution, or persistence mechanisms.
Capability Assessment
Purpose & Capability
The name, description, SKILL.md and scripts/surge.py all describe a wrapper for the 'surge' download manager and the advertised features (TUI, server mode, add/list/pause/resume) align with the code and instructions. However, registry metadata earlier listed no required binaries while SKILL.md metadata explicitly names the 'surge' binary and gives a GitHub homepage — this mismatch is inconsistent and worth verifying.
Instruction Scope
SKILL.md's runtime instructions stay on-task: how to install the surge binary, running server/TUI, adding URLs, and using tokens. The included wrapper script only runs the local 'surge' command, lists status, and starts the server. There are no instructions to read unrelated files, export environment secrets, or call external endpoints beyond the normal download flow.
Install Mechanism
There is no formal install spec in the registry (instruction-only), but SKILL.md recommends installing via brew, go install, or downloading a release from GitHub. That is reasonable, but because the skill will invoke a local 'surge' binary, you should confirm the binary's provenance (the SKILL.md points to a GitHub URL while the top metadata declared no homepage — another minor inconsistency).
Credentials
The skill doesn't request any environment variables, credentials, or config paths. The wrapper script doesn't read env vars or secrets. The only token mentioned is the surge application's API token (returned/managed by the surge binary itself), which is expected for a server-mode download manager.
Persistence & Privilege
The skill does not request 'always: true' or any elevated, persistent platform privileges. It starts subprocesses (surge server) as a normal user operation and does not modify other skills or system-wide agent configuration.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install surge - After installation, invoke the skill by name or use
/surge - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
v1.1.0 adds troubleshooting, reasoning framework, and improved guidance for users.
- Introduced a reasoning framework and decision tree to help users choose how to use surge.
- Added detailed troubleshooting section and common problem solutions.
- Included a self-check list covering installation and server status.
- Enhanced documentation with command references, examples, and workflow steps.
- Added metadata "category: utility".
v1.0.1
- Bumped version to 1.0.1 in SKILL.md.
- No other content or feature changes.
v1.0.0
Initial release of Surge – a blazing fast TUI download manager.
- Supports multi-connection downloads (up to 32 parallel connections)
- Features a beautiful terminal user interface (TUI)
- Server/daemon mode for headless downloading
- Queue management and batch downloads via command line
- Multiple mirror support with automatic failover
- Includes commands for pause, resume, remove, and status listing
Metadata
Frequently Asked Questions
What is Surge Download Manager?
Blazing fast TUI download manager with multi-connection, queue management, server mode, multiple mirrors, and a beautiful terminal interface. It is an AI Agent Skill for Claude Code / OpenClaw, with 328 downloads so far.
How do I install Surge Download Manager?
Run "/install surge" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Surge Download Manager free?
Yes, Surge Download Manager is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Surge Download Manager support?
Surge Download Manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Surge Download Manager?
It is built and maintained by KeXu9 (@kexu9); the current version is v1.1.0.
More Skills