image-publisher

Upload local images to image hosting services and get accessible URLs. Use this skill when the user wants to upload a local image file to an image host and get the public URL. Supports GitHub and S3-compatible storage (Qiniu, Aliyun OSS, Tencent COS, etc.).

16 stars

Best use case

image-publisher is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Upload local images to image hosting services and get accessible URLs. Use this skill when the user wants to upload a local image file to an image host and get the public URL. Supports GitHub and S3-compatible storage (Qiniu, Aliyun OSS, Tencent COS, etc.).

Teams using image-publisher should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/image-publisher/SKILL.md --create-dirs "https://raw.githubusercontent.com/diegosouzapw/awesome-omni-skill/main/skills/content-media/image-publisher/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/image-publisher/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How image-publisher Compares

Feature / Agentimage-publisherStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Upload local images to image hosting services and get accessible URLs. Use this skill when the user wants to upload a local image file to an image host and get the public URL. Supports GitHub and S3-compatible storage (Qiniu, Aliyun OSS, Tencent COS, etc.).

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Image Publisher

一键将本地图片上传到图床,获取可访问的图片链接。

## 功能

- 上传本地图片到图床
- 返回可直接访问的图片 URL
- 支持 GitHub 图床
- 支持 S3 兼容存储(七牛云、阿里云 OSS、腾讯云 COS 等)
- 支持按年/月/日路径存储
- 自动检测文件名冲突,避免覆盖

## 使用前配置

### 配置方式:使用 .env 文件

在技能目录创建 `.env` 文件:

```bash
cd ~/.claude/skills/image-publisher
cp .env.example .env
```

编辑 `.env` 文件:

```bash
# GitHub 配置
GITHUB_TOKEN=your_github_personal_access_token
GITHUB_USER=your_username
GITHUB_REPO=your_repo
GITHUB_BRANCH=master
GITHUB_IMAGES_DIR=images

# 路径模式(可选)
# flat: 平铺模式,images/xxx.png
# date: 按日期,images/2026/01/12/xxx.png
GITHUB_PATH_MODE=flat
```

### S3 图床配置(七牛云等)

编辑 `.env` 文件:

```bash
# 选择 S3 图床
PROVIDER_TYPE=s3

# S3 配置
S3_ACCESS_KEY_ID=your_access_key_id
S3_SECRET_ACCESS_KEY=your_secret_access_key
S3_BUCKET=your_bucket
S3_ENDPOINT=s3.cn-south-1.qiniucs.com
S3_REGION=cn-south-1
S3_IMAGES_DIR=images
S3_PATH_MODE=flat

# 可选:自定义域名(CDN 加速)
# S3_DOMAIN=https://cdn.example.com
```

**七牛云 S3 配置示例:**

| 配置项 | 示例值 |
|--------|--------|
| `S3_ENDPOINT` | `s3.cn-south-1.qiniucs.com` |
| `S3_REGION` | `cn-south-1` |

**安装依赖:**

```bash
pip install boto3
```

### 获取 GitHub Token

1. 访问 https://github.com/settings/tokens
2. 生成新 Token,勾选 `repo` 权限

## 使用方式

```
我: 上传图片 ~/Desktop/screenshot.png
Claude: [调用技能上传图片]
```

## 支持的图片格式

png, jpg, jpeg, gif, webp, svg, bmp, ico

## 输出结果

发布成功后会返回:

```json
{
  "filename": "screenshot.png",
  "path": "images/2026/01/12/screenshot.png",
  "raw_url": "https://raw.githubusercontent.com/user/rebo/master/images/2026/01/12/screenshot.png",
  "cdn_url": "https://cdn.jsdelivr.net/gh/user/rebo@master/images/2026/01/12/screenshot.png"
}
```

当 `GITHUB_PATH_MODE=flat` 时路径为 `images/screenshot.png`,当 `GITHUB_PATH_MODE=date` 时路径为 `images/2026/01/12/screenshot.png`。

## 不做什么

- 不编辑图片(裁剪、压缩等)
- 不提供批量上传
- 不提供相册管理功能

## 资源

- **Scripts**: `scripts/upload.py` - 上传脚本
- **References**: `references/config.md` - 配置参考

Related Skills

all-images-ai-automation

16
from diegosouzapw/awesome-omni-skill

Automate All Images AI tasks via Rube MCP (Composio). Always search tools first for current schemas.

ai-image-generator

16
from diegosouzapw/awesome-omni-skill

使用 ModelScope 等平台生成 AI 图像。当用户需要生成图像、设计图标、创建角色立绘,或需要帮助编写 AI 绘画提示词时使用此技能。支持直接生成图像和仅优化提示词两种模式。

xhs-images

16
from diegosouzapw/awesome-omni-skill

Xiaohongshu (Little Red Book) infographic series generator with multiple style options. Breaks down content into 1-10 cartoon-style infographics. Use when user asks to create "小红书图片", "XHS images", or "RedNote infographics".

x-image-cards

16
from diegosouzapw/awesome-omni-skill

Create X/Twitter cards that look like images, not marketing banners. Use when asked to "create OG images", "set up X cards", "make social cards", or "twitter card without text".

wiro-image-fill

16
from diegosouzapw/awesome-omni-skill

Generate missing or placeholder images in a project by calling the Wiro image generation API, saving assets under public/assets generated folders, and producing a JSON mapping. Use when you see empty img src, placeholder.png, or other image gaps that need real assets.

seedream-image-generator

16
from diegosouzapw/awesome-omni-skill

Generate images using the Doubao SeeDream API based on text prompts. Use this skill when users request AI-generated images, artwork, illustrations, or visual content creation. The skill handles API calls, downloads generated images to the project's /pic folder, and supports batch generation of up to 4 sequential images.

placeholder-images

16
from diegosouzapw/awesome-omni-skill

Rule to use placekitten.com for placeholder images in seed data.

og-image-generator

16
from diegosouzapw/awesome-omni-skill

Generate and optimize Open Graph meta images for social media sharing. Use this skill when building web applications that need dynamic OG image generation with support for Vercel's @vercel/og library, pre-generated image storage, and social media optimization (Twitter Cards, Facebook, LinkedIn). Handles dynamic routes, performance optimization, and includes best practices for crawler compatibility and testing.

nanobanana-image

16
from diegosouzapw/awesome-omni-skill

Nano Banana (Google Gemini API) を使って画像を生成・編集するスキル。「画像を生成して」「イラストを作って」「○○の絵を描いて」「画像を作成」「この画像を編集して」「この画像をもとに○○を作って」「generate an image」「create a picture」「edit this image」などの依頼があった場合に使用。テキストからの生成、参照画像からの生成、画像編集、Google検索グラウンディングによる最新情報を反映した画像生成に対応。「最新の○○」「トレンドを反映」「リアルタイム情報」といった依頼にも対応可能。

nano-image-generate

16
from diegosouzapw/awesome-omni-skill

Generate images using Nano Banana (Flash) or Nano Banana Pro. Use 'flash' for speed/efficiency and 'pro' for high quality, text rendering, and complex prompt adherence. Triggers include 'generate image', 'create logo', 'fast image', 'high quality image'.

imagen

16
from diegosouzapw/awesome-omni-skill

AI image generation skill powered by Google Gemini, enabling seamless visual content creation for UI placeholders, documentation, and design assets.

imagekit-io-automation

16
from diegosouzapw/awesome-omni-skill

Automate Imagekit IO tasks via Rube MCP (Composio). Always search tools first for current schemas.