跳到正文

liyue-aigc

female-portrait-director

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

README 已保存到本站,可直接阅读

Documentation snapshot

README 快照

这篇是英文原文

下面正文是项目自己的英文 README。想读全文就用浏览器自带的整页翻译: Chrome / Edge 点地址栏右侧的翻译图标,或用右键菜单里的「翻译成中文」; 手机浏览器一般在菜单里。

本页保存的是公开项目资料快照,阅读过程不需要连接 GitHub。

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 lifestyleUrban fashionGufeng 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 streetFrench effortlessPure-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:

AgentInstall packagePrompt workflowDirect image workflow
CodexVerifiedRuntime-verifiedSupported when image generation is available
Claude CodeVerifiedAgent Skills compatibleDepends on the connected image tool
CursorVerifiedAgent Skills compatibleDepends on the connected image tool
GitHub CopilotVerifiedAgent Skills compatibleDepends on the connected image tool
Gemini CLIVerifiedAgent Skills compatibleDepends 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

Official distribution

获取与安装

暂未发现可确认的官方软件包地址

当前 README 快照没有出现 npm、PyPI、Crates.io、pub.dev 等官方包页链接。本站不会根据仓库名称猜测下载地址。

本站不托管项目文件;需要安装时,请以项目维护者发布的官方文档为准。

使用前核验

本站保存公开资料用于阅读,不代表安全审计或功能背书。安装前请核对许可证、依赖来源和发布签名,不要直接运行来源不明的二进制文件或高权限脚本。