Skip to content
Back to search

pmu-beautify

SkillWorks with Claude CodeGitHub

Face-aware skin retouch ("beauty" / "beautify" pass) for photos and videos of permanent-makeup (PMU) artists and their clients — smooths lines, blotches and under-eye texture while keeping pores, and never touches brows, eyes, lips or the PMU work itself. Optional before/after comparison, jaw slim, teeth whitening, and retouching only one chosen person in a group shot. Has a help page and a step-by-step wizard. Use whenever the user wants to beautify, retouch, smooth skin, soften wrinkles on a face in a photo or a video (reel, story, testimonial, talking head), in any language, even if they only drop a file and say "make her skin nicer", or asks "pmu-beautify help" / "how does pmu-beautify work". macOS and Windows.

Safety scan

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

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dibeja--pmu-beautify/badge.svg)](/listings/dibeja--pmu-beautify)

HTML

<a href="/listings/dibeja--pmu-beautify"><img src="/api/listings/dibeja--pmu-beautify/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

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

**Any agent — one command** (needs [Node.js](https://nodejs.org); asks which agents and whether to install for all your projects):

npx skills add dibeja/pmu-beautify

**Or by hand** — clone into your agent's skills folder (needs [git](https://git-scm.com)):

| Agent | macOS (Terminal) | Windows (PowerShell) | |---|---|---| | Claude Code | `git clone https://github.com/dibeja/pmu-beautify ~/.claude/skills/pmu-beautify` | `git clone https://github.com/dibeja/pmu-beautify $HOME\.claude\skills\pmu-beautify` | | Codex, Gemini CLI, Cursor | `git clone https://github.com/dibeja/pmu-beautify ~/.agents/skills/pmu-beautify` | `git clone https://github.com/dibeja/pmu-beautify $HOME\.agents\skills\pmu-beautify` |

**Or ask your agent:** *"Install the skill from https://github.com/dibeja/pmu-beautify"* (in Codex you can also use `$skill-installer`).

**Zip (no tools needed):** download `pmu-beautify.zip` from [Releases](https://github.com/dibeja/pmu-beautify/releases/latest) and unzip it into the skills folder above.

Then restart your agent.

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.

SKILL.md · Manifest · 108 lines
  1. ---
  2. name: pmu-beautify
  3. description: Face-aware skin retouch ("beauty" / "beautify" pass) for photos and videos of permanent-makeup (PMU) artists and their clients — smooths lines, blotches and under-eye texture while keeping pores, and never touches brows, eyes, lips or the PMU work itself. Optional before/after comparison, jaw slim, teeth whitening, and retouching only one chosen person in a group shot. Has a help page and a step-by-step wizard. Use whenever the user wants to beautify, retouch, smooth skin, soften wrinkles on a face in a photo or a video (reel, story, testimonial, talking head), in any language, even if they only drop a file and say "make her skin nicer", or asks "pmu-beautify help" / "how does pmu-beautify work". macOS and Windows.
  4. ---
  5. # pmu-beautify
  6. Skin retouch for photos and video, built for PMU (permanent makeup) studios: the skin gets cleaner, the tattooed work stays exactly as it is.
  7. Always talk to the user in their language. Keep option names (`--guard` etc.) out of what you say unless they ask: describe the effect instead.
  8. ## Help and wizard
  9. - **Help** — the user writes `pmu-beautify help` (or just `help` while using the skill), asks how it works or what they can ask: show [HELP.md](HELP.md) translated into their language, then offer the wizard.
  10. - **Wizard** — the user writes `pmu-beautify wizard` or asks to be guided step by step, or invokes the skill without a file or without saying who is in it: ask the questions below **one at a time**, waiting for each answer, skipping any the user already answered. Then say in one line what you will do and run it.
  11. If your agent has a multiple-choice question tool that **waits for the user's choice and returns it** (e.g. `AskUserQuestion` in Claude Code), use it for every question that has choices, with the recommended option first and a free-text answer allowed; it takes at most 4 options, so with more people than that ask in two steps. Do not use a tool that returns before the user has answered (e.g. Codex's `request_user_input_async`, which only says "accepted"): its panel closes when your turn ends. Without a waiting tool, ask in chat with numbered options and end your turn; the user replies with a number or a word. Question 1 is always asked in chat (a path cannot be picked from a list).
  12. 1. **File** — which photo or video? (path, or drag it into the chat)
  13. 2. **Who is in it** — the artist (the user) / a client wearing PMU / more than one person? If more than one: retouch one of them, or each of them? Then confirm who is who (e.g. "the artist is the one in the apron, 0–11 s?") and whether each wears PMU. The reference moments are found by you (see "More than one person"); ask for a separate photo of a person only when they are never alone in the shot. Questions 3 and 4 may then be answered per person.
  14. 3. **Strength** — subtle / natural (recommended) / strong → `--amount 0.4 / 0.6 / 0.8`
  15. 4. **Extras** — none (recommended) / slimmer jaw / whiter teeth / both
  16. 5. **Video only: which part** — whole video, or from second X for Y seconds?
  17. 6. **Comparison** — also make a before/after side-by-side? If yes, the two labels in their language: offer two ready pairs (e.g. "BEFORE / AFTER", "ORIGINAL / RETOUCHED", translated), free text for others.
  18. ## First run: install what is missing
  19. Before the first retouch, check for the `.ready` file in the pmu-beautify home: `~/.pmu-beautify/.ready` on macOS, `%USERPROFILE%\.pmu-beautify\.ready` on Windows (or `$PMU_BEAUTIFY_HOME/.ready` if that variable is set). If it is missing, run the setup for the user's system:
  20. ```bash
  21. bash <this skill's folder>/scripts/setup.sh # macOS
  22. powershell -ExecutionPolicy Bypass -File "<this skill's folder>\scripts\setup.ps1" # Windows
  23. ```
  24. It installs ffmpeg and Python 3.12 (Homebrew on macOS, winget on Windows), a private venv (mediapipe, opencv, numpy) and two face models (~42 MB, SHA-256 checked). It is safe to re-run. Exit codes:
  25. - **2** — the package manager is missing (Homebrew on macOS, winget on Windows): show the user what the script printed (Homebrew needs their Mac password, so they run it themselves), then run setup again.
  26. - **4** (Windows) — something was installed but is not on PATH yet: ask the user to open a new terminal / restart the agent, then run setup again.
  27. The Windows setup has not been tested on a real Windows machine yet: if a step fails, show the user the exact error and fix the step rather than guessing.
  28. Every command below uses:
  29. - macOS: `PY=~/.pmu-beautify/venv/bin/python`, `S=<this skill's folder>/scripts`
  30. - Windows: `PY=%USERPROFILE%\.pmu-beautify\venv\Scripts\python.exe`, `S=<this skill's folder>\scripts` (quote paths with spaces)
  31. ## The rule that is never broken
  32. **Never retouch the treated area of a client's result** (brows, lip blush, eyeliner, areola, scar camouflage). Retouching the work is misleading advertising. The mask already leaves brows, eyes and lips out; on anyone wearing PMU always add `--guard 0.06`, which widens those protected zones so eyeliner and lip-liner stay untouched. If the user asks to smooth the treated area itself, say no and explain why.
  33. ## Retouch
  34. Photo in → photo out, video in → `.mp4` out. Pick the output extension from the input: a photo (`.jpg .jpeg .png .heic .webp .tif`) gets `.jpg` (or `.png` if the input was PNG); a video gets `.mp4`. Never overwrite the original: write next to it as `<name>-beautify.<ext>`.
  35. **Never rotate, crop or resize the input yourself.** The output must have the same orientation and size as the original. The script finds faces that are sideways or upside down and faces cut off by the frame (only eyes and forehead visible, say), so give it the file exactly as it is. If it reports the face missed, tell the user; do not "fix" the image before retouching.
  36. ```bash
  37. $PY $S/retouch.py IN OUT --guard 0.06 # client with PMU: the default
  38. $PY $S/retouch.py IN OUT # the artist's own face, no PMU near the eyes/lips
  39. $PY $S/retouch.py IN.mp4 OUT.mp4 --ss 12 --t 8 # only a segment of a video
  40. ```
  41. | Option | What it does | Default / good value |
  42. |---|---|---|
  43. | `--amount` | how much line/blotch detail is removed (0..1) | 0.6 natural; 0.4 subtle; >0.8 looks plastic |
  44. | `--even` | evens out redness/shine patches | 0.1; above 0.2 the cheeks lose colour |
  45. | `--no-keep-edges` | also softens strong dark edges (nostril rims, nose contour) | off: those edges stay sharp, so a high `--amount` does not blur the nose |
  46. | `--guard` | widens protected brow/eye/lip zones (fraction of face width) | 0 own face; **0.06 with PMU** |
  47. | `--slim` | narrows jaw, lifts chin (nose never touched) | off; 0.02–0.03 max, it also warps hair/collar near the jaw |
  48. | `--teeth` | takes yellow out of teeth only | off; 0.5 natural |
  49. | `--ref SEC` | video: only the person alone in frame at SEC (seconds into the span) is retouched | — |
  50. | `--ref-image PHOTO` | photo or video: only the person shown alone in PHOTO is retouched | — |
  51. | `--debug-mask` | writes the mask (white = retouched) instead of the result | use to check |
  52. Use `--ref` / `--ref-image` whenever more than one face is in the shot (artist + client, two friends): without it, only the most prominent face is found and the others may get the mask. Check with `--debug-mask` when unsure. The script prints how many frames lost the face; if that is high, tell the user.
  53. ### More than one person
  54. One run retouches one face. To retouch several people, run **one pass per person, chained**: pass 1 reads the original and writes a temporary file; pass 2 reads that and writes the final output; and so on. Each pass has its own reference and its own settings: `--guard 0.06` only for a person wearing PMU, no guard for the artist's own face.
  55. ```bash
  56. $PY $S/retouch.py IN.mp4 TMP.mp4 --ref 0.5 # pass 1: the artist, alone at 0.5 s
  57. $PY $S/retouch.py TMP.mp4 OUT.mp4 --ref 40 --guard 0.06 # pass 2: the client with PMU, alone at 40 s
  58. ```
  59. 1. **Find the reference moments yourself.** Sample a frame every few seconds (ffmpeg), count the faces in each and look at a contact sheet to see who is where. Pick, for each person, a moment where they are alone, facing the camera, with no hand over the face. If a person is never alone, ask the user for a separate photo of them alone and use `--ref-image`.
  60. 2. **Confirm who is who** with the user before running ("the client is the one in the blue shirt, from 12 s?").
  61. 3. **Check each pass's last line.** The frames it retouched (total minus "face missed") should match roughly the time that person is on screen, and "other faces left alone" should match the time the others are. A big mismatch means a wrong reference: pick another moment.
  62. 4. Write temporary files in a scratch/temp folder and delete them at the end. Make the before/after comparison against the **original**, not against an intermediate file.
  63. Each pass re-encodes the video at high quality (CRF 15): two or three passes show no visible loss.
  64. Slim and teeth are only applied when the user asks for them.
  65. MediaPipe prints `W0000`/`I0000`/`INFO` lines on stderr at start: harmless, ignore them. The last stdout line (`N frames, face missed in M`) is the one that matters.
  66. Light and colour are not changed by this skill.
  67. ## Before/after comparison (optional)
  68. Only when the user asks for it (offer it once after the retouch, e.g. "want a side-by-side to approve?"):
  69. ```bash
  70. $PY $S/compare.py BEFORE AFTER OUT --labels "ORIGINAL,RETOUCHED"
  71. ```
  72. Photo pair → `.jpg`, video pair → `.mp4` (audio from BEFORE). Labels in the user's language, ASCII only (no accents): e.g. `"BEFORE,AFTER"` translated. If `--ss/--t` was used for the retouch, compare against the same segment of the original (cut it first with ffmpeg), not the full clip.
  73. ## Check before handing over
  74. Look at the result (for a video, extract a frame with ffmpeg) and check the eyes and lips: eyeliner, lip line and brows must be identical to the original. Then tell the user the output path and the settings used, in plain words.
README.md · README · 115 lines
  1. # pmu-beautify
  2. An [Agent Skill](https://agentskills.io) for **Claude Code, OpenAI Codex, Gemini CLI, Cursor** and other agents that read `SKILL.md` skills, on **macOS and Windows**. It retouches skin in **photos and videos** for permanent-makeup (PMU) studios: lines, blotches and under-eye texture go down, pores stay, and **brows, eyes, lips and the PMU work are never touched**.
  3. 🇮🇹 [Italiano più sotto](#italiano)
  4. ## Install
  5. **Any agent — one command** (needs [Node.js](https://nodejs.org); asks which agents and whether to install for all your projects):
  6. ```bash
  7. npx skills add dibeja/pmu-beautify
  8. ```
  9. **Or by hand** — clone into your agent's skills folder (needs [git](https://git-scm.com)):
  10. | Agent | macOS (Terminal) | Windows (PowerShell) |
  11. |---|---|---|
  12. | Claude Code | `git clone https://github.com/dibeja/pmu-beautify ~/.claude/skills/pmu-beautify` | `git clone https://github.com/dibeja/pmu-beautify $HOME\.claude\skills\pmu-beautify` |
  13. | Codex, Gemini CLI, Cursor | `git clone https://github.com/dibeja/pmu-beautify ~/.agents/skills/pmu-beautify` | `git clone https://github.com/dibeja/pmu-beautify $HOME\.agents\skills\pmu-beautify` |
  14. **Or ask your agent:** *"Install the skill from https://github.com/dibeja/pmu-beautify"* (in Codex you can also use `$skill-installer`).
  15. **Zip (no tools needed):** download `pmu-beautify.zip` from [Releases](https://github.com/dibeja/pmu-beautify/releases/latest) and unzip it into the skills folder above.
  16. Then restart your agent.
  17. ## First use
  18. Just ask: *"beautify this photo: ~/Desktop/client.jpg"*, or *"pmu-beautify help"*, or *"pmu-beautify wizard"* for a step-by-step wizard. On the first run the skill installs what it needs:
  19. | | macOS | Windows 10/11 |
  20. |---|---|---|
  21. | Package manager | [Homebrew](https://brew.sh) — if missing, the skill gives you the command to paste (it asks for your Mac password) | winget (built into Windows; if missing, install "App Installer" from the Microsoft Store) |
  22. | Installed | ffmpeg, Python 3.12 | ffmpeg, Python 3.12 |
  23. | Private environment | `~/.pmu-beautify/` | `%USERPROFILE%\.pmu-beautify\` |
  24. Plus Python packages (mediapipe, opencv, numpy) and two face models (~42 MB): [MediaPipe Face Landmarker](https://ai.google.dev/edge/mediapipe/solutions/vision/face_landmarker) and [OpenCV SFace](https://github.com/opencv/opencv_zoo/tree/main/models/face_recognition_sface).
  25. > **Windows is new and not yet tested on a real PC.** If setup stops, the agent shows you the error; please [open an issue](https://github.com/dibeja/pmu-beautify/issues) with it.
  26. To remove everything: delete the `pmu-beautify` folder from your agent's skills folder and the `.pmu-beautify` folder in your home.
  27. ## What you can ask
  28. See [HELP.md](HELP.md) — or write *pmu-beautify help* to the agent. In short:
  29. - retouch a photo or a video (or just a segment of it), subtle / natural / strong
  30. - PMU protected: eyeliner and lip line stay exactly as they are — the default on clients
  31. - retouch only one person in a group photo/video, or each of them with their own settings
  32. - slim jaw/chin a little, whiten teeth (only if you ask)
  33. - a side-by-side **before/after** image or video for approval (optional)
  34. - a **wizard** that asks you one question at a time
  35. **Rule:** the skill refuses to retouch the treated area of a result (brows, lips, eyeliner, areola). Retouching the work is misleading advertising.
  36. ---
  37. ## Italiano
  38. [Agent Skill](https://agentskills.io) per **Claude Code, OpenAI Codex, Gemini CLI, Cursor** e gli altri agenti che leggono le skill `SKILL.md`, su **macOS e Windows**. Ritocca la pelle in **foto e video** per studi di trucco permanente (PMU): rughe, macchie e occhiaie si attenuano, i pori restano, e **sopracciglia, occhi, labbra e il lavoro PMU non vengono mai toccati**.
  39. ### Installazione
  40. **Qualsiasi agente — un comando** (serve [Node.js](https://nodejs.org); chiede per quali agenti e se installarla per tutti i progetti):
  41. ```bash
  42. npx skills add dibeja/pmu-beautify
  43. ```
  44. **Oppure a mano** — clona nella cartella skill del tuo agente (serve [git](https://git-scm.com)):
  45. | Agente | macOS (Terminale) | Windows (PowerShell) |
  46. |---|---|---|
  47. | Claude Code | `git clone https://github.com/dibeja/pmu-beautify ~/.claude/skills/pmu-beautify` | `git clone https://github.com/dibeja/pmu-beautify $HOME\.claude\skills\pmu-beautify` |
  48. | Codex, Gemini CLI, Cursor | `git clone https://github.com/dibeja/pmu-beautify ~/.agents/skills/pmu-beautify` | `git clone https://github.com/dibeja/pmu-beautify $HOME\.agents\skills\pmu-beautify` |
  49. **Oppure chiedilo al tuo agente:** *"Installa la skill da https://github.com/dibeja/pmu-beautify"* (in Codex puoi usare anche `$skill-installer`).
  50. **Zip (senza strumenti):** scarica `pmu-beautify.zip` dalle [Releases](https://github.com/dibeja/pmu-beautify/releases/latest) e scompattalo nella cartella skill indicata sopra.
  51. Poi riavvia l'agente.
  52. ### Primo utilizzo
  53. Chiedi e basta: *"ritocca la pelle in questa foto: ~/Desktop/cliente.jpg"*, oppure *"pmu-beautify help"*, oppure *"pmu-beautify wizard"* per un wizard passo passo. Alla prima esecuzione la skill installa ciò che serve:
  54. | | macOS | Windows 10/11 |
  55. |---|---|---|
  56. | Gestore pacchetti | [Homebrew](https://brew.sh) — se manca, la skill ti dà il comando da incollare (chiede la password del Mac) | winget (già in Windows; se manca, installa "App Installer" dal Microsoft Store) |
  57. | Installati | ffmpeg, Python 3.12 | ffmpeg, Python 3.12 |
  58. | Ambiente dedicato | `~/.pmu-beautify/` | `%USERPROFILE%\.pmu-beautify\` |
  59. Più i pacchetti Python (mediapipe, opencv, numpy) e due modelli per il volto (~42 MB): [MediaPipe Face Landmarker](https://ai.google.dev/edge/mediapipe/solutions/vision/face_landmarker) e [OpenCV SFace](https://github.com/opencv/opencv_zoo/tree/main/models/face_recognition_sface).
  60. > **Il supporto Windows è nuovo e non ancora provato su un PC reale.** Se l'installazione si ferma, l'agente ti mostra l'errore: [aprici una issue](https://github.com/dibeja/pmu-beautify/issues) con quel testo.
  61. Per rimuovere tutto: cancella la cartella `pmu-beautify` dalla cartella skill del tuo agente e la cartella `.pmu-beautify` nella tua home.
  62. ### Cosa puoi chiedere
  63. Vedi [HELP.md](HELP.md), oppure scrivi *pmu-beautify help* all'agente. In breve:
  64. - ritoccare una foto o un video (anche solo un pezzo), leggero / naturale / deciso
  65. - PMU protetto: eyeliner e contorno labbra restano identici — di default sulle clienti
  66. - ritoccare una sola persona in una foto/video di gruppo, oppure ciascuna con le sue impostazioni
  67. - snellire leggermente mascella/mento, sbiancare i denti (solo se lo chiedi)
  68. - un confronto **prima/dopo** affiancato, foto o video, per l'approvazione (opzionale)
  69. - un **wizard** che ti fa una domanda alla volta
  70. **Regola:** la skill si rifiuta di ritoccare la zona trattata di un risultato (sopracciglia, labbra, eyeliner, areola). Ritoccare il lavoro è pubblicità ingannevole.
  71. ## License
  72. MIT — see [LICENSE](LICENSE). The face models are downloaded from their original sources under their own licenses.

Ratings and comments

Sign in to rate this skill.

Sign in

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