liyue-aigc/female-portrait-director

A modular Codex Skill for directing and expanding detailed AI female portrait prompts.

ai-image-generationcodexcodex-skillopen-sourceprompt-engineering
Croissance des étoiles
Étoiles
1.5k
Forks
184
Croissance hebdomadaire
+54
Issues
0
1k
mai 26juin 26juil. 26sept. 26
README

English | 简体中文 | 日本語 | 한국어

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.

skills.sh GitHub stars License: MIT

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
Sunlit clean lifestyle portrait by a cafe window Urban fashion street portrait outside a shopping mall Red-and-gold gufeng xianxia portrait
Hong Kong street French effortless Pure-desire curves
Golden-hour Hong Kong street portrait French effortless portrait on a Paris balcony Pure-desire curve-focused lifestyle portrait

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

Gufeng xianxia prompt expansion example

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
Dépôts similaires
freestylefly/awesome-gpt-image-2

Prompt as Code | GPT-Image2 工业级提示词引擎与模板库,530+ 个案例逆向工程,20+ 套工业级模板,并提炼出Skills,持续更新中

JavaScriptnpmawesomeMIT Licenseagentsai-image-generation
gpt-image2.canghe.ai
28.8k2.8k
Anil-matcha/Open-Generative-AI

Unrestricted Open-source alternative to AI video platforms — Free AI image & video generation studio with 600+ models (Flux, Midjourney, Kling, Sora, Veo). No content filters. Self-hosted, MIT licensed.

JavaScriptnpmMIT Licenseai-image-generationai-video-generation
muapi.ai/open-generative-ai
28.1k5k
YouMind-OpenLab/awesome-nano-banana-pro-prompts

🍌 World's largest Nano Banana Pro prompt library — 10,000+ curated prompts with preview images, 16 languages. Google Gemini AI image generation. Free & open source.

TypeScriptnpmawesomeOthergemini-ainano-banana-pro
youmind.com/nano-banana-pro-prompts
13.4k1.4k
YouMind-OpenLab/awesome-gpt-image-2

🚀 World's largest GPT Image 2 prompt library, updated daily — 2000+ curated prompts with preview images, 16 languages. OpenAI's next-gen image model with pixel-perfect text rendering, cross-image consistency, and commercial-grade illustration. Free & open source.

TypeScriptnpmawesomeOtherai-image-generationai-prompts
youmind.com/gpt-image-2-prompts
9.8k880
jau123/MeiGen-AI-Design-MCP

Supports GPT Image 2, Seedance & ComfyUI, with a 1,400+ prompt library, carefully crafted hooks and a multi-task orchestration system

TypeScriptnpmMIT Licenseai-image-generationclaude
meigen.ai
1.7k224