liyue-aigc/female-portrait-director
A modular Codex Skill for directing and expanding detailed AI female portrait prompts.
Female Portrait Prompt Director Skill
Turn a few portrait inputs into a coherent, camera-ready scene—or directly generate an image while preserving an authorized person or product reference.
This is not a generic prompt collection. It locks explicit requirements, chooses one visual route, and directs the subject, action, clothing, scene, camera, lighting, and finish as one photographable moment. Subjects are fictional, clearly adult women unless an authorized adult reference is provided.
See the difference
| Clean lifestyle | Urban fashion | Gufeng xianxia |
|---|---|---|
![]() |
![]() |
![]() |
| Hong Kong street | French effortless | Pure-desire curves |
![]() |
![]() |
![]() |
The six cases cover clean lifestyle, urban fashion, gufeng xianxia, Hong Kong street photography, French effortless portraiture, and curve-focused lifestyle direction.
Try it in 60 seconds
Install with the open-source skills CLI:
npx skills add https://github.com/liyue-aigc/female-portrait-director/tree/main/skills/female-portrait-director -g
Start a new agent session, then paste:
Use $female-portrait-director to generate an image directly:
Style: clean lifestyle portrait
Scene: quiet cafe window seat in the afternoon
Outfit: ivory knitted cardigan + light inner top
Mood: gentle, natural, clearly adult
Aspect ratio: 3:4
For a copy-ready prompt instead of an image, remove “generate an image directly.” The Skill returns locked parameters, a directed prompt, and negative constraints.
Agent compatibility
The complete 62-file distribution package has been installer-verified with the current skills CLI for the following targets:
| Agent | Install package | Prompt workflow | Direct image workflow |
|---|---|---|---|
| Codex | Verified | Runtime-verified | Supported when image generation is available |
| Claude Code | Verified | Agent Skills compatible | Depends on the connected image tool |
| Cursor | Verified | Agent Skills compatible | Depends on the connected image tool |
| GitHub Copilot | Verified | Agent Skills compatible | Depends on the connected image tool |
| Gemini CLI | Verified | Agent Skills compatible | Depends on the connected image tool |
“Installer-verified” means the CLI copied SKILL.md and every referenced route, tool, safety file, and example into the target skill package. Only Codex was runtime-executed in this release environment; the other rows are packaging and specification compatibility claims, not claims that every host provides an image model.
Supported Styles
- Clean lifestyle portraits
- Restrained curve-focused lifestyle portraits
- Urban fashion photography
- Gufeng fantasy portraits
- E-commerce clothing model images
- Retro Hong Kong portraits
- French relaxed portraits
- New Chinese oriental portraits
- Sporty active portraits
- Travel vacation portraits
- Studio-retouched portraits
- Oriental voluptuous portraits
- Cold xianxia enhanced portraits
- Bright luxury gufeng portraits
- Ultra-close realistic face portraits
- Ancient noblewoman dewy-makeup portraits
- Black-pearl dark-gold CCD curve portraits
- Energetic voluptuous soft-CCD lifestyle portraits
- Cold-white clear CCD curve portraits
- Low-key cinematic photography
See the first-use guide for the 20-style menu, input templates, route-plus-overlay combination rules, and a complete parameter-to-five-paragraph-prompt example.
Core Capabilities
- Lock user-specified parameters and only refine or stabilize them.
- Route each request through one on-demand style file and avoid conflicting style keywords.
- Parse face, body, outfit, scene, camera and pose, lighting, and filter modules.
- Expand short parameters into a coherent photographed moment instead of mechanically repeating them.
- Fuse the expanded modules into natural, detailed, copy-ready prompts with photography-director intent.
- Preserve clothing-display priority for e-commerce images and explicit safety boundaries for curve-focused portraits.
- Preserve authorized selfie identity or product core visuals for direct reference-image generation.
Installation details
Requires Node.js for the one-command installer. Update an installed copy with:
npx skills@latest update female-portrait-director -g -y
Manual Codex install with Git
Alternatively, clone the repository into your Codex skills directory.
Windows PowerShell:
git clone https://github.com/liyue-aigc/female-portrait-director.git "$env:USERPROFILE\.codex\skills\female-portrait-director"
macOS or Linux:
git clone https://github.com/liyue-aigc/female-portrait-director.git "${CODEX_HOME:-$HOME/.codex}/skills/female-portrait-director"
Restart Codex or start a new conversation, then invoke:
$female-portrait-director
The first parameter-free invocation displays the V1.6 tutorial: all 20 implemented styles, basic and advanced templates, style-plus-mood combination guidance, a detailed prompt example, and direct-image or authorized-reference workflows.
Example: Parameters to Directed Prompt
The Skill does more than restate the input. It preserves requested parameters, fills in missing visual details, and produces locked parameters, module analysis, a final prompt, and negative constraints.
Portrait style: Gufeng xianxia beauty portrait
Scene: Traditional courtyard corridor surrounded by misty mountains and water
Outfit: Moon-white Tang-inspired fantasy wide-sleeve robe + flowing pibo scarf + silver embroidered waist sash
Mood: Cool, distant, ethereal
Facial direction: Classical East Asian beauty
Body direction: Slender and delicate figure
Camera direction: Slight side-facing standing pose, half-body to thigh framing
Lighting: Cool soft light
Filter: Cool ethereal gufeng filter
Aspect ratio: 9:16
Platform use: Character portrait

Output Format
1. Locked parameters
2. Module analysis
3. Final prompt
4. Negative constraints
Repository Structure
.
├── README.md
├── README_zh.md
├── README_ja.md
├── README_ko.md
├── SKILL.md
├── agents/openai.yaml
├── assets/examples/
├── skill/
│ ├── skill.md
│ ├── style-registry.md
│ ├── help.md
│ ├── public_instructions.md
│ ├── parameter_schema.md
│ ├── usage_examples.md
│ ├── core/
│ ├── references/
│ │ ├── director-expansion.md
│ │ └── visual-libraries.md
│ └── routes/
│ ├── beauty/
│ ├── commercial/
│ ├── curve/
│ ├── fantasy/
│ ├── fashion/
│ ├── lifestyle/
│ ├── oriental/
│ └── realism/
├── docs/
│ ├── style_guide.md
│ ├── prompt_safety.md
│ ├── versioning.md
│ └── faq.md
└── examples/
Safety Boundaries
Text-only generation defaults to fictional, clearly adult subjects. Reference-image workflows may preserve the identity of the user or an authorized adult subject, and may preserve product visuals that the user has the right to use. The project must not be used for sexualized minors, explicit nudity, non-consensual images, deceptive identity content, harassment, defamation, privacy violations, or other unlawful purposes. See prompt_safety.md and DISCLAIMER.md for details.
License
This project is licensed under the MIT License. The MIT License permits use, copying, modification, merging, publishing, distribution, sublicensing, and selling copies. The safety boundaries are responsible-use guidelines and do not alter the standard MIT License terms.
Author and Version
- Author: Li Yue (李岳)
- Version:
FEMALE-PORTRAIT-DIRECTOR-V1.6 - Project:
Female Portrait Prompt Director Skill





