tiangong-ai/skills

convert-image-to-jpg

Convert local image files from common raster formats into JPG while setting a target DPI (default 96).

First seen Mar 12, 2026

Installation

$ npx skills add tiangong-ai/skills --skill convert-image-to-jpg

Summary

  • Convert local image files from common raster formats into JPG while setting a target DPI (default 96).
  • Use when Codex needs to convert a file or folder of images such as HEIC, HEIF, PNG, TIFF, WebP, BMP, GIF, AVIF, or JPEG into `.jpg` for upload, OCR, archiving, or tools that require JPEG output.

Similar popular skills

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

Also in this package

Other skills from tiangong-ai/skills · top by installs.

npx skills add tiangong-ai/skills

Browse all from tiangong-ai/skills

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 9
License LICENSE
Default branch main
Open issues 3
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,884 B
  • docs SUMMARY.md 325 B

History

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

SKILL.md

Convert Image to JPG

Core Goal

  • Convert one local image or a directory tree of local images into .jpg.
  • Write JPG DPI metadata as 96 by default or a caller-provided value.
  • Preserve relative directory structure when the input path is a directory.

Required Tools

  • Use scripts/converttojpg.py.
  • Rely only on Python standard library modules. Do not install Python packages for this skill.
  • Prefer magick when it is installed.
  • Fall back to macOS sips when magick is unavailable.
  • Stop and report the missing dependency when neither backend exists.

Quick Start

  1. Convert one file to a specific JPG path:
python3 scripts/convert_to_jpg.py \
  --input-path /path/to/image.heic \
  --output-path /path/to/output.jpg
  1. Convert a directory recursively with custom DPI:
python3 scripts/convert_to_jpg.py \
  --input-path /path/to/input-images \
  --output-path /path/to/output-images \
  --dpi 300
  1. Rewrite existing outputs in place or replace previous runs:
python3 scripts/convert_to_jpg.py \
  --input-path /path/to/input-images \
  --output-path /path/to/output-images \
  --overwrite
  1. Preview the conversion plan without writing files:
python3 scripts/convert_to_jpg.py \
  --input-path /path/to/input-images \
  --output-path /path/to/output-images \
  --dry-run

Behavior

  • Treat directory input as recursive and keep the same relative subdirectories in the output tree.
  • Treat single-file --output-path as a directory when it has no .jpg or .jpeg suffix.
  • Convert .jpg and .jpeg inputs too. Use this to normalize output names or rewrite DPI metadata.
  • Default JPG quality to 95.
  • Use the first frame or page when the source format can contain multiple frames, such as GIF or TIFF.
  • Refuse ambiguous directory conversions when two source files would map to the same destination .jpg.
  • Add uncommon extensions with --extra-extension .ext when needed.

Main Arguments

  • --input-path: source file or source directory
  • --output-path: output JPG file path or output directory
  • --dpi: target DPI metadata for the JPG output, default 96
  • --quality: JPG quality from 1 to 100, default 95
  • --backend: auto, magick, or sips
  • --extra-extension: additional directory-scan suffix to include
  • --overwrite: replace existing outputs
  • --dry-run: print the plan without converting files
  • --limit: cap the number of files processed during a quick check

Script

  • scripts/converttojpg.py