How do I install the Surgepix Upload skill?

Run npx skillmds@latest add surgepix/surgepix-upload in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Surgepix Upload safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Surgepix Upload?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Surgepix Upload free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Surgepix Upload?

SurgePix (@surgepix) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Surgepix Upload by surgepix — Agent Skill

Name: Surgepix Upload
Author: SurgePix

Surgepix Upload

Upload local files to SurgePix cloud storage and return a public HTTPS URL. Use when the user says "upload", "get a URL", "上传文件", "传到CDN", needs a remote-accessible URL for an API call, or wants to convert a local file path into a public link.

SurgePix Updated Sep 21, 2026

File contents

SurgePix Upload

Upload a local file to SurgePix storage and get back a public CDN URL.

Language consistency

This skill does not generate on-image text. Reply to the user in the same language they used in their request.

When to use

User says "upload this file", "get a URL for this image", "上传", "传到线上"
Before calling any web API that needs a remote URL instead of a local path

Prerequisites

Node.js >= 18
SURGEPIX_API_KEY configured (see Step 0)

Workflow

Step 0: Check environment (required)

Before running upload, verify config:

node "<skills-dir>/surgepix-setup/scripts/check_env.mjs"

Exit 0 → proceed to Step 1
Exit 1 → follow surgepix-setup skill to configure .env, then retry

Do NOT check $SURGEPIX_API_KEY in shell — the script loads .env automatically.

Step 1: Identify the file

Get the absolute path to the local file
Confirm the file exists

Step 2: Run upload

node "<skills-dir>/surgepix-upload/scripts/file_upload.mjs" "<absolute-file-path>"

Step 3: Parse output

Success (stdout):

{"ok":true,"url":"<PUBLIC_URL>","filename":"photo.png","size":12345,"contentType":"image/png","existing":false}

Failure (stderr, non-zero exit):

{"ok":false,"error":"<ERROR>"}

If error is "API_KEY not found" → run surgepix-setup first.

Step 4: Use the URL

Show the url to the user
Pass it to any API that needs a remote file URL

Rules

ALWAYS run check_env before first use in a session
NEVER pass local paths to web APIs — upload first, use the returned URL
NEVER invent or guess a URL
NEVER echo auth tokens

---name: surgepix-uploaddescription: Upload local files to SurgePix cloud storage and return a public HTTPS URL. Use when the user says "upload", "get a URL", "上传文件", "传到CDN", needs a remote-accessible URL for an API call, or wants to convert a local file path into a public link.---# SurgePix UploadUpload a local file to SurgePix storage and get back a public CDN URL.## Language consistencyThis skill does not generate on-image text. Reply to the user in the **same language they used** in their request.## When to use- User says "upload this file", "get a URL for this image", "上传", "传到线上"- Before calling any web API that needs a remote URL instead of a local path## Prerequisites- Node.js >= 18- `SURGEPIX_API_KEY` configured (see Step 0)## Workflow### Step 0: Check environment (required)Before running upload, verify config:```bashnode "<skills-dir>/surgepix-setup/scripts/check_env.mjs"```- **Exit 0** → proceed to Step 1- **Exit 1** → follow **surgepix-setup** skill to configure `.env`, then retryDo NOT check `$SURGEPIX_API_KEY` in shell — the script loads `.env` automatically.### Step 1: Identify the file- Get the absolute path to the local file- Confirm the file exists### Step 2: Run upload```bashnode "<skills-dir>/surgepix-upload/scripts/file_upload.mjs" "<absolute-file-path>"```### Step 3: Parse output**Success** (stdout):```json{"ok":true,"url":"<PUBLIC_URL>","filename":"photo.png","size":12345,"contentType":"image/png","existing":false}```**Failure** (stderr, non-zero exit):```json{"ok":false,"error":"<ERROR>"}```If error is "API_KEY not found" → run surgepix-setup first.### Step 4: Use the URL- Show the `url` to the user- Pass it to any API that needs a remote file URL## Rules- ALWAYS run check_env before first use in a session- NEVER pass local paths to web APIs — upload first, use the returned URL- NEVER invent or guess a URL- NEVER echo auth tokens

Frequently asked questions