Skip to content
Back to search

pixmint

MarketplaceWorks with Claude CodeGitHub

Claude Code plugin: generate and edit images, SVGs and GIFs with the OpenAI Images API

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tsepelev--pixmint/badge.svg)](/listings/tsepelev--pixmint)

HTML

<a href="/listings/tsepelev--pixmint"><img src="/api/listings/tsepelev--pixmint/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

/plugin marketplace add tsepelev/pixmint
/plugin install pixmint@pixmint

Requirements:

- [uv](https://docs.astral.sh/uv/) on your `PATH`. The scripts run in a uv environment pinned by [`uv.lock`](skills/image/scripts/uv.lock) (`openai`, `pillow`), created in `~/.cache/pixmint/venv` (override with `PIXMINT_VENV`). Your project's own virtualenv is never touched. - An OpenAI API key with access to GPT Image models (your organization may need to complete [verification](https://help.openai.com/en/articles/10910291-api-organization-verification)).

Provide the key in one of two ways:

- set `OPENAI_API_KEY` in your shell profile, or - save it to `~/.config/openai/api_key` (`chmod 600`); another path can be set with `OPENAI_API_KEY_FILE`.

Then ask Claude to run the check, or run it yourself: `bash <plugin>/skills/image/scripts/run.sh --check`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines
  1. {
  2. "name": "pixmint",
  3. "owner": {
  4. "name": "Sergey Tsepelev",
  5. "url": "https://github.com/tsepelev"
  6. },
  7. "metadata": {
  8. "description": "pixmint: generate and edit images, SVGs and animated GIFs with the OpenAI Images API from Claude Code."
  9. },
  10. "plugins": [
  11. {
  12. "name": "pixmint",
  13. "source": "./",
  14. "description": "Generate and edit images, SVGs and animated GIFs with the OpenAI Images API from Claude Code."
  15. }
  16. ]
  17. }
README.md · README · 69 lines
  1. <p align="center">
  2. <img src=".claude-plugin/icon.png" alt="pixmint icon" width="128">
  3. </p>
  4. <h1 align="center">pixmint</h1>
  5. <p align="center">Generate and edit images, SVGs and animated GIFs from Claude Code with the OpenAI Images API.</p>
  6. A [Claude Code](https://code.claude.com) plugin for the [OpenAI Images API](https://developers.openai.com/api/docs/guides/image-generation) that works with your own OpenAI API key. It covers photos, illustrations, hero images, sprites, textures, mockups, transparent cutouts, SVG logos and illustrations, animated GIFs, and edits of existing pictures (masks, reference images, markup overlays).
  7. Claude writes a structured prompt, starts with a cheap draft, runs the bundled CLI, opens the result to check it against your request, and reports the file path, the prompt and the cost of the call.
  8. > pixmint is not affiliated with or endorsed by OpenAI or Anthropic.
  9. ## Install
  10. ```text
  11. /plugin marketplace add tsepelev/pixmint
  12. /plugin install pixmint@pixmint
  13. ```
  14. Requirements:
  15. - [uv](https://docs.astral.sh/uv/) on your `PATH`. The scripts run in a uv environment pinned by [`uv.lock`](skills/image/scripts/uv.lock) (`openai`, `pillow`), created in `~/.cache/pixmint/venv` (override with `PIXMINT_VENV`). Your project's own virtualenv is never touched.
  16. - An OpenAI API key with access to GPT Image models (your organization may need to complete [verification](https://help.openai.com/en/articles/10910291-api-organization-verification)).
  17. Provide the key in one of two ways:
  18. - set `OPENAI_API_KEY` in your shell profile, or
  19. - save it to `~/.config/openai/api_key` (`chmod 600`); another path can be set with `OPENAI_API_KEY_FILE`.
  20. Then ask Claude to run the check, or run it yourself: `bash <plugin>/skills/image/scripts/run.sh --check`.
  21. ## Usage
  22. Just ask in plain language; the skill triggers on requests to draw, generate or edit pictures. Invoke it explicitly with `/pixmint:image`. Examples:
  23. 1. *"Make a landing-page hero image of a ceramic mug on a stone table, empty space on the left for copy. Draft first."*
  24. 2. *"Generate an orange cat game sprite on a transparent background, 1024×1024."*
  25. 3. *"Create an SVG logo for a bakery called Field & Flour."*
  26. 4. *"Make a short looping GIF of a blinking cartoon sun."*
  27. 5. *"In photo.png, replace only the background with a warm sunset; keep the person unchanged."*
  28. Defaults: model `gpt-image-2.6-flare` (Sunburst for finals and precise edits), quality `medium`, drafts at `low`. Claude asks before using `xhigh`/`max` quality, 4K sizes or many variants.
  29. ## What it sends, runs and costs
  30. - **Data sent to OpenAI:** your prompt and any input images, masks or markup overlays you ask to edit go to `api.openai.com` under your API key. For SVG output, OpenAI also runs a text model (default `gpt-6.2-astra`) that writes the SVG. OpenAI's handling of API data is described in its [privacy policy](https://openai.com/policies/privacy-policy/) and [API data usage policies](https://openai.com/policies/api-data-usage-policies/). pixmint itself collects nothing and has no server.
  31. - **Credentials:** the wrapper reads `OPENAI_API_KEY` or the key file and passes it only to the OpenAI Python SDK. The key is never printed or written anywhere.
  32. - **What runs locally:** `bash` and `uv` (which may download Python and the pinned packages from PyPI on first run), the bundled Python scripts, and on macOS optionally `qlmanage` to preview SVGs. Generated files are written only to paths Claude passes with `--out`.
  33. - **Cost:** every call is billed to your OpenAI account. After each call the script prints token usage and an estimated price, e.g. a `low` draft on Flare at 1536×1024 is about $0.02. See [OpenAI pricing](https://developers.openai.com/api/docs/pricing#image-generation).
  34. ## Layout
  35. ```text
  36. .claude-plugin/plugin.json plugin manifest
  37. .claude-plugin/marketplace.json single-plugin marketplace for /plugin install
  38. skills/image/SKILL.md instructions Claude follows
  39. skills/image/references/ CLI, prompting and recipe references
  40. skills/image/scripts/ image_gen.py, remove_chroma_key.py, run.sh, pinned uv project
  41. ```
  42. ## Support
  43. Questions and bug reports: [GitHub issues](https://github.com/tsepelev/pixmint/issues).
  44. ## License
  45. [Apache License 2.0](LICENSE). Derived from the `imagegen` skill bundled with OpenAI Codex (Apache-2.0); see [NOTICE](NOTICE) for attribution and the list of changes.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.