New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Id Photo Tool

by aipoch in aipoch/medical-research-skills

Replace an ID photo background color (blue/white/red) and/or add a configurable text watermark when you need compliant ID-photo variants from local JPG/PNG files.

MITAuto-check passed

Install Id Photo Tool

skills CLI
$ npx skills add aipoch/medical-research-skills --skill id-photo-tool -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aipoch/medical-research-skills id-photo-tool --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aipoch/medical-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/scientific-skills/Other/id-photo-tool .claude/skills/id-photo-tool && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
id-photo-tool
GitHub stars
1.9k
Token cost
~820 tokens
SKILL.md length
332 words
Files
3 (incl. scripts)
Skills in repo
578
Repo updated
First seen
Licence
MIT

At a glance

Replace an ID photo background color (blue/white/red) and/or add a configurable text watermark when you need compliant ID-photo variants from local JPG/PNG files.

  • SKILL.md covers When to Use, Key Features, Dependencies and Example Usage, plus 1 more section
  • Runs Python scripts from its folder; calls python

What it does

Id Photo Tool is an agent skill from aipoch/medical-research-skills. Replace an ID photo background color (blue/white/red) and/or add a configurable text watermark when you need compliant ID-photo variants from local JPG/PNG files.

Its SKILL.md is about 820 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `id-photo-tool_audit_result_v1.json` and `scripts/id_photo_tool.py`).

The repository describes itself as: Hundreds of agent skills for medical research, including protocol design, data analysis, evidence insights, and academic writing. The licence is MIT.

Example prompts

  • “/id-photo-tool”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 686e09d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Id Photo Tool loads about 820 tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 332 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~820

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from aipoch/medical-research-skills at commit 686e09d, republished under its MIT licence (© aipoch). 332 words, ~820 tokens.

Download SKILL.mdSave it as .claude/skills/id-photo-tool/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
id-photo-tool
description
Replace an ID photo background color (blue/white/red) and/or add a configurable text watermark when you need compliant ID-photo variants from local JPG/PNG files.
license
MIT
author
AIPOCH

Source: https://github.com/aipoch/medical-research-skills

When to Use

  • You need to convert an ID photo background to a required solid color (blue/white/red) for official submissions.
  • You need to add a visible “for application only” style watermark to prevent misuse of shared ID photos.
  • You need to batch-generate multiple variants while keeping the original image unchanged (explicit output path).
  • You need an offline, local-only tool (no network access) for processing sensitive personal images.

Key Features

  • Background color replacement for ID photos:
    • Supported target colors: blue, white, red
    • Detects the dominant background color using edge pixels and replaces it using color-distance matching
  • Text watermark overlay:
    • Supported positions: top-left, top-right, bottom-left, bottom-right, center
    • Configurable opacity, font size, and font color
  • Input/output constraints:
    • Supports JPG and PNG only
    • Output keeps the same format as the input
    • Does not overwrite the original file (output path must be provided)
  • Local processing only:
    • Reads only from user-provided input paths and writes only to user-provided output paths

Dependencies

  • Python 3.x
  • pillow (PIL) — version not pinned
  • numpy — version not pinned

Install:

bash
python -m pip install pillow numpy

Example Usage

Background color replacement (JPG):

bash
python scripts/id_photo_tool.py change-bg \
  --input input.jpg \
  --output output.jpg \
  --color blue

Background color replacement (PNG):

bash
python scripts/id_photo_tool.py change-bg \
  --input input.png \
  --output output.png \
  --color white

Add a text watermark:

bash
python scripts/id_photo_tool.py add-watermark \
  --input input.jpg \
  --output watermarked.jpg \
  --text "For application use only"

Implementation Details

Background Color Replacement
  • Background sampling: The tool estimates the original background color by sampling pixels along the image edges (where background is most likely present).
  • Color-distance based replacement: Pixels close to the estimated background color (by color distance) are treated as background and replaced with the selected target color.
  • Supported target colors:
    • blue
    • white
    • red
Text Watermark
  • Placement: One of five positions is supported: top-left, top-right, bottom-left, bottom-right, center.
  • Rendering parameters:
    • Opacity controls watermark transparency.
    • Font size controls text scale.
    • Font color controls text color.
  • Output behavior: The watermark is composited onto the image and saved to the specified output path without modifying the original input file.
Security / Compliance Notes
  • No network access is used; all processing is performed locally.
  • The script only accesses file paths explicitly provided via CLI arguments.
  • The tool requires an explicit output path and does not overwrite the original file by default.

© aipoch, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in scientific-skills/Other/id-photo-tool of aipoch/medical-research-skills.

  • SKILL.md
  • id-photo-tool_audit_result_v1.json
  • scripts/id_photo_tool.py

Open the folder on GitHubat commit 686e09d

Compare with similar skills

Id Photo Tool next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Id Photo Tool compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Id Photo Tool this skillaipoch/medical-research-skills1.9k—~820Automated safety check: PassMIT
Rational Red Blue Debatedigoal/blog8.6k—~2.2kAutomated safety check: PassGPL-2.0
Photoscodewhale-hq/Codewhale41k—~386Automated safety check: PassMIT
Red Blue Debatedigoal/blog8.6k—~871Automated safety check: PassGPL-2.0
Color Expertnexu-io/open-design100k—~331Automated safety check: PassApache-2.0
Colorizevibe-motion/skills1.3k—~1.5kAutomated safety check: PassNone

Similar skills

  • Rational Red Blue Debate

    digoal/blog

    Answer general or cross-domain questions with a non-pleasing rational mode: adversarial red-team and blue-team expert analysis, mutually exclusive conclusions, up to five debate rounds, saved…

    8.6k GitHub stars~2.2k tokensUpdated 2 days ago
    SecurityAuto-check passed

  • Photos

    codewhale-hq/Codewhale

    Search a local macOS Photos library and export selected copies when the user asks to find or use their own photos.

    41k GitHub stars~386 tokensUpdated today
    Auto-check passed

  • Red Blue Debate

    digoal/blog

    用红蓝双队辩论模式深度解答通用问题，以非讨好型人格的理性人视角输出最终报告. An agent skill from digoal/blog.

    8.6k GitHub stars~871 tokensUpdated 2 days ago
    Auto-check passed

  • Color Expert

    nexu-io/open-design

    Color science expert skill with 286K words of reference material covering OKLCH/OKLAB, palette generation, accessibility/contrast, color naming, pigment mixing, and historical color theory.

    100k GitHub stars~331 tokensUpdated yesterday
    Frontend & DesignAuto-check passed

  • Colorize

    vibe-motion/skills

    Turn photos, videos, and Live Photos into a black-and-white to color reveal clip (单彩渐变 + 动感模糊 + 丁达尔旋焦).

    1.3k GitHub stars~1.5k tokensUpdated 5 days ago
    Media & CreativeAuto-check passed

  • Python Background Jobs

    wshobson/agents

    Python background job patterns including task queues, workers, and event-driven architecture.

    40k GitHub stars~1.8k tokensUpdated 6 days ago
    Backend & APIsAuto-check passed

More from aipoch/medical-research-skills

All 578 skills in this repo

  • Academic Poster Generator

    aipoch/medical-research-skills

    Complete workflow for generating academic research posters from PDF literature; use when you need to extract paper content from PDFs and produce a LaTeX-based poster…

    1.9k GitHub stars~2.2k tokensUpdated 24 days ago
    Auto-check passed

  • Diagnostic Study Quality Assessment Quadas

    aipoch/medical-research-skills

    Analyzes clinical diagnostic accuracy studies for bias using the QUADAS-2 tool.

    1.9k GitHub stars~1.4k tokensUpdated 24 days ago
    Auto-check passed

  • Exploratory Data Analysis

    aipoch/medical-research-skills

    Perform comprehensive exploratory data analysis on scientific data files across 200+ file formats.

    1.9k GitHub stars~3.7k tokensUpdated 24 days ago
    Auto-check passed

  • Iso Certification

    aipoch/medical-research-skills

    A toolkit for preparing ISO 13485:2016 certification documentation for medical device QMS.

    1.9k GitHub stars~1.8k tokensUpdated 24 days ago
    Auto-check passed

  • Journal Skills

    aipoch/medical-research-skills

    Recommends target journals for manuscript submission by analyzing the paper topic/abstract and the journal distribution of similar PubMed literature; use when users ask for journal…

    1.9k GitHub stars~1.7k tokensUpdated 24 days ago
    Auto-check passed

  • Latex Posters

    aipoch/medical-research-skills

    Creates academic-poster writing packages for LaTeX using beamerposter, tikzposter, or baposter.

    1.9k GitHub stars~1.3k tokensUpdated 24 days ago
    Auto-check passed

Questions about Id Photo Tool

What does Id Photo Tool do?

Replace an ID photo background color (blue/white/red) and/or add a configurable text watermark when you need compliant ID-photo variants from local JPG/PNG files. Id Photo Tool is an agent skill from aipoch/medical-research-skills. Replace an ID photo background color (blue/white/red) and/or add a configurable text watermark when you need compliant ID-photo variants from local JPG/PNG files.

How do I install Id Photo Tool in Claude Code?

Run `npx skills add aipoch/medical-research-skills --skill id-photo-tool -a claude-code`. Or copy the skill folder (scientific-skills/Other/id-photo-tool in aipoch/medical-research-skills) into .claude/skills/id-photo-tool in your project. Claude Code loads it when a task matches its description.

How do I install Id Photo Tool in Codex?

Run `npx skills add aipoch/medical-research-skills --skill id-photo-tool -a codex`. Or copy the skill folder (scientific-skills/Other/id-photo-tool in aipoch/medical-research-skills) into .agents/skills/id-photo-tool in your project. Codex loads it when a task matches its description.

Can I use Id Photo Tool in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aipoch/medical-research-skills --skill id-photo-tool -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/id-photo-tool, .gemini/skills/id-photo-tool, .github/skills/id-photo-tool and .opencode/skills/id-photo-tool in your project.

What does Id Photo Tool need to run?

Going by SKILL.md and its folder, Id Photo Tool needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Id Photo Tool access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Id Photo Tool safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Id Photo Tool use?

Id Photo Tool is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Id Photo Tool use?

About 820 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Id Photo Tool?

Skills that share tags, products or a category with Id Photo Tool: Rational Red Blue Debate (digoal/blog, 8.6k stars), Photos (codewhale-hq/Codewhale, 41k stars), Red Blue Debate (digoal/blog, 8.6k stars) and Color Expert (nexu-io/open-design, 100k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Id Photo Tool?

aipoch (a GitHub organization) maintains it in aipoch/medical-research-skills, which has 1,937 GitHub stars. The repository holds 578 skills in this directory. The repository was last updated on September 17, 2026.

Source: aipoch/medical-research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.