← Back to Skills Marketplace
r2-uploader
by
Alex Redisread
· GitHub ↗
· v1.0.3
· MIT-0
195
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install r2-uploader
Description
使用 wrangler CLI 上传文件到 Cloudflare R2 对象存储，返回公开访问 URL。支持单文件上传、从远程 URL 直接上传、批量上传。当用户说"上传到 R2"、"传到 Cloudflare"、"存到 R2"、"上传图片/文件/附件"并提到 R2 或 wrangler 时使用。触发词：上传、R...
Usage Guidance
This skill appears to do what it says (upload files to Cloudflare R2 via wrangler), but review and tighten it before trusting it with your system:
- Confirm wrangler is installed and authenticated on the environment the agent will run in. The skill expects wrangler use (wrangler whoami / login) and Cloudflare credentials, but the registry entry does not declare those requirements.
- Be cautious about the 'find ~ -name ...' step: it scans the entire home directory. If you install/use this skill, prefer restricting the search path (ask the skill to only look in a specific folder) or require explicit file paths to avoid accidental discovery/upload of sensitive files.
- Note batch and concurrent upload examples can send many files at once — ensure the R2 bucket and upload rules are correct and that you won’t accidentally publish private data.
- Because env vars (R2_BUCKET, R2_DOMAIN) and authentication needs are not declared in metadata, the agent UI may not prompt you to provide tokens or warn about secrets. Consider providing Cloudflare credentials via the standard secure mechanism used by your platform rather than relying on the skill to prompt.
If you need to proceed safely: test the skill in a disposable/sandbox account and/or modify the SKILL.md to limit filesystem search paths and to explicitly declare the required environment variables/credentials (and any expected wrangler binary).
Capability Analysis
Type: OpenClaw Skill
Name: r2-uploader
Version: 1.0.3
The skill bundle provides legitimate functionality for managing Cloudflare R2 storage using the wrangler CLI. It includes standard operations for finding, uploading, and batch-processing files, as well as diagnostic steps for authentication and error handling. No evidence of data exfiltration, malicious persistence, or obfuscation was found; the use of shell commands like 'find' and 'curl' is directly aligned with the stated purpose of file management and remote uploads.
Capability Assessment
Purpose & Capability
The skill claims to upload to Cloudflare R2 via the wrangler CLI, which matches the instructions; however the registry metadata declares no required env vars or binaries while the SKILL.md repeatedly references $R2_BUCKET, $R2_DOMAIN and implicitly requires the wrangler CLI to be installed and authenticated. That mismatch (declared requirements vs actual instructions) is inconsistent.
Instruction Scope
Runtime instructions tell the agent to run broad filesystem commands (find ~ -name ...) and ls -la on discovered paths. While locating files is reasonable for an uploader, searching the entire home directory can expose unrelated files and metadata. The skill also supports batch/concurrent uploads which can upload many files without per-file confirmation.
Install Mechanism
Instruction-only skill with no install spec or code files; nothing is written to disk by an installer. This is the lowest install risk.
Credentials
SKILL.md expects $R2_BUCKET and optionally $R2_DOMAIN and also relies on wrangler authentication (wrangler whoami / wrangler login) but the registry lists no required environment variables or primary credential. The skill does not declare Cloudflare-related credentials (e.g., CF_API_TOKEN) even though they are typically needed; this under-declaration is misleading and prevents reviewers from seeing what secrets are required.
Persistence & Privilege
The skill is not always-enabled and does not request long‑lived platform privileges or attempt to modify other skills or system-wide config. Autonomous invocation is allowed (platform default) but not combined with other high-privilege requests.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install r2-uploader - After installation, invoke the skill by name or use
/r2-uploader - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- Removed the internal file _meta.json.
- Updated documentation to clarify supported usage scenarios and triggers.
- Improved descriptions of environment variables and common commands.
- Enhanced instructions for uploading directly from remote URLs.
- Added details for object deletion and clarified default/custom domain URL responses.
v1.0.2
Version 1.0.2
- Initial release of the r2-uploader skill.
- Added full git tracking and project metadata.
- Included step-by-step documentation for using wrangler to upload files to Cloudflare R2, including handling paths with spaces or Chinese characters.
- Provided best practices, troubleshooting, and URL generation rules.
- Added advanced usage and error-handling guides.
v1.0.1
update name
v1.0.0
r2-uploader 1.0.0 – Initial release
- Upload files to Cloudflare R2 using the wrangler CLI.
- Supports batch uploads, uploads via URL, and auto-generates public URLs.
- Handles file paths with spaces or non-ASCII characters by using temporary files if necessary.
- Provides troubleshooting steps for common errors and best practices for file organization.
- Allows configuration of default bucket and custom domain via environment variables.
Metadata
Frequently Asked Questions
What is r2-uploader?
使用 wrangler CLI 上传文件到 Cloudflare R2 对象存储，返回公开访问 URL。支持单文件上传、从远程 URL 直接上传、批量上传。当用户说"上传到 R2"、"传到 Cloudflare"、"存到 R2"、"上传图片/文件/附件"并提到 R2 或 wrangler 时使用。触发词：上传、R... It is an AI Agent Skill for Claude Code / OpenClaw, with 195 downloads so far.
How do I install r2-uploader?
Run "/install r2-uploader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is r2-uploader free?
Yes, r2-uploader is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does r2-uploader support?
r2-uploader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created r2-uploader?
It is built and maintained by Alex Redisread (@redisread); the current version is v1.0.3.
More Skills