aia4-headshot-framing

Validate and reframe team headshots to a canonical framing standard using OpenCV.

Updated Apr 29, 2026
One-click install
npx skills add https://github.com/Clvrwrk/PEW-V1 --skill aia4-headshot-framing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aia4-headshot-framing
Source: https://github.com/Clvrwrk/PEW-V1/tree/main/_aia4-skills/aia4-headshot-framing
Command: npx skills add https://github.com/Clvrwrk/PEW-V1 --skill aia4-headshot-framing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires opencv-python, Pillow, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that team headshots for Pro Exteriors adhere to a consistent framing standard, improving visual consistency and brand identity.

Core Features & Use Cases

  • Headshot Validation: Detects and conforms team headshots to the defined framing standard.
  • Canvas Extension: Extends the canvas when required to maintain the standard.
  • Reframing: Correctly crops and resizes images to the canonical frame.
  • Use Case: When a new team member's headshot is added or an existing one needs to be reframed for consistency.

Quick Start

Run the command 'python3 frame_headshot.py check "public/images/team/"*.webp' to validate headshots, then use 'python3 frame_headshot.py reframe <src_image> "public/images/team/<Name - Title>.webp"' to reframe a single image.

Frequently Asked Questions about aia4-headshot-framing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I standardize team headshot framing for consistent website photos?

Standardize team headshot framing by using automated face detection and predefined framing metrics to validate, crop, and resize images to a canonical standard for visual consistency.

How do I reframe a headshot that doesn't match existing team photo dimensions?

Reframe a headshot by running a Python script that detects the face using OpenCV, applies predefined framing metrics, and extends the canvas when necessary using the image connector.

Can OpenCV and Pillow automatically crop and resize faces for headshot standardization?

Yes, OpenCV and Pillow can automatically crop and resize faces for headshot standardization by detecting facial features and applying predefined canonical framing metrics to the image.

What's the best way to validate multiple headshots at once for framing consistency?

Validate multiple headshots at once by running a Python check command against a directory of webp images, which detects faces and flags photos that do not meet the framing standard.

Does headshot reframing work with webp image files?

Yes, headshot reframing works with webp image files, allowing you to validate and reframe team photos directly within your public images directory to maintain a consistent website appearance.

When should I extend the canvas during image reframing?

Extend the canvas during image reframing when the original image dimensions are insufficient to maintain the canonical headshot standard, ensuring the face remains correctly positioned within the frame.