Wordpress Ai Image Optimizer logo

Wordpress Ai Image Optimizer

Organization
respira-press
wordpress-ai-image-optimizer

Use when the user says 'optimize my wordpress images with ai', 'compress and optimize all images', 'audit my media library', or 'improve image performance'. Downloads images, compresses, converts to WebP, resizes and renames locally, re-uploads, and updates every content reference.

Overview

Publisherrespira-press
Repositoryagent-skills-wordpress
Skill namewordpress-ai-image-optimizer
Stars
50
Forks
8
Bundled files
Instructions only
LicenseMIT
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • Self-contained

    Everything the model needs lives in the instructions — no extra files to sync.

  • Open source

    Published by respira-press on GitHub. Read the source before you install it.

Installation

Install the Wordpress Ai Image Optimizer AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/respira-press/agent-skills-wordpress/tree/main/skills/wordpress-ai-image-optimizer
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/respira-press/agent-skills-wordpress.git /tmp/agent-skills-wordpress
mkdir -p .claude/skills
cp -r /tmp/agent-skills-wordpress/skills/wordpress-ai-image-optimizer .claude/skills/wordpress-ai-image-optimizer
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Wordpress Ai Image Optimizer in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Wordpress Ai Image Optimizer on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Wordpress Ai Image Optimizer is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

WordPress AI Image Optimizer

Version: 1.2.1 Updated: 2026-06-30 Freshly updated: v1.2.0 replaces per-image respira_update_media loops with a single respira_update_media_batch pass (up to ~50 items at once), snapshots the media library with respira_get_snapshot before the batch so the whole run is one-step reversible, runs the audit through respira_analyze_images, surfaces optional stock replacements via respira_search_stock_images + respira_sideload_image, and closes with a respira_generate_activity_report summary (e.g. "optimized 47 images, saved 1.2GB").

AI-powered image optimization for WordPress sites. Automatically compresses, converts formats, renames files, and updates all references. Processes images locally in AI code editor, creates optimized versions, and preserves originals for safety.

What This Skill Does

Scans:

  • All media library images
  • Images in posts and pages content
  • Featured images
  • Images in page builder elements (Elementor, Divi, Bricks, etc.)
  • WooCommerce product images
  • Images in custom post types

Detects:

  • File sizes (actual KB/MB on disk)
  • Image dimensions (width x height in pixels)
  • Format (JPG, PNG, GIF, WebP, AVIF, SVG)
  • Whether width/height attributes are set in HTML
  • Whether alt text exists (and quality)
  • Whether image is being used (orphaned media)
  • Whether responsive image sizes exist (WordPress srcset)
  • Compression quality (estimated from file size)
  • Lazy loading implementation
  • Non-SEO-friendly filenames (IMG_1234.jpg, screenshot.png, etc.)
  • Oversized originals (5000px uploaded when 2000px is max needed)
  • Missing srcset on content images
  • Builder images that bypass WordPress responsive system

Optimizes via AI Code Editor:

  • Downloads images from WordPress
  • Compresses with optimal quality settings (80-85% for JPG, lossless for PNG)
  • Converts to modern formats (WebP preferred, AVIF when appropriate)
  • Resizes oversized originals to optimal dimensions
  • Renames with SEO-friendly descriptive filenames
  • Generates missing alt text using AI
  • Regenerates WordPress responsive image sizes
  • Uploads optimized versions back to WordPress
  • Creates new media entries (keeps old files safe)
  • Updates all content references in duplicates

Provides:

  • Comprehensive image health score (0-100)
  • Impact-prioritized optimization opportunities
  • Before/after file size comparisons
  • Estimated page speed improvements
  • Plugin/CDN detection and recommendations

Requirements

  • Respira for WordPress plugin installed and connected
  • MCP connection active (desktop or WebMCP)
  • AI code editor with image processing tools (Claude Code, Cursor, etc.)
  • WooCommerce add-on (optional - for product image optimization)
  • Read access to scan images, write access to upload optimized versions

How to Use

Trigger Phrase

"optimize my wordpress images with ai"

Alternative Triggers

  • "run ai image optimization"
  • "compress and optimize all images"
  • "audit my media library"
  • "improve image performance"

What Happens

Phase 1: Comprehensive Image Audit

  1. Scans all images across site:
    • Media library (all uploaded files)
    • Content images (posts, pages, custom post types)
    • Featured images
    • Builder images (Elementor, Divi, Bricks, etc.)
    • WooCommerce product images (if WooCommerce active)
  2. Analyzes each image (use respira_analyze_images to drive the audit; it returns per-image findings in one call):
    • File size and format
    • Actual dimensions vs displayed dimensions
    • Alt text presence and quality
    • Filename SEO-friendliness
    • Usage (which pages/posts use this image)
    • Responsive image sizes (srcset)
    • Lazy loading implementation
  3. Detects optimization plugins/CDN:
    • Smush, ShortPixel, EWWW, Imagify, Optimole
    • Cloudflare, BunnyCDN, other CDNs
  4. Scores opportunities by impact:
    • File size x page traffic = optimization priority
    • Separates quick wins from big wins
  5. Generates comprehensive report

Phase 2: User Approval

Presents report and asks which optimizations to run:

  • Compress oversized images
  • Convert JPG/PNG -> WebP
  • Resize unnecessarily large originals
  • Rename non-SEO filenames
  • Add missing alt text
  • Regenerate responsive image sizes

User can choose:

  • "Optimize everything" (all optimizations)
  • "Compress only" (no format changes)
  • "Top 10 images" (highest impact first)
  • "Homepage images only" (critical pages first)

Phase 3: AI Processing

  1. Snapshot the media library before any writes with respira_get_snapshot so the entire batch is reversible in one step (respira_restore_snapshot). Take this once, before the batch — not per image.
  2. Downloads images from WordPress to local workspace.
  3. Processes images locally:
    • Compression
    • Format conversion
    • Resizing
    • SEO-friendly renaming
    • AI alt text generation
    • Optional: when an image is low quality or simply wrong for the page, find a replacement with respira_search_stock_images and pull it in with respira_sideload_image instead of re-optimizing the original
  4. Uploads optimized versions back to WordPress:
    • Creates NEW media entries (original files untouched)
    • Applies metadata in one pass with respira_update_media_batch rather than one respira_update_media call per image. The batch accepts up to ~50 items, so a typical library is updated in a single call (alt text, title, caption, description). Fall back to single respira_update_media only for one-off corrections.
    • Marks old files as "deprecated - replaced by [new-filename]"
  5. Updates content references in duplicates:
  • Creates duplicates of affected posts/pages
  • Replaces old image URLs with new optimized URLs
  • Updates builder and WooCommerce image references
  1. Regenerates responsive image sizes and srcset support

Phase 4: Review & Publish

  1. Provides before/after comparison:
  • File size savings
  • Format changes
  • Dimension changes
  • Filename improvements
  • Pages affected
  1. User reviews duplicates in WordPress admin
  2. User approves publishing
  3. Old files remain available for safety and rollback
  4. Generate a run summary with respira_generate_activity_report so the work is auditable in one line (e.g. "optimized 47 images, saved 1.2GB, added alt text to 31"). This reads from the change log Respira already recorded for the batch.

Honest Disclaimer

This skill downloads images, processes them with AI, and uploads optimized versions. You review all changes before publishing.

What this skill CANNOT do:

  • Guarantee perfect quality (compression is lossy)
  • Fix already broken/corrupted image files
  • Optimize CSS background images
  • Process images hosted externally outside WordPress uploads
  • Improve composition/art direction (technical optimization only)

What this skill CAN do:

  • Compress images without visible quality loss
  • Convert to WebP for significant size reduction
  • Resize oversized originals to practical dimensions
  • Rename files with SEO-friendly names
  • Generate descriptive alt text
  • Update references automatically in duplicates
  • Preserve originals for safety and rollback

Safety Model

  • Non-destructive: Creates NEW optimized images and keeps old files
  • Duplicate-first: Updates content in duplicates, never live pages
  • User approval required: Review before publishing
  • Rollback ready: Old files preserved and reversible
  • No live site impact until explicit approval

Technical Details

Uses these Respira MCP tools:

Audit:

  • respira_analyze_images (drives the Phase 1 audit; per-image findings in one call)

Media Operations:

  • respira_list_media
  • respira_get_media
  • respira_upload_media
  • respira_update_media_batch (primary metadata writer — up to ~50 items per call)
  • respira_update_media (single-item fallback / one-off corrections)
  • respira_delete_media (optional cleanup)

Stock Replacements (optional):

  • respira_search_stock_images
  • respira_sideload_image

Snapshot & Rollback:

  • respira_get_snapshot (capture before the batch)
  • respira_restore_snapshot (one-step revert)

Reporting:

  • respira_generate_activity_report (run summary: images optimized, space saved, alt text added; plugin 9.0 and later list it as a tool; on older plugins call respira_invoke_ability with ability: "respira/generate-activity-report" and the same arguments under args)

Content Scanning:

  • respira_list_pages
  • respira_list_posts
  • respira_read_page
  • respira_read_post
  • respira_get_builder_info

Content Updates:

  • respira_create_page_duplicate
  • respira_create_post_duplicate
  • respira_update_page
  • respira_update_post

WooCommerce (optional):

  • woocommerce_list_products
  • woocommerce_get_product
  • woocommerce_update_product

Plugin Detection:

  • respira_list_plugins

Related Skills

  • SEO & AEO Amplifier
  • WordPress Site DNA
  • Mobile Experience Report

Built by Respira Team https://respira.press/skills/wordpress-ai-image-optimizer

Frequently asked questions

What does the Wordpress Ai Image Optimizer AI skill do?

Use when the user says 'optimize my wordpress images with ai', 'compress and optimize all images', 'audit my media library', or 'improve image performance'. Downloads images, compresses, converts to WebP, resizes and renames locally, re-uploads, and updates every content reference.

Why use Wordpress Ai Image Optimizer on TypingMind?

Because you install it once and use it with any model. Wordpress Ai Image Optimizer is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Wordpress Ai Image Optimizer in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/respira-press/agent-skills-wordpress/tree/main/skills/wordpress-ai-image-optimizer. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Wordpress Ai Image Optimizer?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Wordpress Ai Image Optimizer?

As many as you like. As long as a model supports skills, you can use Wordpress Ai Image Optimizer with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Wordpress Ai Image Optimizer AI skill free?

Yes. It is published on GitHub by respira-press under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇