360 Secure SkillHub
360 安全技能中心

Cloudinary Cli

该 Skill 通过 Go 编写的 CLI 将本地文件或远程 URL 上传到 Cloudinary CDN；上传前检查 CLI 是否已安装、检查 .env 中的云名称与 API 凭据是否完整，默认对常见图片格式启用自动质量压缩，非图片文件保持原样，并支持一次传入多个文件。

mnhkahn
mnhkahn
热度 29.61
最近更新 2026-05-11 17:46:29
分类：自动化依赖：代码执行 / 读写文件 / 第三方 API应用场景：自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add cloudinary-cli
Metadata
name
cloudinary-cli
description
Upload files and images to Cloudinary via CLI. Use when user wants to upload local files or images to Cloudinary CDN, especially when needing automatic image compression or batch uploads. Triggers on phrases like "upload to cloudinary", "传图到cloudinary", "上传图片", "cloudinary上传".

Cloudinary CLI Uploader

Upload local files or remote URLs to Cloudinary with automatic image compression support.

Workflow

1. Check Installation

Check if the CLI binary exists at ./cloudinary-cli (project root). If not, run the install script:

bash .agents/skills/cloudinary-cli/scripts/install.sh

If Go is not installed, prompt the user to install Go first.

2. Check Configuration (.env)

Check if cmd/cli/.env exists and contains all required variables. If any are missing, prompt the user for the missing values and write them to cmd/cli/.env.

Required variables:

  • CLOUDINARY_CLOUD - Cloudinary cloud name
  • CLOUDINARY_KEY - API key
  • CLOUDINARY_SECRET - API secret

Optional variables:

  • CLOUDINARY_DIRECTORY - Upload folder (default: root)
  • CLOUDINARY_COMPRESS - Auto-compress images: true/false (default: true)

3. Upload Files

Run the upload script with file paths:

bash .agents/skills/cloudinary-cli/scripts/upload.sh <file1> [file2] ...

Or run the CLI directly:

cd cmd/cli && ../../cloudinary-cli file1.jpg file2.png

The CLI automatically:

  • Compresses images when CLOUDINARY_COMPRESS=true
  • Leaves non-image files untouched
  • Supports both local paths and remote URLs

Image Compression

When CLOUDINARY_COMPRESS is true (default), images are uploaded with Cloudinary q_auto transformation for automatic quality optimization. Supported image formats: jpg, jpeg, png, gif, webp, bmp, tiff, svg, ico, heic, heif, avif.

To disable compression for a specific upload, temporarily set CLOUDINARY_COMPRESS=false in .env.