From 55a57a74cef0165697a7ef6b6993104e34021be9 Mon Sep 17 00:00:00 2001 From: Facundo Farias Date: Thu, 29 Oct 2026 08:07:42 +0100 Subject: [PATCH] docs: document optimized_url in the host-image and upload skills Plugin 1.7.0. The CLI --optimized flag is not mentioned until it is released. Co-Authored-By: Claude Sonnet 5.5 Claude-Session: https://claude.ai/code/session_019sMZVurbKqZ6zsbUYCsLJn --- .claude-plugin/plugin.json | 2 +- skills/pixelvault-host-image/SKILL.md | 3 +++ skills/pixelvault-upload/SKILL.md | 3 +++ 3 files changed, 7 insertions(+), 1 deletion(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 619ebae..70fae1b 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "pixelvault", "description": "Upload, manage, and serve images via PixelVault — agent-first image hosting for developers and AI coding agents.", - "version": "1.6.0", + "version": "1.7.0", "author": { "name": "PixelVault", "email": "hello@pixelvault.dev" diff --git a/skills/pixelvault-host-image/SKILL.md b/skills/pixelvault-host-image/SKILL.md index f6adaca..19a24f7 100644 --- a/skills/pixelvault-host-image/SKILL.md +++ b/skills/pixelvault-host-image/SKILL.md @@ -41,6 +41,9 @@ The `X-PixelVault-Client` header only tells PixelVault which skill made the call | Link lifetime | 30 days (`"temporary": true`) | Permanent | | Import from a URL | No | Yes | | Private signed links | No | Yes | +| Smaller WebP/AVIF link (`data.optimized_url`) | No | Yes (public raster images) | + +With a key, public raster uploads (PNG, JPEG, WebP, AVIF) also return `data.optimized_url`: the same image as WebP or AVIF, usually far smaller. Prefer it when the link goes into a page, README or email, and keep `data.url` as the original. It is absent for SVG, GIF and private uploads, so fall back to `data.url`: `jq -r '.data.optimized_url // .data.url'`. Keyless is the default. Do not ask the user to sign up before the first upload. If the user wants links that never expire, tell them to create a free account at diff --git a/skills/pixelvault-upload/SKILL.md b/skills/pixelvault-upload/SKILL.md index 8c5d2b7..86ca8cf 100644 --- a/skills/pixelvault-upload/SKILL.md +++ b/skills/pixelvault-upload/SKILL.md @@ -77,6 +77,9 @@ pixelvault upload screenshot.png pixelvault upload diagram.svg --json # → { "id": "img_xyz", "url": "https://...", "size": 12400, ... } +# Public raster uploads also include optimized_url (WebP/AVIF, usually much smaller) in --json output; +# prefer it over url when embedding. Absent for SVG, GIF and private uploads. + # Bulk upload pixelvault upload ./assets/*.png --folder assets