# Pixelmatch Pixel-Level Image Comparison Library by Mapbox

> Pixelmatch is the smallest, simplest, and fastest JavaScript pixel-level image comparison library by Mapbox. It features anti-aliased pixel detection and perceptual color difference metrics, making it ideal for visual regression testing in CI/CD pipelines.

- Skill: `agentskillexchange/pixelmatch-pixel-level-image-comparison-library-by-mapbox` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/pixelmatch-pixel-level-image-comparison-library-by-mapbox`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/pixelmatch-pixel-level-image-comparison-library-by-mapbox/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/pixelmatch-pixel-level-image-comparison-library-by-mapbox

---


# Pixelmatch Pixel-Level Image Comparison Library by Mapbox

Pixelmatch is the smallest, simplest, and fastest JavaScript pixel-level image comparison library by Mapbox. It features anti-aliased pixel detection and perceptual color difference metrics, making it ideal for visual regression testing in CI/CD pipelines.

## Installation

Use the upstream install or setup path that matches your environment:
- npm install pixelmatch

Requirements and caveats from upstream:
- [![Node](https://github.com/mapbox/pixelmatch/actions/workflows/node.yml/badge.svg)](https://github.com/mapbox/pixelmatch/actions/workflows/node.yml)
- so it's **blazing fast** and can be used in **any environment** (Node or browsers).
- ### Node.js

Basic usage or getting-started notes:
- ## Example output
- ## Example usage
- bash

- Source: https://github.com/mapbox/pixelmatch
- Extracted from upstream docs: https://raw.githubusercontent.com/mapbox/pixelmatch/HEAD/README.md

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/pixelmatch-image-comparison-library/)