Skip to content

Headshot Generator

Creates professional AI headshots of you from approved reference photos, staged for your review

Stars
19,682
Licence
MIT
Files
6 files

What it does

Once installed, the agent can produce professional headshot images of you (the principal) by using the Gemini image model via Google's API, anchored to reference photos you approve in a local config file so the face stays recognizable. It sizes outputs for uses like LinkedIn or profile pictures and saves them to your personal data folder, not the skill folder. The skill also routes results through a quality review step before you see them, and says nothing ships publicly until you pick one.

Great for

  • Professionals who need a current LinkedIn, company bio or profile photo without a new photoshoot
  • Creators who want several headshot variants in different lighting or attire to choose from
  • Developers or power users already running the LifeOS framework who want a repeatable headshot workflow

Skip it if

  • Headshots of other people: the skill's own rules require their consent, and generating from someone else's photo without it raises likeness and privacy problems
  • General illustrations, diagrams or non-headshot portraits, which the skill itself says belong to a different skill (Art)
  • Video avatars or thumbnails that must match real footage, since the skill warns that likeness should be checked against actual frames and may need another workflow

Try asking

  • “Generate a headshot for my LinkedIn profile”
  • “Make me a new profile picture for the site, 2-4 variants please”
  • “I need a headshot with professional lighting, 3:4 ratio”
  • “Update my profile pic with a casual headshot”
Step-by-step guide: how to use Headshot GeneratorInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 6 original files, the MIT licence and an attribution note.

    Headshot.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip Headshot.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip Headshot.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Run the check command first and follow Setup.md if it fails; this confirms your config, photo paths and API key are in place
  • Use only reference photos of yourself, and keep the approved pool to clear, recent images so the output matches your real face
  • Expect to iterate: if the base image has the wrong mood, add a reference photo with the energy you want rather than repeating expression prompts

What's inside

  • Intents/CreateHeadshot.md
  • References/ReferenceLibrary.md
  • Setup.md
  • SKILL.md
  • Tools/headshot.help.md
  • Tools/Headshot.ts

Redistributed unmodified from danielmiessler/LifeOS under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.