Skill: xiaoaipensieve/cultural-naming-art (version 0.1.0)

--- name: "Cultural Naming & AI Art Creation" version: "2.0.0" description: | Transform a foreign identity into a Chinese cultural masterpiece. Give foreign tourists a meaningful Chinese name, generate classical Chinese poetry (Jueju & Lüshi), create traditional seal-carving art, and produce ink-wash landscape paintings or ancient-style portrait avatars inspired by the poetry. Compatible with OpenClaw (Lobster Claw), Tencent SkilHub, and major AI agent frameworks. author: "XiaoAIPensieve" license: "MIT" tags: - culture - naming - poetry - art - seal - shanshui - portrait - china-travel - ai-art languages: - en - zh runtime: models: - gpt-4o - claude-3-5-sonnet image_models: - dall-e-3 - stable-diffusion-xl min_context_window: 8000 permissions: - image_generation trigger_phrases: en: - "give me a Chinese name" - "Chinese name for me" - "what's my Chinese name" - "create a seal with my name" - "Chinese poem with my name" - "ink wash painting" - "Shanshui painting" - "Chinese portrait avatar" - "Chinese art from my name" - "classical poem" - "Jueju" - "Lüshi" - "seal carving" - "篆刻" zh: - "给我取个中文名" - "帮我起中文名" - "根据我的名字生成印章" - "生成古诗" - "山水画" - "古风头像" --- # Cultural Naming & AI Art Creation — SKILL Behavioral Specification v2.0 ## 🧭 Overview This skill activates when a foreign user wants to: 1. Receive a meaningful Chinese name 2. Generate classical Chinese poetry embedding their name 3. Create seal carving (篆刻) art from their name 4. Generate traditional landscape paintings or ancient-style portrait avatars The agent MUST maintain a **warm, culturally reverential, and poetic** tone. Always explain cultural context — the user should *understand* the art they receive, not just see it. --- ## 🔁 Master Flow ``` [START] │ ▼ STEP 1 ── Collect User Info │ (name + preferences) ▼ STEP 2 ── Generate Chinese Name (3 options) │ (phonetic + semantic mapping) ▼ STEP 3 ── User Selects Preferred Name │ ├──► STEP 4A ── Jueju Poem (绝句, 4 lines) │ ├──► STEP 4B ── Lüshi Poem (律诗, 8 lines) [user choice] │ ▼ STEP 5 ── Generate Art (one or all): │ ├── Seal Carving (篆刻印章) │ ├── Shanshui Landscape (水墨山水) │ └── Ancient Portrait Avatar (古风人物头像) ▼ [END] — Present full cultural identity package ``` --- ## MODULE A: 🪷 Chinese Name Generation (起名) ### Input Collection Ask the user: 1. **Full original name** (first + last) 2. **Gender preference** (masculine / feminine / neutral) — optional 3. **Preferred theme** — pick up to 2: - 🌿 Nature (自然): mountains, rivers, plum blossoms, moon - ⚔️ Strength (力量): heroic, resilient, unbreakable - 📖 Wisdom (智慧): scholarly, contemplative, enlightened - 🌸 Beauty (美丽): elegant, graceful, radiant - 🦅 Freedom (自由): soaring, untethered, adventurous - 🔥 Passion (热情): vibrant, bold, expressive ### Name Generation Algorithm ``` ALGORITHM: Semantic-Phonetic Fusion 1. PHONETIC MAPPING - Break original name into syllables - Map each syllable to similar-sounding Chinese characters - Score candidates by tonal beauty (avoid clashing 4th tones for feminine names) - Candidate pool: 500+ culturally vetted characters 2. SEMANTIC ENRICHMENT - Cross-reference candidates against chosen theme - Select characters with deep classical literary associations - Bonus: characters used in Tang/Song poetry 3. COMBINATION RULES - Standard length: 2 characters (surname omitted for tourists) - Optional: 3 characters (surname + given name, e.g., 林明远) - Avoid: homophone taboos, death-adjacent characters (死/亡/凶) - Check: stroke count balance, visual aesthetics 4. OUTPUT: 3 curated options ``` ### Output Format ``` ┌──────────────────────────────────────────────────────────────────┐ │ 🪷 Your Chinese Name Options for "Alexander" │ ├──────────────────────────────────────────────────────────────────┤ │ │ │ Option 1: 明远 (Míng Yuǎn) │ │ Characters: 明 bright/clear + 远 far/ambitious │ │ Meaning: "One whose brilliance reaches far horizons" │ │ Literary: Echoes 王之涣《登鹳雀楼》— "欲穷千里目，更上一层楼" │ │ Vibe: Scholarly · Visionary · Timeless │ │ │ │ Option 2: 烨尊 (Yè Zūn) │ │ Characters: 烨 blazing/resplendent + 尊 venerable/dignified │ │ Meaning: "Blazing brilliance, commanding respect" │ │ Literary: Inspired by 屈原《离骚》— celestial hero archetype │ │ Vibe: Heroic · Noble · Commanding │ │ │ │ Option 3: 亚历 (Yà Lì) │ │ Characters: 亚 great/Asian glory + 历 journey/experienced │ │ Meaning: "A great spirit forged through many journeys" │ │ Literary: Phonetic homage + 历 echoes classical travel poetry │ │ Vibe: Adventurous · Grounded · Worldly │ │ │ │ 👉 Which name speaks to you? (Reply 1, 2, or 3) │ └──────────────────────────────────────────────────────────────────┘ ``` ### Cultural Safety Rules - NEVER generate names with characters: 死, 亡, 鬼, 凶, 丑, 劣, 贱, 臭 - Check for inadvertent offensive compound meanings - For feminine names: prefer tonal softness (1st/2nd tone characters) - Always provide Pinyin with tones marked --- ## MODULE B: 📜 Classical Poetry Generation (古诗创作) ### B1 — Jueju (七言绝句) — 4-line poem ``` RULES: - 7 characters per line, 4 lines total (28 characters) - Tonal pattern: Line 1: 平平仄仄平平仄 (or variant) Line 2: 仄仄平平仄仄平 (end rhyme: 平声) Line 3: 仄仄平平平仄仄 Line 4: 平平仄仄仄平平 (end rhyme same as Line 2) - User's Chinese name MUST appear in Line 1 or Line 2 - Theme: drawn from the meaning of their chosen name - Classical imagery: mountains, rivers, plum blossoms, moonlight, cranes, mist OUTPUT FORMAT: ┌─────────────────────────────────────────────────────┐ │ 📜 七言绝句 · 赠明远 │ ├─────────────────────────────────────────────────────┤ │ 明远凌云志四方， Míng Yuǎn líng yún zhì sì fāng │ │ 千山万水路悠长。 Qiān shān wàn shuǐ lù yōu cháng │ │ 一声长啸惊飞鸟， Yī shēng cháng xiào jīng fēi niǎo│ │ 万里江湖任翱翔。 Wàn lǐ jiānghú rèn áo xiáng │ ├─────────────────────────────────────────────────────┤ │ 📖 Translation: │ │ Ming Yuan soars with ambitions spanning all │ │ directions, │ │ Through ten thousand mountains and endless waters │ │ he travels far. │ │ A single long cry startles the birds to flight — │ │ Ten thousand li of rivers and lakes, his to roam. │ ├─────────────────────────────────────────────────────┤ │ 🌿 Cultural Note: │ │ This poem draws on the 豪放 (heroic-free) style of │ │ Tang poets like 李白. The crane and soaring imagery │ │ symbolize an unbounded, enlightened spirit — a │ │ perfect match for the name 明远. │ └─────────────────────────────────────────────────────┘ ``` ### B2 — Lüshi (七言律诗) — 8-line poem ``` RULES: - 7 characters per line, 8 lines total (56 characters) - Strict tonal alternation across all 8 lines - Lines 3-4 and Lines 5-6 must form antithetical couplets (对仗) Example antithesis: "山高月小" vs "水落石出" - End rhymes on Lines 2, 4, 6, 8 (平声 rhyme class) - User's name embedded in Lines 1-2 - Theme: seasonal journey, a scholar's aspiration, or friendship ANTITHETICAL COUPLET GENERATION: Parallel structure requirements: - Noun ↔ Noun, Verb ↔ Verb, Adjective ↔ Adjective - Nature imagery ↔ Nature imagery - Example: "碧水东流千里远" ↔ "青山北望万年高" OUTPUT FORMAT: Same style as Jueju but 8 lines with couplet annotation ``` --- ## MODULE C: 🔴 Seal Carving Art (篆刻印章) ### Prompt Engineering — Seal Carving ```python SEAL_PROMPT_TEMPLATE = """ Traditional Chinese seal carving (篆刻 Zhuànkè), museum-quality studio photograph. SEAL SPECIFICATIONS: - Shape: Perfect square soapstone seal (寿山石), {size} cm - Script: Ancient bronze seal script (金文 Jīnwén) / Small seal script (小篆 Xiǎozhuàn) - Characters: "{chinese_name}" — {char_count} characters arranged in {layout} - Ink: Deep cinnabar vermillion (朱砂红) on aged xuan paper VISUAL DETAILS: - Stone texture: Fine-grained pale gray soapstone with subtle mineral veining - Ink impression: Slight ink bleed at stroke edges (authentic wear) - Border: Double hairline frame with corner roundness - Background: Cream-aged rice paper (宣纸), faint grid texture - Lighting: Soft raking light from upper-left, casting shallow relief shadows - Negative space: Generous white breathing room around characters COMPOSITION: - 45° three-quarter view showing both the stamp impression AND the carved stone - Carved stone surface shows intaglio (阴刻) or relief (阳刻): {carving_type} - Small red ink traces on stone edges from recent stamping STYLE TAGS: hyperrealistic, macro photography, museum artifact, 4K, cinematic NEGATIVE: blurry, modern font, digital art style, cartoonish, low quality """ # Layout rules: # 1 character → centered # 2 characters → side by side or vertical stack # 3 characters → triangle or L-shape # 4 characters → 2×2 grid ``` ### Carving Type Selection | Characters | Layout | Carving Type | |---|---|---| | 1 char | Centered | 阳刻 (white on red) | | 2 chars | Vertical stack | 阴刻 (red on white) | | 3 chars | 品字形 | 阳刻 | | 4 chars | 2×2 grid | Mixed 朱白相间 | --- ## MODULE D: 🏔️ Shanshui Landscape Painting (水墨山水) ### Prompt Engineering — Ink Wash Landscape ```python SHANSHUI_PROMPT_TEMPLATE = """ Traditional Chinese ink-wash landscape painting (水墨山水画 Shuǐmò Shānshuǐ Huà). DYNASTY STYLE: {dynasty_style} - Song Dynasty (宋): precise, contemplative, high mist, small human figures - Tang Dynasty (唐): bold strokes, warm atmosphere, river valleys - Ming Dynasty (明): 浙派 dramatic cliffs, dynamic diagonals - Modern Ink (现代): abstracted forms, minimal, zen POETIC THEME: "{poem_first_line}" SEASON/ATMOSPHERE: {season} — {atmosphere_desc} COMPOSITIONAL ELEMENTS: - Primary: {primary_element} (e.g., "mist-shrouded mountain peaks") - Secondary: {secondary_element} (e.g., "winding river through valley") - Accent: {accent_element} (e.g., "solitary pine on cliff edge") - Human element: {human_element} (e.g., "lone scholar in pavilion with lantern") BRUSHWORK: - Ink gradation: from dense black (焦墨) to pale wash (淡墨), 5+ tonal layers - Texture strokes: 皴法 — {cun_method} (e.g., 披麻皴/斧劈皴/雨点皴) - Wet-dry contrast: mixed wet brush and dry brush visible - Paper: xuan paper texture visible, slight bleed at edges SPECIAL EFFECTS: - 留白 (liú bái): generous unpainted white space representing sky/mist - Seal impression: small red stamp in lower-right corner reading "{chinese_name}" - Calligraphy: poem title "{poem_title}" inscribed vertically on left side FORMAT: Vertical hanging scroll (立轴), 3:5 aspect ratio QUALITY: 4K, museum collection quality, ink on xuan paper texture NEGATIVE: color photo, western watercolor, flat illustration, anime """ ``` ### Dynamic Element Selection by Name Theme ```python THEME_ELEMENTS = { "nature": { "primary": "towering misty peaks above clouds", "secondary": "crystal river reflecting moonlight below", "accent": "ancient pine clinging to cliff face", "human": "solitary scholar reading beneath waterfall" }, "strength": { "primary": "dramatic sheer cliff face with cascading waterfall", "secondary": "churning rapids through narrow gorge", "accent": "lone eagle soaring on updrafts", "human": "warrior-scholar standing on summit, robes billowing" }, "wisdom": { "primary": "misty mountain monastery on distant peak", "secondary": "stone bridge over still reflective pond", "accent": "ancient ginkgo tree shedding golden leaves", "human": "elder monk and young student conversing in pavilion" }, "beauty": { "primary": "plum blossoms framing moonlit distant peaks", "secondary": "lily pads on glassy lake at dusk", "accent": "pair of cranes in mid-flight", "human": "graceful figure playing guqin under willow" }, "freedom": { "primary": "vast open sky above rolling hills to horizon", "secondary": "wild geese in V-formation over river", "accent": "solitary boat drifting downstream", "human": "traveler with staff and bundle at mountain pass" } } ``` --- ## MODULE E: 👤 Ancient Portrait Avatar (古风人物头像) ### Prompt Engineering — Ancient Style Portrait ```python PORTRAIT_PROMPT_TEMPLATE = """ Traditional Chinese ancient-style portrait illustration (古风人物头像). CHARACTER CONCEPT: - Name: {chinese_name} ({pinyin}) - Gender presentation: {gender} - Era aesthetic: {dynasty_aesthetic} Options: Tang Dynasty court (唐), Song Dynasty scholar (宋), Ming Dynasty knight-errant (明侠), Qing Dynasty literati (清) VISUAL STYLE: - Art style: Chinese ancient illustration (古风插画), semi-realistic - Line art: precise ink outlines with hair-fine detail - Coloring: rich mineral pigments — lapis lazuli blue, vermillion red, malachite green, ochre gold, ink black FACE & EXPRESSION: - Expression: serene, intelligent, with subtle depth — "淡然而深远" - Eyes: clear and luminous (明眸), reflecting inner strength - No modern makeup styles COSTUME & ACCESSORIES (by dynasty): Tang Scholar: flowing hanfu with wide sleeves, jade pendant, scholarly cap Tang Hero: armor with phoenix embossing, red cape Song Literati: simple hanfu, ink-stained fingers, bamboo scroll Ming Heroine: elaborate embroidered hanfu, floral hairpin, sword hilt visible Qing Poet: high collar robe, ink brush behind ear BACKGROUND ELEMENTS: - {background_motif}: (e.g., "blooming plum blossom branch", "misty mountain silhouette", "moonlit bamboo grove") - Subtle decorative border: traditional cloud-scroll pattern (云纹) - Color palette: harmonious with character's costume CALLIGRAPHY ELEMENT: - Character's name "{chinese_name}" in elegant running script (行书) positioned upper-right corner with small seal stamp TECHNICAL: - Square format, 1:1 aspect ratio - Illustration quality: premium game CG / art book level - NEGATIVE: western cartoon, anime chibi, modern fashion, photo-realistic """ ``` ### Dynasty Aesthetic Selector | User Theme | Suggested Dynasty | Costume | Background | |---|---|---|---| | Nature | Song (宋) | Simple hanfu, bamboo hat | Mountain mist | | Strength | Ming/Tang (明/唐) | Armor or warrior robes | Storm clouds | | Wisdom | Song (宋) | Scholar robes, ink brush | Library/study | | Beauty | Tang (唐) | Elaborate court dress | Peony garden | | Freedom | Ming (明侠) | Travel cloak, sword | Open horizon | --- ## 🎁 Full Cultural Identity Package Output After completing all steps, present the full package: ``` ╔══════════════════════════════════════════════════════════════════╗ ║ 🇨🇳 YOUR CHINESE CULTURAL IDENTITY PACKAGE 🇨🇳 ║ ╠══════════════════════════════════════════════════════════════════╣ ║ ║ ║ 📛 YOUR CHINESE NAME ║ ║ 明远 (Míng Yuǎn) — "Brilliant and Far-reaching" ║ ║ ║ ║ 📜 YOUR CLASSICAL POEM (七言绝句) ║ ║ 明远凌云志四方， ║ ║ 千山万水路悠长。 ║ ║ 一声长啸惊飞鸟， ║ ║ 万里江湖任翱翔。 ║ ║ ║ ║ 🔴 YOUR SEAL CARVING [Image: seal_mingyuan.png] ║ ║ 🏔️ YOUR LANDSCAPE [Image: shanshui_mingyuan.png] ║ ║ 👤 YOUR PORTRAIT [Image: portrait_mingyuan.png] ║ ║ ║ ║ 💡 Fun fact: Your seal script "明" dates to 1046 BCE ║ ║ and was carved on bronze ritual vessels! ║ ╚══════════════════════════════════════════════════════════════════╝ ``` --- ## 🛡️ Cultural Safety Protocols 1. **Taboo character check**: Run against 200+ character blocklist before output 2. **Gender sensitivity**: Never assume gender; always ask or offer neutral options 3. **Regional variants**: Note Cantonese vs. Mandarin pronunciation differences for HK/Macau visitors 4. **Historical accuracy**: All dynasty references must be factually grounded 5. **Art prompt safety**: No depictions of real historical figures without consent framing 6. **Attribution**: Always credit the classical poets/styles being referenced --- *SKILL.md v2.0.0 — Cultural Naming & AI Art Creation by XiaoAIPensieve*

path: DEPLOYMENT_GUIDE.md
content: # 🚀 Tencent SkillHub — Publishing Guide
## Cultural Naming & AI Art Creation v2.0.0

This guide walks you through publishing the **Cultural Naming & AI Art Creation** skill to Tencent SkillHub (skillhub.cloud.tencent.com) and the global ClawHub (clawhub.ai).

---

## 📁 Required Files (already prepared)

```
cultural-naming-art/
├── .trae/skills/cultural-naming-art/
│   ├── SKILL.md                        ✅ 核心行为规范（必需）
│   ├── openclaw_config.yaml             ✅ OpenClaw/Lobster Claw 配置
│   ├── tencent_skilhub_manifest.json   ✅ 腾讯 SkilHub 清单（必需）
│   └── requirements.txt                 ✅ Python 依赖（可选）
├── skill.py                            ✅ Python 核心逻辑
├── prompts.py                          ✅ 艺术提示词库
├── cultural-naming-art-README.md        ✅ GitHub 仓库说明
└── DEPLOYMENT_GUIDE.md                ✅ 本文件
```

---

## 🅰️ Option A: Publish via GitHub Import (Recommended)

### Step 1: Create a Public GitHub Repository

```
Create new repo on GitHub: https://github.com/new
Repo name: cultural-naming-art
Description: "Transform a foreign identity into a Chinese cultural masterpiece"
Visibility: Public ⭐
Add README: YES | Add .gitignore: Python
```

### Step 2: Push All Files to GitHub

```bash
cd /Users/admin/WorkBuddy/20260517145203

git init
git add .
git commit -m "feat: Cultural Naming & AI Art Creation v2.0.0

- Chinese name generation (semantic-phonetic fusion)
- Jueju (七言绝句) & Lüshi (七言律诗) poetry
- Seal carving art prompts (篆刻)
- Shanshui landscape prompts (水墨山水)
- Ancient portrait avatar prompts (古风人物头像)
- 200+ taboo character safety filter
- OpenClaw + Tencent SkilHub compatible"

git branch -M main
git remote add origin https://github.com/YOUR_USERNAME/cultural-naming-art.git
git push -u origin main
```

### Step 3: Publish to Tencent SkillHub

1. **访问发布页面：**
   - 腾讯 SkillHub: `https://skillhub.cloud.tencent.com/developer/publish`
   - 或全局版: `https://clawhub.ai/import`

2. **选择 "Import from GitHub" 标签页**

3. **填写表单：**

| 字段 | 填写内容 |
|------|----------|
| **GitHub URL** | `https://github.com/YOUR_USERNAME/cultural-naming-art` |
| **Skill Name** | `cultural-naming-art` |
| **Display Name** | `Cultural Naming & AI Art Creation` |
| **Description** | `Transform a foreign name into a complete Chinese cultural identity. Chinese names, Tang/Song poetry, seal carving art, ink-wash landscapes, ancient portrait avatars.` |
| **Category** | `Culture & Art` |
| **Tags** | `chinese-name, poetry, seal, shanshui, ai-art, china-travel` |
| **Version** | `2.0.0` |
| **License** | `MIT` |

4. **点击 "Detect" 自动填充** → 检查所有字段是否正确

5. **审核说明：**
```
This skill transforms foreign tourist identities into complete Chinese
cultural masterpieces. Features: semantic Chinese naming, Jueju/Lüshi
poetry generation, seal carving, Shanshui landscape, and ancient
portrait avatar art prompts. Includes 200+ taboo character filter
for cultural safety.
```

6. **点击 "Publish Skill"**

7. **确认发布成功** → 技能 URL：
```
https://skillhub.cloud.tencent.com/skills/cultural-naming-art
```

---

## 🅱️ Option B: Direct Folder Upload

### Step 1: Prepare Upload Folder

```bash
mkdir -p /tmp/cultural-naming-art-upload
cp -r /Users/admin/WorkBuddy/20260517145203/.trae/skills/cultural-naming-art/* \
  /tmp/cultural-naming-art-upload/
```

### Step 2: 上传到 SkillHub

1. 访问 `https://clawhub.ai/import`
2. 选择 **"Upload Folder"** 标签页
3. 拖拽上传文件夹
4. 填写与 Option A 相同的表单字段
5. 点击 **"Publish Skill"**

---

## ⚠️ 常见问题排查

| 错误信息 | 原因 | 解决方法 |
|---------|------|---------|
| `Slug must be lowercase` | Slug 包含大写字母 | 改为全小写：`cultural-naming-art` |
| `Remove non-text files` | 包含 `.git`、`LICENSE` 等 | 删除非文本文件后重新上传 |
| `SKILL.md not found` | 根目录找不到 SKILL.md | 确保 SKILL.md 在仓库根目录 |
| `Invalid manifest JSON` | manifest 格式错误 | 检查 JSON 语法，确保无尾随逗号 |
| `GitHub API rate limit` | GitHub 请求超限 | 等待10分钟或改用文件夹上传 |
| `Connection lost` | 网络波动 | 刷新页面，精简文件后重试 |

---

## ✅ 发布前检查清单

```
Pre-publish Checklist
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[ ] GitHub 仓库已设为 Public（公开）
[ ] SKILL.md 在仓库根目录
[ ] tencent_skilhub_manifest.json 已包含所有6个模块定义
[ ] 所有触发词（Trigger Phrases）已填写中英文
[ ] 版本号格式正确（SemVer: x.y.z）
[ ] 无 .git / .DS_Store / LICENSE 等非文本文件
[ ] manifest JSON 格式验证通过（jsonlint.com）
[ ] skill 描述已填写（3句话以上）
[ ] 至少3个示例用法（Example Utterances）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

---

## 🔗 发布后验证

```
腾讯 SkillHub:    https://skillhub.cloud.tencent.com/skills/cultural-naming-art
全局 ClawHub:     https://clawhub.ai/skills/cultural-naming-art
GitHub 仓库:      https://github.com/YOUR_USERNAME/cultural-naming-art
```

---

*Guide v1.0.0 — Published for Tencent SkillHub & ClawHub*


path: openclaw_config.yaml
content: # ============================================================
# Lobster OpenClaw Hub — Agent Skill Configuration
# Skill: Cultural Naming & AI Art Creation
# Version: 2.0.0
# Platform: ClawHub.ai / mirror-cn.clawhub.com
# ============================================================

skill:
  id: "com.xiaoapensieve.cultural-naming-art"
  name: "Cultural Naming & AI Art Creation"
  version: "2.0.0"
  author: "XiaoAIPensieve"
  description: >
    Transform a foreign identity into a Chinese cultural masterpiece.
    Gives tourists a semantically rich Chinese name, generates classical
    Jueju & Lüshi poetry, produces seal carving art prompts, ink-wash
    Shanshui landscape prompts, and ancient-style portrait avatar prompts.

# ------------------------------------------------------------
# Deployment
# ------------------------------------------------------------
deployment:
  primary_hub: "clawhub.ai"
  mirror_hub: "mirror-cn.clawhub.com"
  skill_path: ".trae/skills/cultural-naming-art"
  skill_definition: "SKILL.md"
  regions:
    - id: "global"
      endpoint: "https://clawhub.ai/api/v2/skills"
    - id: "china-mirror"
      endpoint: "https://mirror-cn.clawhub.com/api/v2/skills"

# ------------------------------------------------------------
# Runtime
# ------------------------------------------------------------
runtime:
  preferred_models:
    - provider: "anthropic"
      model: "claude-3-5-sonnet-20241022"
      priority: 1
      use_for: ["naming", "poetry", "cultural_explanation"]
    - provider: "openai"
      model: "gpt-4o"
      priority: 2
      use_for: ["naming", "poetry", "prompt_engineering"]
    - provider: "openai"
      model: "gpt-4o-mini"
      priority: 3
      use_for: ["fallback"]

  image_models:
    - provider: "openai"
      model: "dall-e-3"
      priority: 1
      quality: "hd"
      use_for: ["seal_carving", "shanshui", "portrait"]
    - provider: "stability_ai"
      model: "stable-diffusion-xl-1024-v1-0"
      priority: 2
      use_for: ["shanshui", "portrait"]
    - provider: "tencent"
      model: "hunyuan-image"
      priority: 3
      use_for: ["china_mirror_fallback"]

  context_window:
    min: 8000
    recommended: 32000

  session_memory:
    enabled: true
    keys:
      - "user_original_name"
      - "user_chinese_name"
      - "user_chinese_name_pinyin"
      - "chosen_theme"
      - "gender_preference"
      - "generated_poem_jueju"
      - "generated_poem_lushi"
      - "art_outputs"
      - "preferred_language"
      - "dynasty_aesthetic"

# ------------------------------------------------------------
# Feature Flags
# ------------------------------------------------------------
features:
  # Core features
  name_generation:
    enabled: true
    options_count: 3           # Always generate 3 name options
    include_etymology: true
    include_literary_reference: true
    include_pinyin: true
    taboo_filter: true

  # Poetry features
  poetry_jueju:
    enabled: true
    format: "7-char-4-line"    # 七言绝句
    include_translation: true
    include_cultural_note: true
    include_pinyin: true

  poetry_lushi:
    enabled: true
    format: "7-char-8-line"    # 七言律诗
    include_antithetical_couplets: true
    include_translation: true
    include_annotations: true
    couplet_pairs: [3, 4]      # Lines 3-4 and 5-6 are couplets

  # Art generation features
  seal_carving:
    enabled: true
    carving_types: ["阴刻", "阳刻", "朱白相间"]
    default_style: "阳刻"
    script_options: ["金文", "小篆", "大篆"]
    default_script: "小篆"
    generate_image: true

  shanshui_painting:
    enabled: true
    dynasty_styles: ["Song", "Tang", "Ming", "Modern"]
    default_dynasty: "Song"
    generate_image: true
    include_poem_calligraphy: true   # Overlay poem on painting

  portrait_avatar:
    enabled: true
    dynasty_aesthetics: ["Tang", "Song", "Ming", "Qing"]
    default_gender: "neutral"
    generate_image: true
    include_name_calligraphy: true

  # Package output
  full_cultural_package:
    enabled: true                    # Present everything in one formatted package
    auto_generate_all_art: false     # Ask user which art they want
    offer_download_package: true

# ------------------------------------------------------------
# Intent Triggers
# ------------------------------------------------------------
intent_triggers:

  - id: "trigger_chinese_name"
    confidence_threshold: 0.75
    keywords:
      en: ["Chinese name", "give me a name", "name in Chinese", "what's my Chinese name",
           "Chinese characters for my name", "translate my name to Chinese",
           "meaningful Chinese name", "Chinese identity"]
      zh: ["中文名", "起名", "给我取个名字", "中国名字", "汉字名字"]
    example_utterances:
      - "Can you give me a Chinese name?"
      - "What would my name be in Chinese?"
      - "I want a meaningful Chinese name based on 'Sarah'"
      - "Give me a Chinese name that means strength"
    action:
      type: "invoke_flow"
      entry_step: "collect_user_info"
      module: "name_generation"

  - id: "trigger_seal_art"
    confidence_threshold: 0.80
    keywords:
      en: ["seal carving", "Chinese seal", "stamp", "篆刻", "chop", "name stamp",
           "red seal", "traditional seal", "seal script"]
      zh: ["印章", "篆刻", "刻章", "印鉴", "朱砂印"]
    example_utterances:
      - "Create a seal carving with my name"
      - "Make me a traditional Chinese seal"
      - "Generate a 篆刻 stamp with 明远"
    action:
      type: "invoke_flow"
      entry_step: "seal_carving_gen"
      module: "seal_carving"
      prerequisite: "user_chinese_name"  # Must have a name first

  - id: "trigger_poem"
    confidence_threshold: 0.75
    keywords:
      en: ["Chinese poem", "classical poem", "write a poem", "Jueju", "Lüshi",
           "Tang poetry", "poem with my name", "古诗", "七言绝句", "律诗"]
      zh: ["古诗", "绝句", "律诗", "写诗", "用我的名字写诗", "七言"]
    example_utterances:
      - "Write a classical Chinese poem with my name"
      - "Create a Jueju poem for me"
      - "Generate a Tang-style poem using 明远"
      - "I want both Jueju and Lüshi poems"
    action:
      type: "invoke_flow"
      entry_step: "select_poem_type"
      module: "poetry_generation"
      prerequisite: "user_chinese_name"

  - id: "trigger_shanshui"
    confidence_threshold: 0.78
    keywords:
      en: ["ink wash painting", "Shanshui", "landscape painting", "Chinese painting",
           "水墨画", "mountain water painting", "traditional Chinese landscape",
           "ink brush painting", "Chinese art"]
      zh: ["山水画", "水墨画", "国画", "山水", "古风山水", "泼墨"]
    example_utterances:
      - "Generate a Shanshui painting inspired by my poem"
      - "Create a Chinese ink wash landscape"
      - "Make me a traditional mountain painting"
    action:
      type: "invoke_flow"
      entry_step: "shanshui_config"
      module: "shanshui_painting"
      prerequisite: "user_chinese_name"

  - id: "trigger_portrait"
    confidence_threshold: 0.78
    keywords:
      en: ["ancient portrait", "Chinese avatar", "ancient style portrait",
           "古风头像", "hanfu portrait", "traditional Chinese character art",
           "dynasty character", "Chinese historical portrait"]
      zh: ["古风头像", "古装人物", "古风插画", "汉服头像", "古代人物"]
    example_utterances:
      - "Create an ancient Chinese portrait avatar for me"
      - "Generate a Tang Dynasty portrait with my name"
      - "Make me a 古风头像 based on my Chinese identity"
    action:
      type: "invoke_flow"
      entry_step: "portrait_config"
      module: "portrait_avatar"
      prerequisite: "user_chinese_name"

  - id: "trigger_full_package"
    confidence_threshold: 0.70
    keywords:
      en: ["everything", "full package", "all of it", "complete Chinese identity",
           "name and poem and art", "cultural package", "the whole thing"]
      zh: ["全套", "全部", "名字诗歌印章都要", "完整文化套餐"]
    example_utterances:
      - "Give me the full cultural package"
      - "I want a Chinese name, poem, and all the art"
      - "Everything please!"
    action:
      type: "invoke_flow"
      entry_step: "collect_user_info"
      auto_chain: ["name_generation", "poetry_jueju", "poetry_lushi", 
                   "seal_carving", "shanshui_painting", "portrait_avatar"]

# ------------------------------------------------------------
# Flow Definitions
# ------------------------------------------------------------
flows:

  collect_user_info:
    id: "collect_user_info"
    description: "Gather name, gender, and theme preference from user"
    steps:
      - ask: "full_original_name"
        prompt: "What's your full name? (first and last name)"
        required: true
        store_as: "user_original_name"
      - ask: "gender_preference"
        prompt: "Any gender preference for your Chinese name?"
        options: ["masculine", "feminine", "neutral / no preference"]
        required: false
        store_as: "gender_preference"
        default: "neutral"
      - ask: "theme_preference"
        prompt: >
          "What theme would you like your name to reflect? (pick 1-2)
          🌿 Nature · ⚔️ Strength · 📖 Wisdom · 🌸 Beauty · 🦅 Freedom · 🔥 Passion"
        multi_select: true
        max_selections: 2
        required: false
        store_as: "chosen_theme"
        default: ["nature"]
    on_complete: "name_generation"

  name_generation:
    id: "name_generation"
    description: "Generate 3 Chinese name options"
    input: ["user_original_name", "gender_preference", "chosen_theme"]
    output: "user_chinese_name"
    on_complete: "present_name_options"
    on_user_selection: "ask_next_creation"

  ask_next_creation:
    id: "ask_next_creation"
    description: "After name selection, offer art options"
    prompt: >
      "🎉 Great! Your Chinese name is set. What would you like to create next?
       1️⃣  📜 Classical Poem (Jueju 绝句)
       2️⃣  📜 Classical Poem (Lüshi 律诗 — longer, more elaborate)
       3️⃣  🔴 Seal Carving (篆刻印章)
       4️⃣  🏔️ Landscape Painting (水墨山水)
       5️⃣  👤 Ancient Portrait Avatar (古风头像)
       6️⃣  🎁 Give me everything! (Full Cultural Package)"
    options: ["1", "2", "3", "4", "5", "6"]
    routes:
      "1": "poetry_jueju"
      "2": "poetry_lushi"
      "3": "seal_carving_gen"
      "4": "shanshui_config"
      "5": "portrait_config"
      "6": "full_package"

# ------------------------------------------------------------
# Image Generation Settings
# ------------------------------------------------------------
image_generation:
  enabled: true
  default_quality: "hd"
  default_size:
    seal: "1024x1024"
    shanshui: "1024x1792"    # Tall vertical scroll format
    portrait: "1024x1024"    # Square avatar
  
  style_presets:
    seal_carving:
      style: "natural"
      negative_prompt: "blurry, modern font, digital art, cartoonish, low quality, 3D render"
    shanshui:
      style: "natural"
      negative_prompt: "color photo, western watercolor, flat illustration, anime, modern"
    portrait:
      style: "vivid"
      negative_prompt: "western cartoon, chibi, modern fashion, photo-realistic face, 3D"

  rate_limits:
    max_images_per_session: 6
    max_images_per_module: 2
    cooldown_seconds: 5

# ------------------------------------------------------------
# Localization
# ------------------------------------------------------------
localization:
  default_language: "en"
  auto_detect_language: true
  supported_languages:
    - code: "en"
      name: "English"
    - code: "zh-CN"
      name: "简体中文"
    - code: "fr"
      name: "Français"
    - code: "de"
      name: "Deutsch"
    - code: "es"
      name: "Español"
    - code: "ja"
      name: "日本語"
    - code: "ko"
      name: "한국어"
    - code: "it"
      name: "Italiano"
    - code: "pt"
      name: "Português"
    - code: "ru"
      name: "Русский"

# ------------------------------------------------------------
# Safety
# ------------------------------------------------------------
safety:
  cultural_sensitivity: "high"
  taboo_character_filter: true
  taboo_character_list_path: "data/taboo_characters.json"
  content_policy: "respectful_cultural_education"
  include_cultural_context: true      # Always explain WHY something is used
  include_historical_source: true     # Cite dynasty/poet when referencing
  
  prohibited:
    - "generate names with death-adjacent characters"
    - "mock or trivialize Chinese cultural traditions"
    - "claim historical accuracy without sourcing"
    - "generate real historical figures as portrait subjects"

# ------------------------------------------------------------
# Analytics
# ------------------------------------------------------------
analytics:
  enabled: true
  track_most_popular_themes: true
  track_module_completion_rates: true
  no_pii_in_logs: true
  telemetry_endpoint: "https://clawhub.ai/api/v2/telemetry"


path: requirements.txt
content: # Cultural Naming & AI Art Creation — Python Dependencies
# Version: 2.0.0
# Python: >= 3.10

# ─── Core ───────────────────────────────────────────────────────────
openai>=1.30.0
anthropic>=0.28.0

# ─── Image Generation (optional) ────────────────────────────────────
stability-sdk>=0.8.0          # Stable Diffusion XL — optional fallback

# ─── Utilities ──────────────────────────────────────────────────────
python-dotenv>=1.0.0          # .env environment variable loading
pydantic>=2.0.0                # Data validation & serialization
tencent-cloud-sdk-python>=0.1.0 # Tencent Hunyuan API — optional China image model


path: tencent_skilhub_manifest.json
content: {
  "$schema": "https://skilhub.tencent.com/schemas/skill-manifest/v2.json",
  "manifest_version": "2.0",
  "skill": {
    "id": "com.xiaoapensieve.cultural-naming-art",
    "name": "Cultural Naming & AI Art Creation",
    "display_name": {
      "en": "Cultural Naming & AI Art Creation — Chinese Name, Poetry & Ink Art",
      "zh-CN": "中文起名与AI艺术创作 — 外国游客的中国文化身份套餐"
    },
    "version": "2.0.0",
    "description": {
      "en": "Transform a foreign name into a complete Chinese cultural identity. Generates semantically rich Chinese names, classical Tang/Song poetry (Jueju & Lüshi) embedding the name, traditional seal carving art (篆刻), ink-wash Shanshui landscape paintings, and ancient Chinese portrait avatars. Compatible with GPT-4o, Claude-3.5, and DALL·E 3 / Stable Diffusion XL.",
      "zh-CN": "将外国名字转化为完整的中国文化身份。生成语义丰富的中文名字、嵌入名字的唐宋风格古诗词（七言绝句/律诗）、传统篆刻印章、水墨山水画以及古风人物头像。兼容 GPT-4o、Claude-3.5 及 DALL·E 3 / Stable Diffusion XL。"
    },
    "author": {
      "name": "XiaoAIPensieve",
      "email": "[REDACTED_SECRET]",
      "url": "https://github.com/XiaoAIPensieve/cultural-naming-art"
    },
    "category": "culture",
    "subcategories": ["naming", "poetry", "art", "chinese-culture", "ai-image-generation", "china-travel"],
    "tags": ["chinese-name", "naming", "poetry", "jueju", "lushi", "seal-carving", "shanshui", "ink-painting", "ancient-portrait", "hanzi", "pinyin", "chinese-art", "ai-art", "china-travel", "cultural-immersion"],
    "license": "MIT",
    "repository": "https://github.com/XiaoAIPensieve/cultural-naming-art",
    "homepage": "https://skilhub.cloud.tencent.com/skills/cultural-naming-art",
    "icon": "assets/icon-512.png"
  },
  "runtime": {
    "environment": "tencent-cloud",
    "region": "ap-guangzhou",
    "supported_models": [
      {
        "provider": "anthropic",
        "model": "claude-3-5-sonnet-20241022",
        "min_context_window": 8000,
        "preferred": true,
        "use_for": ["name_generation", "poetry_generation", "cultural_explanation"]
      },
      {
        "provider": "openai",
        "model": "gpt-4o",
        "min_context_window": 8000,
        "preferred": true,
        "use_for": ["name_generation", "poetry_generation", "prompt_engineering"]
      },
      {
        "provider": "openai",
        "model": "dall-e-3",
        "min_context_window": 0,
        "preferred": true,
        "use_for": ["seal_carving", "shanshui_landscape", "portrait_avatar"],
        "quality": "hd"
      },
      {
        "provider": "stability_ai",
        "model": "stable-diffusion-xl-1024-v1-0",
        "min_context_window": 0,
        "preferred": false,
        "use_for": ["shanshui_landscape", "portrait_avatar"]
      }
    ],
    "max_turns": 50,
    "session_memory": true,
    "session_memory_keys": [
      "user_original_name",
      "user_chinese_name",
      "user_chinese_name_pinyin",
      "chosen_theme",
      "gender_preference",
      "generated_poem_jueju",
      "generated_poem_lushi",
      "art_outputs",
      "preferred_language",
      "dynasty_aesthetic"
    ]
  },
  "permissions": [
    {
      "name": "image_generation",
      "description": "Generate seal carving, Shanshui landscape, and portrait avatar images using DALL·E 3 or Stable Diffusion XL.",
      "required": true,
      "scope": "session"
    },
    {
      "name": "internet_access",
      "description": "Fetch real-time data for cultural references and historical accuracy verification.",
      "required": false,
      "scope": "session"
    }
  ],
  "modules": [
    {
      "id": "name_generation",
      "name": "Chinese Name Generation",
      "description": "Generate 3 semantically rich Chinese name options from a foreign name using phonetic-semantic fusion algorithm.",
      "trigger_intents": [
        "request_chinese_name",
        "semantic_naming",
        "phonetic_name_conversion"
      ],
      "entry_phrases": {
        "en": [
          "give me a Chinese name",
          "what's my name in Chinese",
          "translate my name to Chinese",
          "meaningful Chinese name",
          "Chinese characters for my name",
          "I want a Chinese name",
          "name me in Chinese"
        ],
        "zh-CN": [
          "给我取个中文名",
          "帮我起中文名",
          "我的中文名字",
          "用中文名字"
        ]
      },
      "features": {
        "name_options_count": 3,
        "include_etymology": true,
        "include_literary_reference": true,
        "include_pinyin": true,
        "include_vibe_tags": true,
        "taboo_character_filter": true,
        "themes_available": ["nature", "strength", "wisdom", "beauty", "freedom", "passion"]
      }
    },
    {
      "id": "poetry_jueju",
      "name": "Jueju Poem Generation (七言绝句)",
      "description": "Generate a 4-line, 7-character-per-line classical Tang Dynasty Jueju poem embedding the user's Chinese name.",
      "trigger_intents": [
        "generate_jueju",
        "classical_poem",
        "tang_poetry",
        "short_poem"
      ],
      "entry_phrases": {
        "en": [
          "write a Chinese poem with my name",
          "create a Jueju poem",
          "generate Tang poetry",
          "classical Chinese poem",
          "七言绝句"
        ],
        "zh-CN": [
          "写一首古诗",
          "生成七言绝句",
          "用我的名字写诗"
        ]
      },
      "features": {
        "format": "7-char-4-line",
        "include_pinyin": true,
        "include_translation": true,
        "include_cultural_note": true,
        "style_options": ["豪放", "婉约"],
        "name_embedded_in": "line_1_or_2"
      }
    },
    {
      "id": "poetry_lushi",
      "name": "Lüshi Poem Generation (七言律诗)",
      "description": "Generate an 8-line, 7-character-per-line classical Lüshi poem with mandatory antithetical couplets (对仗联).",
      "trigger_intents": [
        "generate_lushi",
        "regulated_verse",
        "long_poem",
        "antithetical_couplets"
      ],
      "entry_phrases": {
        "en": [
          "write a Lüshi poem",
          "generate 8-line poem",
          "antithetical couplet poem",
          "律诗"
        ],
        "zh-CN": [
          "生成律诗",
          "七言律诗",
          "对仗联"
        ]
      },
      "features": {
        "format": "7-char-8-line",
        "include_antithetical_couplets": true,
        "couplet_pairs": [3, 4, 5, 6],
        "include_pinyin": true,
        "include_translation": true,
        "include_annotations": true
      }
    },
    {
      "id": "seal_carving",
      "name": "Seal Carving Art (篆刻印章)",
      "description": "Generate a high-fidelity image prompt for traditional Chinese seal carving art in small seal script (小篆) or bronze script (金文).",
      "trigger_intents": [
        "create_seal_art",
        "seal_carving",
        "name_stamp",
        "篆刻",
        "traditional_chop"
      ],
      "entry_phrases": {
        "en": [
          "create a seal with my name",
          "make a Chinese seal",
          "seal carving art",
          "name stamp",
          "篆刻印章"
        ],
        "zh-CN": [
          "刻章",
          "篆刻印章",
          "用我的名字做印章"
        ]
      },
      "features": {
        "script_options": ["小篆", "金文", "大篆"],
        "carving_types": ["阳刻", "阴刻", "朱白相间"],
        "materials": ["寿山石", "青田石", "昌化石"],
        "generate_image": true,
        "image_aspect_ratio": "1:1"
      }
    },
    {
      "id": "shanshui_landscape",
      "name": "Shanshui Landscape Painting (水墨山水)",
      "description": "Generate a traditional Chinese ink-wash landscape painting inspired by the user's poem and theme, in Song/Tang/Ming dynasty style.",
      "trigger_intents": [
        "generate_shanshui",
        "ink_wash_landscape",
        "mountain_painting",
        "山水画",
        "水墨画"
      ],
      "entry_phrases": {
        "en": [
          "generate a Shanshui painting",
          "ink wash landscape",
          "Chinese mountain painting",
          "山水画"
        ],
        "zh-CN": [
          "山水画",
          "水墨山水",
          "中国画"
        ]
      },
      "features": {
        "dynasty_styles": ["Song", "Tang", "Ming", "Modern"],
        "theme_driven": true,
        "include_poem_calligraphy": true,
        "include_name_seal": true,
        "generate_image": true,
        "image_aspect_ratio": "2:3",
        "cun_methods_available": ["披麻皴", "斧劈皴", "雨点皴", "荷叶皴", "折带皴", "解索皴"]
      }
    },
    {
      "id": "portrait_avatar",
      "name": "Ancient Portrait Avatar (古风人物头像)",
      "description": "Generate an ancient Chinese portrait avatar in the user's preferred dynasty aesthetic, with their Chinese name as calligraphy.",
      "trigger_intents": [
        "generate_portrait",
        "ancient_avatar",
        "ancient_style_portrait",
        "古风头像",
        "古风人物"
      ],
      "entry_phrases": {
        "en": [
          "create an ancient Chinese portrait",
          "Chinese avatar",
          "古风头像",
          "ancient portrait avatar"
        ],
        "zh-CN": [
          "古风头像",
          "古装人物",
          "古风插画"
        ]
      },
      "features": {
        "dynasty_aesthetics": ["Tang", "Song", "Ming", "Qing"],
        "theme_to_dynasty_mapping": {
          "nature": "Song",
          "strength": "Tang",
          "wisdom": "Song",
          "beauty": "Tang",
          "freedom": "Ming",
          "passion": "Tang"
        },
        "include_name_calligraphy": true,
        "generate_image": true,
        "image_aspect_ratio": "1:1"
      }
    },
    {
      "id": "full_package",
      "name": "Complete Cultural Identity Package",
      "description": "Generate the complete Chinese cultural identity: name + Jueju + Lüshi + seal + landscape + portrait avatar.",
      "trigger_intents": [
        "full_package",
        "complete_identity",
        "everything",
        "all_art"
      ],
      "entry_phrases": {
        "en": [
          "give me the full package",
          "I want everything",
          "complete Chinese identity",
          "name poem and art all of it"
        ],
        "zh-CN": [
          "全套",
          "全部都要",
          "完整文化套餐",
          "名字诗歌印章都要"
        ]
      },
      "features": {
        "auto_chain": ["name_generation", "poetry_jueju", "poetry_lushi", "seal_carving", "shanshui_landscape", "portrait_avatar"],
        "ordered_presentation": true
      }
    }
  ],
  "localization": {
    "default_language": "en",
    "supported_languages": ["en", "zh-CN", "zh-TW", "fr", "de", "es", "ja", "ko"],
    "auto_detect": true
  },
  "safety": {
    "privacy_policy": "https://github.com/XiaoAIPensieve/cultural-naming-art/blob/main/PRIVACY.md",
    "data_collection": "none",
    "pii_handling": "session_only_no_persistence",
    "prohibited_actions": [
      "collect_passport_numbers",
      "persist_user_name",
      "share_data_third_party"
    ],
    "content_safety": {
      "cultural_sensitivity": "high",
      "taboo_character_filter": true,
      "taboo_character_count": 200,
      "prohibited_content": [
        "death-adjacent_characters_in_names",
        "mock_trivialize_chinese_culture",
        "real_historical_figures_as_portrait_subjects"
      ]
    }
  },
  "screenshots": [
    "assets/screenshots/name-options-display.png",
    "assets/screenshots/jueju-poem-display.png",
    "assets/screenshots/seal-carving-art.png",
    "assets/screenshots/shanshui-painting.png",
    "assets/screenshots/portrait-avatar.png"
  ],
  "changelog": [
    {
      "version": "2.0.0",
      "date": "2026-05-17",
      "notes": [
        "Initial release",
        "6 modules: Name Generation, Jueju, Lüshi, Seal Carving, Shanshui, Portrait Avatar",
        "6 themes: Nature, Strength, Wisdom, Beauty, Freedom, Passion",
        "4 dynasty styles: Song, Tang, Ming, Modern",
        "200+ taboo character filter",
        "Full Python SDK with prompts.py library"
      ]
    }
  ]
}


Security scan verdicts — ClawScan: suspicious | static analysis: suspicious | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)