female-portrait-director - GitLite

KO | EN

gitlite — search

#hacktoberfest #llm #golang #go #rust #linux #windows #cli #kubernetes #security #ios #mcp #openai #open-source

female-portrait-director

(★ 1,383)

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

파일 탐색기

최종 버전 다운로드 (.zip)

- openai.yaml
- - 01-clean-lifestyle.png
  - 02-urban-fashion.png
  - 03-gufeng-xianxia.png
  - 04-ecommerce-model.png
  - 04-retro-hongkong-street.png
  - 05-french-lazy.png
  - 05-retro-hongkong.png
  - 06-new-chinese.png
  - 06-pure-desire-curve.png
- - gufeng-director-output.jpg
- faq.md
- prompt_safety.md
- style_guide.md
- versioning.md
- 女性人像提示词导演-6个视觉案例发布包.md
- clean_lifestyle_examples.md
- ecommerce_tryon_examples.md
- gufeng_fantasy_examples.md
- pure_desire_curve_examples.md
- urban_fashion_examples.md
- - conflict-resolution.md
  - director-gate.md
  - fallback-rules.md
  - output-format.md
  - parameter-lock.md
  - reference-image-lock.md
  - safety-boundary.md
- - bright-heroine.md
  - cold-heroine.md
  - cool-mature.md
  - gentle-sister.md
  - intellectual.md
  - mature-urban.md
  - sweet-cool.md
- - director-expansion.md
  - visual-libraries.md
- - failure-diagnosis.md
  - image-to-prompt.md
  - parameter-recommend.md
  - prompt-optimize.md
  - reference-image-generate.md
  - safety-rewrite.md
- help.md
- overlay-registry.md
- parameter_schema.md
- public_instructions.md
- skill.md
- style-registry.md
- tool-registry.md
- usage_examples.md
- - SKILL.md
.gitignore
CHANGELOG.md
CONTRIBUTING.md
DISCLAIMER.md
LICENSE
NOTICE.md
README.md
README_ja.md
README_ko.md
README_zh.md
SECURITY.md
SKILL.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[English](README.md) | [简体中文](README_zh.md) | [日本語](README_ja.md) | [한국어](README_ko.md)

# 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](https://skills.sh/b/liyue-aigc/female-portrait-director)](https://skills.sh/liyue-aigc/female-portrait-director)
[![GitHub stars](https://img.shields.io/github/stars/liyue-aigc/female-portrait-director?style=flat)](https://github.com/liyue-aigc/female-portrait-director/stargazers)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://raw.githubusercontent.com/liyue-aigc/female-portrait-director/main/LICENSE)

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](https://raw.githubusercontent.com/liyue-aigc/female-portrait-director/main/assets/cases/01-clean-lifestyle.png) | ![Urban fashion street portrait outside a shopping mall](https://raw.githubusercontent.com/liyue-aigc/female-portrait-director/main/assets/cases/02-urban-fashion.png) | ![Red-and-gold gufeng xianxia portrait](https://raw.githubusercontent.com/liyue-aigc/female-portrait-director/main/assets/cases/03-gufeng-xianxia.png) |
| Hong Kong street | French effortless | Pure-desire curves |
| ![Golden-hour Hong Kong street portrait](https://raw.githubusercontent.com/liyue-aigc/female-portrait-director/main/assets/cases/04-retro-hongkong-street.png) | ![French effortless portrait on a Paris balcony](https://raw.githubusercontent.com/liyue-aigc/female-portrait-director/main/assets/cases/05-french-lazy.png) | ![Pure-desire curve-focused lifestyle portrait](https://raw.githubusercontent.com/liyue-aigc/female-portrait-director/main/assets/cases/06-pure-desire-curve.png) |

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:

```bash
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:

```text
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](skill/help.md) 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](https://nodejs.org/) for the one-command installer. Update an installed copy with:

```bash
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:

```powershell
git clone https://github.com/liyue-aigc/female-portrait-director.git "$env:USERPROFILE\.codex\skills\female-portrait-director"
```

macOS or Linux:

```bash
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:

```text
$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.

```text
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](https://raw.githubusercontent.com/liyue-aigc/female-portrait-director/main/assets/examples/gufeng-director-output.jpg)

## Output Format

```text
1. Locked parameters
2. Module analysis
3. Final prompt
4. Negative constraints
```

## Repository Structure

```text
.
├── 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](docs/prompt_safety.md) and [DISCLAIMER.md](DISCLAIMER.md) for details.

## License

This project is licensed under the [MIT License](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`