virtual-hair-test-fit

---

name: virtual-hair-test-fit description: This prompt instructs an AI image editor to take a user-provided portrait and seamlessly replace only the subject’s hair with a user-specified hairstyle, producing a high-fidelity, photorealistic result. It emphasizes preserving the person’s identity and all non-hair elements (face, skin, expression, background, clothing, lighting setup) while integrating the new hair with accurate hairline placement, natural texture, and consistent lighting and shadows. The intended outcome is an image that looks like an untouched real photograph of the same person, differing only in hairstyle and avoiding artifacts, stylization, or unintended enhancements. compatibility: Requires betterprompt >= 0.1.3 metadata: openclaw: homepage: https://github.com/BetterPromptme/skills emoji: 🧩 requires: anyBins: - betterprompt - bp os: - linux - darwin install: - id: node kind: node package: betterprompt bins: [betterprompt, bp] label: Install BetterPrompt CLI (node)

What it does

This prompt instructs an AI image editor to take a user-provided portrait and seamlessly replace only the subject’s hair with a user-specified hairstyle, producing a high-fidelity, photorealistic result. It emphasizes preserving the person’s identity and all non-hair elements (face, skin, expression, background, clothing, lighting setup) while integrating the new hair with accurate hairline placement, natural texture, and consistent lighting and shadows. The intended outcome is an image that looks like an untouched real photograph of the same person, differing only in hairstyle and avoiding artifacts, stylization, or unintended enhancements.

For more installation instructions go to https://raw.githubusercontent.com/BetterPromptme/skills/refs/heads/main/betterprompt/SKILL.md to check out this skill.

Inputs

textInputs

Pass each text input using --input <key>=<value> flags.

Variable key	Required?	Description	Defaults
Hairstyle_request	Required	Describe the hairstyle you want to try on	(none)

imageInputs

This prompt requires exactly 1 image. You must pass exactly 1 image flag (no more, no fewer), in the order matching the descriptions below.

Index	Required	Description	Allowed CLI flags
1	Yes	Upload your portrait photo	--image-input-url <url> or --image-input-path <path>

Models and options

This skill's modality is: image.

To discover which model values you can use (and which options keys/values are valid for each model), run:

betterprompt resources --models-only --json

Then filter the returned JSON array to entries where modality is "image".

How to run

Step 1: Collect inputs

First, run betterprompt resources --models-only --json and filter to modality: "image" to discover valid models and available options:

betterprompt resources --models-only --json

Use only the models and option values that appear in the filtered results.

Then collect all inputs from the human:

• Required text inputs:
  • Hairstyle_request
• Required images:
  • Exactly 1 images: image 1 (Upload your portrait photo). Images must be provided in this order.
• Optional: model and options.
  • Present the human with the default model gemini-2.5-flash-image-preview and its available options. Look up gemini-2.5-flash-image-preview in the betterprompt resources output (filtered to modality "image") and show its availableOptions as: key: val1, val2 (default), val3 | key2: .... Mark a value (default) if it matches these defaults: {"aspectRatio":"3:4"}.
  • If the human does not specify, defaults are used: model gemini-2.5-flash-image-preview, options {"aspectRatio":"3:4"}. Other models from the resources call are also available.

If any required text input or the required images are missing, ask the human for what's missing. Do not assume or fabricate values. Tell the human: "Please provide images in this order: image 1 (Upload your portrait photo)".

Step 2: Run via BetterPrompt CLI

Use the frontmatter's name as the positional argument (for this skill, use virtual-hair-test-fit).

Command form:

betterprompt generate virtual-hair-test-fit \
  [--input <key>=<value>] \
  [--image-input-url <url>] \
  [--image-input-path <path>] \
  [--model <model>] \
  [--options <options JSON>] \
  [--json]

Notes:

• Pass each text input as a separate --input <key>=<value> flag.
• Pass each image using --image-input-url or --image-input-path, in the order matching the imageInputs descriptions (image 1 first, then image 2, etc.).
• If the human does not mention a model, omit --model and BetterPrompt will use the default model: gemini-2.5-flash-image-preview.
• If the human does not mention options, omit --options and BetterPrompt will use the default options: {"aspectRatio":"3:4"}.
• If the run times out, the response will include a runId you can use to fetch the result later.

Example (using defaults shown above):

betterprompt generate virtual-hair-test-fit \
  --input Hairstyle_request=<value> \
  --image-input-url https://example.com/image1.png \
  --model gemini-2.5-flash-image-preview \
  --options '{"aspectRatio":"3:4"}'