danielgwilson/image-mcp-skills · Archived

image-mcp

Use when the user explicitly wants to generate, edit, upload, or inspect images with Image MCP via the image-mcp CLI. Also use when the user asks about Image MCP model capabilities, generation history, or Image MCP-specific image workflows.

First seen Mar 16, 2026

Installation

$ npx skills add danielgwilson/image-mcp-skills --skill image-mcp

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1
Default branch main
Open issues 0
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,516 B
  • docs SUMMARY.md 257 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 2 installs

SKILL.md

Image MCP

Use the image-mcp CLI for Image MCP workflows.

If image-mcp is not installed globally, use npx --yes @image-mcp/cli ... instead. If npx fails because of local npm cache permissions, retry with NPMCONFIGCACHE="$(mktemp -d)" npx --yes @image-mcp/cli ....

Use this skill when

  • the user wants to create an image with Image MCP
  • the user wants to edit or remix an image with Image MCP
  • the user wants to upload a local image for later editing
  • the user wants to inspect Image MCP generation history
  • the user wants to inspect Image MCP model capabilities

Do not use this skill when

  • the user only wants generic image analysis
  • the user wants a different image provider specifically
  • the task is not actually about Image MCP

Workflow

  1. If image-mcp is on PATH, use it directly. Otherwise use npx --yes @image-mcp/cli ... or install it globally with npm install -g @image-mcp/cli.
  2. Run image-mcp doctor or image-mcp whoami if auth state is unclear.
  3. If auth is missing or stale, run image-mcp login and then image-mcp whoami.
  4. Use image-mcp models --json when you need current model capability info.
  5. Prefer --json when another agent step will consume the result.
  6. Use image-mcp create "<prompt>" for generation tasks. It waits by default; use --async when you want a job id immediately.
  7. Use image-mcp edit <image-ref> "<prompt>" for edits. Local file paths are uploaded automatically before the edit job is created.
  8. Use image-mcp job list to recover long or interrupted runs and image-mcp job get <job-id> to inspect a specific job.
  9. Use image-mcp job wait <job-id> --json when you need explicit polling instead of the default wait behavior.
  10. Use image-mcp job cancel <job-id> when a queued or running job should be stopped.

Fast path

  • image-mcp login
  • image-mcp whoami
  • image-mcp create "<prompt>"
  • npx --yes @image-mcp/cli login

References

  • For command usage patterns, see [references/cli-usage.md](references/cli-usage.md)
  • For model selection guidance, see [references/model-selection.md](references/model-selection.md)
  • For troubleshooting, see [references/troubleshooting.md](references/troubleshooting.md)