# Image Upload

> >

- **Type:** Skill
- **Install:** `agentstack add skill-lifedever-skills-plugin-image-upload`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [lifedever](https://agentstack.voostack.com/s/lifedever)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [lifedever](https://github.com/lifedever)
- **Source:** https://github.com/lifedever/skills-plugin/tree/main/skills/image-upload

## Install

```sh
agentstack add skill-lifedever-skills-plugin-image-upload
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# image-upload

Upload any image to your own GitHub repo and get back three URL formats — jsDelivr CDN (fast, public), GitHub raw, and Markdown — ready to paste into documentation, blog posts, or chats.

## Prerequisites (one-time setup)

1. **A GitHub repo for images.** Create one yourself (public preferred so jsDelivr CDN serves it), e.g. `your-username/images`.
2. **`gh` CLI installed and authenticated:**
   ```bash
   brew install gh
   gh auth login
   ```
3. **`jq` installed** (for JSON serialization):
   ```bash
   brew install jq
   ```
4. **`pngpaste` (only for clipboard screenshot mode):**
   ```bash
   brew install pngpaste
   ```
5. **Set environment variables** in your shell profile (`~/.zshrc` or `~/.bashrc`):
   ```bash
   export IMAGE_HOST_REPO="your-username/images"   # required
   export IMAGE_HOST_BRANCH="master"               # optional, default: master
   export IMAGE_HOST_BASE_DIR="uploads"            # optional, default: uploads
   ```
   Reload your shell or `source ~/.zshrc`.

Per-invocation overrides via `--repo`, `--branch`, `--base-dir` flags also work.

## Usage

Upload one or more files:

```bash
bash "${CLAUDE_SKILL_DIR}/scripts/upload_image.sh" path/to/image.png
bash "${CLAUDE_SKILL_DIR}/scripts/upload_image.sh" file1.jpg file2.png file3.webp
```

Upload from clipboard (most recent screenshot, or files copied in Finder):

```bash
bash "${CLAUDE_SKILL_DIR}/scripts/upload_image.sh" --clipboard
```

Auto-copy a specific URL format to system clipboard:

```bash
bash "${CLAUDE_SKILL_DIR}/scripts/upload_image.sh" --copy markdown file.png
bash "${CLAUDE_SKILL_DIR}/scripts/upload_image.sh" --copy jsdelivr --clipboard
bash "${CLAUDE_SKILL_DIR}/scripts/upload_image.sh" --copy raw file1.jpg file2.jpg
```

`--copy` values: `jsdelivr` (CDN), `raw` (GitHub raw), `markdown` (`` format).

## How it works

- Files are renamed to timestamp format: `20260513-143025.jpg`. Batch uploads add an index: `-1`, `-2`, etc.
- Each image is committed to `/YYYY/MM/.` in your repo.
- Filename conflicts auto-resolve with a numeric suffix.
- Multiple files upload in parallel (with retry on transient 409s from branch HEAD races).
- For each image, three URLs are printed: jsDelivr CDN, GitHub raw, and Markdown.

## Calling from Claude Code

The Bash tool does NOT support interactive input, so when invoked through Claude:

1. Run the upload **without** `--copy` to get the URLs in stdout.
2. Use `AskUserQuestion` to ask which format the user wants to copy. Options:
   - jsDelivr CDN URL
   - GitHub Raw URL
   - Markdown format
   - Don't copy
3. Based on the answer, use `echo -n "" | pbcopy` to copy that exact format.

When the user runs the script directly in their terminal (not through Claude), the script has its own built-in interactive prompt.

## Failure modes

- `IMAGE_HOST_REPO` not set → script exits with code 2 and prints setup instructions
- `gh` not authenticated → script exits with code 2 and tells user to run `gh auth login`
- `jq` / `pngpaste` missing → script exits with helpful install hint
- Upload fails after 3 retries → script reports the specific file that failed; other parallel uploads continue

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [lifedever](https://github.com/lifedever)
- **Source:** [lifedever/skills-plugin](https://github.com/lifedever/skills-plugin)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-lifedever-skills-plugin-image-upload
- Seller: https://agentstack.voostack.com/s/lifedever
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.