{"id":50725849,"url":"https://github.com/helloruru/claude-zhenhuan","last_synced_at":"2026-06-10T04:01:21.978Z","repository":{"id":342794117,"uuid":"1175009133","full_name":"HelloRuru/claude-zhenhuan","owner":"HelloRuru","description":"甄嬛傳模式 Claude Code Skill | Empresses in the Palace roleplay for Claude Code","archived":false,"fork":false,"pushed_at":"2026-03-07T11:38:54.000Z","size":49,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-07T18:08:02.173Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HelloRuru.png","metadata":{"files":{"readme":"README.en.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-QUOTES.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-07T05:19:18.000Z","updated_at":"2026-03-07T11:38:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/HelloRuru/claude-zhenhuan","commit_stats":null,"previous_names":["helloruru/claude-zhenhuan"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/HelloRuru/claude-zhenhuan","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HelloRuru%2Fclaude-zhenhuan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HelloRuru%2Fclaude-zhenhuan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HelloRuru%2Fclaude-zhenhuan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HelloRuru%2Fclaude-zhenhuan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HelloRuru","download_url":"https://codeload.github.com/HelloRuru/claude-zhenhuan/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HelloRuru%2Fclaude-zhenhuan/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34136112,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-10T04:01:20.913Z","updated_at":"2026-06-10T04:01:21.966Z","avatar_url":"https://github.com/HelloRuru.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n[繁體中文](./README.md) | **English**\n\n# claude-zhenhuan\n\nYou're in the middle of coding, and Claude suddenly says: \"Your Ladyship, please don't worry. Allow this humble servant to investigate carefully.\"\n\nIt's not a bug. It's ***Zhen Huan Mode*** (甄嬛傳模式).\n\n![Claude Code](https://img.shields.io/badge/Claude_Code-Skill-D4A5A5?style=flat-square\u0026logo=anthropic\u0026logoColor=white)\n![Characters](https://img.shields.io/badge/Characters-5-B8A9C9?style=flat-square)\n![Quotes](https://img.shields.io/badge/Quotes-161-A8B5A0?style=flat-square)\n![Drama](https://img.shields.io/badge/Empresses_in_the_Palace-2011-E8B4B8?style=flat-square)\n\n\u003c/div\u003e\n\n---\n\n## :link: What is this?\n\nA [Claude Code](https://docs.anthropic.com/en/docs/claude-code) Skill that transforms Claude into a character from *\"Empresses in the Palace\"* (後宮甄嬛傳), one of the most iconic Chinese historical TV dramas.\n\nType `/qing`, and Claude becomes your personal palace attendant — maybe the bold and loyal Liuzhu (流朱), the brilliant strategist Jinxi (槿汐), the well-connected eunuch Su Peisheng (蘇培盛), the gentle physician Wen Shichu (溫實初), or the sharp-minded Huanbi (浣碧). Each activation rolls a random character with unique personality, mood, and palace gossip.\n\nYour code stays precise. You just get a more entertaining companion.\n\nWhen debugging, the character says \"Your Ladyship, please stay calm.\" When deployment succeeds: \"It has been announced to the Six Palaces.\" When you hit a Git conflict: \"Two forces meet on a narrow road — allow me to mediate.\"\n\n**v2.1 New**: stderr Palace Easter Egg — when a command fails, a drama quote fires automatically, scaled by severity. Summon the Imperial Physician!\n\n## :brain: What does it look like?\n\n```text\n/qing\n```\n\nClaude responds with something like:\n\n\u003e Greetings, Your Ladyship! This humble servant Liuzhu pays her respects.\n\u003e The palace is peaceful today, the mood is light.\n\u003e I heard the Imperial Kitchen just got your favorite osmanthus wine — perfect for after we finish today's work.\n\u003e\n\u003e \"Shoot the horse before the rider, capture the king before the soldiers.\" — Whatever you need, just say the word!\n\nThen you code as usual. The character stays in role throughout, but technical quality never drops.\n\n## :wrench: Installation\n\nRequires [jq](https://jqlang.github.io/jq/) (JSON processing tool):\n\n\u003cdetails\u003e\n\u003csummary\u003eInstall jq (per platform)\u003c/summary\u003e\n\n```bash\n# macOS\nbrew install jq\n\n# Linux\nsudo apt install jq\n\n# Windows\nwinget install jqlang.jq\n```\n\n\u003c/details\u003e\n\nThen:\n\n```bash\ngit clone https://github.com/HelloRuru/claude-zhenhuan.git\ncd claude-zhenhuan\nbash install.sh\n```\n\nThis creates four slash commands:\n\n| Command          | Function                |\n| :--------------- | :---------------------- |\n| `/我是小主`      | Enter character mode    |\n| `/我不是小主`    | Exit character mode     |\n| `/qing`          | Enter (English alias)   |\n| `/qing-off`      | Exit (English alias)    |\n\n## :detective: What's inside\n\n- **5 playable characters**: Liuzhu (流朱, bold), Huanbi (浣碧, perceptive), Jinxi (槿汐, strategist), Su Peisheng (蘇培盛, intel), Wen Shichu (溫實初, gentle)\n- **161 quotes**: Spanning 29 characters from the drama\n- **stderr Palace Easter Egg**: Bash errors auto-trigger drama quotes, tiered by severity (breeze vs. emperor's demise)\n- **8-character core relationship map**: Zhen Huan (甄嬛), Consort Hua (華妃), An Lingrong (安陵容), Prince Guo (果郡王), Liuzhu (流朱), Su Peisheng (蘇培盛), Jinxi (槿汐), Wen Shichu (溫實初)\n- **Contextual callbacks**: The character remembers what you did earlier in the conversation and weaves it back naturally\n\n\u003cdetails\u003e\n\u003csummary\u003eFile structure\u003c/summary\u003e\n\n```\nclaude-zhenhuan/\n├── README.md             ← Chinese version\n├── README.en.md          ← This file (English)\n├── SKILL.md              ← Skill config \u0026 behavior rules\n├── quotes.json           ← Quote database (single source of truth)\n├── quotes.md             ← Human-readable quote list (auto-generated)\n├── roll.sh               ← Dice roll script for random character\n├── gen-quotes-md.sh      ← Generate quotes.md from quotes.json\n├── install.sh            ← Global install / uninstall script\n├── characters-full.md    ← 21 non-core character relationships\n├── LICENSE-QUOTES.md     ← Copyright \u0026 fair use notice\n└── hooks/\n    └── zhenhuan-stderr.js ← stderr Palace Easter Egg hook\n```\n\n\u003c/details\u003e\n\n## :bulb: Adding quotes\n\nAll quotes live in `quotes.json` — the single source of truth.\n\n```bash\n# After editing quotes.json, regenerate the markdown version\nbash gen-quotes-md.sh \u003e quotes.md\n```\n\n## :wrench: Update / Uninstall\n\n```bash\n# Update (symlink points to latest automatically)\ncd claude-zhenhuan \u0026\u0026 git pull\n\n# Uninstall\nbash install.sh remove\n```\n\n## :pray: Inspiration \u0026 Credits\n\nThis Skill didn't start from scratch.\n\n### Original Skill concept\n\nInspired by [htlin222](https://github.com/htlin222)'s open-source project [htlin222/dotfiles](https://github.com/htlin222/dotfiles) (path: [claude.symlink/skills/qing](https://github.com/htlin222/dotfiles/tree/main/claude.symlink/skills/qing)).\n\nThe original was a generic Qing Dynasty palace roleplay (eunuch, minister, maid, empress), which introduced the core idea of activating a palace character via slash command + roll.sh dice roll. Inspired by this concept, I independently rewrote all code and content — adapting characters and quotes to *\"Empresses in the Palace\"* (後宮甄嬛傳), and adding interaction mechanisms, a core relationship map, distinct character voices, and other v2.0 features. Without htlin222's creativity and open-source sharing, this project would not exist.\n\n### Quote sources\n\nQuotes in `quotes.json` were compiled from these public resources:\n\n- [Ariel Hsu](https://arielhsu.tw/empresses-in-the-palace-quotes/)\n- [ETtoday](https://star.ettoday.net/news/2415056)\n- [BEAUTY321](https://www.beauty321.com/post/27834)\n- [BEAUTY321](https://www.beauty321.com/post/46430)\n- [KKNews](https://kknews.cc/zh-tw/culture/389lpr3.html)\n- [Tatler Asia](https://www.tatlerasia.com/lifestyle/entertainment/empresses-in-the-palace-zh-hant)\n\n### Original novel \u0026 TV drama\n\n- **Novel**: *\"Legend of Zhen Huan\"* (後宮·甄嬛傳) by Liu Lianzi (流瀲紫, pen name of Wu Xuelan), originally serialized on JJWXC\n- **TV Drama**: *\"Empresses in the Palace\"* (後宮甄嬛傳, 2011), directed by Zheng Xiaolong, written by Liu Lianzi \u0026 Wang Xiaoping, produced by Beijing Television Art Center\n\n### Tools\n\n- [jq](https://jqlang.github.io/jq/) — Used by the character roll script to process JSON data\n\n## :classical_building: Copyright \u0026 Legal\n\n\u003cdetails\u003e\n\u003csummary\u003eExpand full legal notice\u003c/summary\u003e\n\n### Intellectual property\n\nAll dialogue, character names, and story elements from the TV drama *\"Empresses in the Palace\"* (後宮甄嬛傳) and the novel *\"Legend of Zhen Huan\"* (後宮·甄嬛傳) are the intellectual property of their respective rights holders, including but not limited to:\n\n- Author Liu Lianzi (流瀲紫 / Wu Xuelan)\n- Director Zheng Xiaolong\n- Beijing Television Art Center\n- Erhai Film \u0026 Television Culture Communication Co.\n\n### Fair use\n\nQuotes included in this project are used solely for **personal learning, research, and non-commercial purposes** under fair use principles (and Article 52/65 of the R.O.C. Copyright Act):\n\n- **Purpose**: Non-profit, educational, and personal entertainment — adding personality to an AI coding assistant\n- **Amount**: Only a small selection of representative quotes (161 lines), not a complete script or work\n- **Market impact**: Does not substitute the viewing experience of the original work, nor affect its commercial value\n\n### Non-commercial\n\nThis project **does not claim** any rights over the quoted dialogue, and **does not generate revenue** in any form.\n\n### Contact for takedown\n\nIf rights holders believe any content in this project constitutes infringement, please reach out via [GitHub Issues](https://github.com/HelloRuru/claude-zhenhuan/issues) or Email (hello@helloruru.com). Infringing content will be removed immediately.\n\n### Original Skill\n\nThis project was inspired by [htlin222/dotfiles](https://github.com/htlin222/dotfiles). All code and content were independently rewritten, not directly copied from the original.\n\nSee [LICENSE-QUOTES.md](./LICENSE-QUOTES.md) for details.\n\n\u003c/details\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\nby [HelloRuru](https://ohruru.com) | Coding can be fun\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelloruru%2Fclaude-zhenhuan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhelloruru%2Fclaude-zhenhuan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelloruru%2Fclaude-zhenhuan/lists"}