Skills

Skills are AI Agent skill descriptors that tell AI assistants when to call a specific tool, how to call it, and how to handle the results. Think of it as an "instruction manual" for AI — once installed, the AI assistant knows when to automatically call PicGo to complete uploads.

picgo-upload

picgo-upload is the currently available Skill. It uploads local images or files to an image host and returns a shareable link.

Typical Use Cases

• Inserting images while writing docs, blog posts, or READMEs
• Converting screenshots to Markdown image links ![](url)
• Uploading PDFs, zips, or other files to get a public download link
• Inserting images while writing notes on Obsidian, Notion, Dev.to, Medium, etc.

How It Works

After installing the Skill, when you mention intents like "upload image", "insert screenshot", or "host this file" in your AI assistant, it will automatically detect and call PicGo to complete the upload. The upload routing logic:

1. PicGo desktop app first — If your PicGo GUI app is running, the Skill uploads via the local server, using whatever image host you've configured in the GUI.
2. Fall back to PicGo CLI — If the desktop app isn't running, the Skill calls picgo CLI to upload using the currently active uploader.
3. Recommend PicGo Cloud — If the CLI isn't installed or no image host is configured, the Skill will guide you to install the CLI and recommend PicGo Cloud as the default image host (the free plan covers everyday use).

Installation

Prerequisites

You need an AI assistant that supports Skills, such as Claude Code.

Run in your terminal:

npx skills@latest add PicGo/skills

Once installed, open your AI coding assistant (e.g. Claude Code, Codex) and it's ready to use — no additional configuration needed.