humanizer-th 0.0.0-stage → 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 inatbalthazar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,176 @@
+# humanizer-th
+
+![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg) ![version](https://img.shields.io/badge/version-0.5.0-green.svg)
+
+A set of Thai-language [Agent Skills](https://agentskills.io). Translate subtitles, games, apps and websites into Thai that doesn't read like a translation, write and polish dialogue for AI-generated short dramas and Thai AI voice-over, and edit AI-written Thai so it reads like a native writer wrote it.
+
+Works with Claude, ChatGPT, Gemini, Codex, GitHub Copilot, Cursor and any tool that supports Agent Skills. Tools without skill support can use a single bundled prompt file instead.
+
+[อ่านภาษาไทย](README.md)
+
+## The skills
+
+| Skill | What it does | Example request |
+|---|---|---|
+| **localize-th** | English to Thai for subtitles, dubbing scripts, app and website strings, and games | "แปลซับนี้เป็นไทย" / "Translate this strings file into Thai" |
+| **script-th** | Writes and polishes Thai dialogue for AI short dramas, per-shot video prompts, and TTS-ready voice scripts | "เขียนบทละครสั้นเรื่อง..." / "Polish this script" |
+| **humanizer-th** | Edits AI-written Thai posts, emails and chat messages, and writes in the user's own voice from samples of their past writing | "เกลาให้หน่อย" / "เขียนให้เหมือนที่เราเขียน" |
+
+Install once and the agent picks the right skill for each request.
+
+```bash
+npx humanizer-th
+```
+
+No terminal, or using ChatGPT or Gemini? See [Install](#install).
+
+## If you don't read Thai
+
+- **Ask in English.** The Thai output stays Thai, and everything that explains it (translation notes, change summaries, questions) comes back in English. Thai words quoted in the notes get their meaning in brackets.
+- **Back-translations.** For short jobs, up to about 30 lines, subtitle blocks or strings, the agent adds a table that says in plain English what the Thai actually says, so you can check the meaning. For longer files, ask for one. Back-translations never go into the translated file.
+- **Example:** [game menu strings for a developer who doesn't read Thai](examples/localize-th/04-english-speaker.md).
+- **Still get a native review.** Have a Thai speaker read anything you publish.
+
+## localize-th: subtitles, games, apps and websites
+
+| Source | Typical machine translation | localize-th |
+|---|---|---|
+| Oh no. (subtitle) | โอ้ไม่ ("oh no", literal) | ซวยแล้ว ("I'm in trouble") |
+| Payment failed. (app) | การชำระเงินล้มเหลว ("the payment has failed") | ชำระเงินไม่สำเร็จ ("payment didn't go through") |
+| Your cart (app) | ตะกร้าของคุณ ("your cart") | ตะกร้า ("cart"; Thai UI drops "your") |
+| No haggling, my back can't take it. (game) | literal joke that falls flat | ห้ามต่อนะ ข้าแก่แล้ว เถียงไม่ไหว ("no haggling, I'm too old to argue") |
+
+- **Files stay valid:** subtitle timings and block numbers, keys, placeholders (`{name}`, `%s`, `[PlayerName]`, ICU plurals) and tags are kept exactly.
+- **Readable subtitles:** at most 35 characters per line, 2 lines, about 20 characters per second, line breaks on word boundaries (Thai has no spaces between words). The defaults follow Netflix's Thai timed-text guide and can be overridden.
+- **Characters sound like people:** pronouns and particles are chosen per relationship and kept consistent. English "I" and "you" have a dozen Thai equivalents.
+- **Consistent terms:** follows your glossary, or a built-in glossary of standard Thai UI and game terms with Royal Institute spellings.
+- **Checker script:** `skills/localize-th/scripts/check_translation.py` compares a translation with its source (SRT, VTT, ASS, JSON, ARB, PO, XLIFF, `.strings`, Android XML, CSV) and reports broken timings, missing keys or placeholders, long lines and reading speed. Agents that can run commands run it themselves.
+
+```bash
+python3 skills/localize-th/scripts/check_translation.py en.srt th.srt
+```
+
+Examples: [SRT subtitles](examples/localize-th/01-subtitle-srt.md), [app JSON](examples/localize-th/02-app-ui-json.md), [game CSV](examples/localize-th/03-game-dialogue-csv.md), [for a developer who doesn't read Thai](examples/localize-th/04-english-speaker.md).
+
+## script-th: AI short dramas and Thai voice-over
+
+Four modes: write a script from an idea, polish an existing script without changing the story, turn it into per-shot prompts for AI video tools, and prepare a voice script that Thai TTS reads correctly (numbers as words, unambiguous spellings, pauses and voice direction).
+
+- Character sheets with fixed English visual descriptions, copied verbatim into every shot prompt for consistency.
+- Lines sized to the clip length using a syllable estimate, with long lines split across shots.
+- Twelve AI-dialogue tells (SC01–SC12), such as characters naming their feelings, exposition dumps, stock lines from short dramas and everyone sounding the same.
+- Three ways to add Thai speech (native audio from the video model, separate TTS with lip-sync, or narration and subtitles), because many video models still speak Thai poorly.
+
+Examples: [write from an idea](examples/script-th/01-write-short-drama.md), [polish an AI script](examples/script-th/02-polish-ai-script.md), [shot prompts and voice script](examples/script-th/03-shot-prompts-and-voice.md).
+
+## humanizer-th: AI-written Thai
+
+Four modes (ตรวจ check, เขียนใหม่ rewrite, แก้เฉพาะจุด fix spots, เลียนสไตล์ match style) across the four registers taught in Thai schools: กันเอง (intimate), ไม่เป็นทางการ (informal), กึ่งทางการ (semi-formal) and ทางการ (formal). It checks 29 patterns (TH01–TH29), most of which Thai grammar classes call ประโยคฟุ่มเฟือย (redundant sentences) and สำนวนต่างประเทศ (foreign-style phrasing). See [patterns.md](shared/patterns.md) and [examples/humanizer-th/](examples/humanizer-th/).
+
+### Writing in your own voice (เลียนสไตล์)
+
+Natural Thai is not the same as your Thai. Send three or more pieces you wrote yourself, plus an AI draft or just a brief, and the skill builds a style profile: what you call yourself, where you put `ครับ`/`ค่ะ`, how often you break lines, how you open and close, how you write times and prices. It then writes the new text that way.
+
+- Content comes only from the draft or brief. Nothing is lifted from the samples, and nothing is invented to fit the style; the skill asks instead.
+- It copies habits only as often as they appear in the samples, never copies misspellings, and never copies translationese like `ได้ทำการ` even if the writer uses it.
+- The profile can be saved and pasted next time instead of the samples.
+- The same profile method works in `localize-th` (continue a translation in the style of earlier episodes or app versions) and `script-th` (write a new episode in the style of earlier ones).
+
+Full example with the profile: [examples/humanizer-th/07-match-style.md](examples/humanizer-th/07-match-style.md).
+
+### Why English humanizers don't work for Thai
+
+- **Grammar:** Thai has no tense or articles, drops subjects freely, and marks politeness with particles. Translated Thai shows up as `ได้ทำการ`, `ถูก...โดย` (passive) and `ซึ่ง...ซึ่ง...` chains, not as "delve" or "tapestry".
+- **Register:** readers notice the wrong register immediately, such as government-letter Thai in a LINE message.
+- **Particles and pronouns:** `ครับ`/`ค่ะ` carry the writer's gender. Putting one on every sentence, or mixing them, is a tell, and so is overusing `คุณ` ("you").
+- **Punctuation:** Thai separates phrases with spaces, not commas and full stops. English punctuation, emoji and "!" are tells.
+
+**None of the skills change** facts, numbers, dates, names, brands, links, code or the writer's `ครับ`/`ค่ะ`, and none add information that isn't in the source.
+
+## Install
+
+### One command
+
+Open Terminal (Mac) or PowerShell (Windows) and run
+
+```bash
+npx humanizer-th
+```
+
+It installs all three skills for Claude Code, Codex, Gemini CLI and GitHub Copilot, whichever you have. Restart your tool once, then just ask.
+
+- Needs Node.js 18 or later, from [nodejs.org](https://nodejs.org). Most Claude Code and Codex users already have it.
+- If it asks `Ok to proceed?`, press `y`.
+- Update with `npx humanizer-th@latest`, remove with `npx humanizer-th uninstall`, pick one skill with `--skill localize-th`, or install into the current project only with `--project`.
+
+### Without a terminal
+
+**Claude.ai and Claude Desktop:** download the zip for each skill you want from [Releases](https://github.com/inatbalthazar/humanizer-th/releases/latest) (`localize-th.zip`, `script-th.zip`, `humanizer-th.zip`) and upload them one at a time under Settings → Capabilities → Skills.
+
+**ChatGPT, Gemini and other AI tools:** download the bundled prompt for each skill from [Releases](https://github.com/inatbalthazar/humanizer-th/releases/latest) (`localize-th-prompt.md`, `script-th-prompt.md`, `humanizer-th-prompt.md`):
+
+- **ChatGPT:** one GPT per skill. Upload the file under Knowledge and set Instructions to "Follow every instruction in [file name]." (Instructions is capped at 8,000 characters, too short for the whole file).
+- **Gemini:** create a Gem and paste the whole file into its instructions, or attach it.
+- **API:** use the whole file as the system prompt.
+- **Any chat:** attach the file and ask the model to follow it.
+
+The bundles are 59,000 to 94,000 characters. Thai uses more tokens than English, so sending one on every API call adds up.
+
+<details>
+<summary><strong>Other ways</strong> (Claude Code plugin, Skills CLI, no Node.js, manual)</summary>
+
+**Claude Code plugin:** run inside Claude Code
+
+```text
+/plugin marketplace add inatbalthazar/humanizer-th
+/plugin install humanizer-th@humanizer-th
+```
+
+**Skills CLI:** installs for every agent the [Skills CLI](https://github.com/vercel-labs/skills) supports, including Cursor and Windsurf
+
+```bash
+npx skills add inatbalthazar/humanizer-th --global --agent '*'
+```
+
+**No Node.js (macOS or Linux):**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/inatbalthazar/humanizer-th/main/install.sh | bash
+```
+
+Use `| bash -s -- --skill localize-th` for one skill and `| bash -s -- --uninstall` to remove them.
+
+**Manual:** copy the folders in `skills/` into the agent's skills folder
+
+| Tool | All projects | One project |
+|---|---|---|
+| Claude Code | `~/.claude/skills/` | `.claude/skills/` |
+| Codex CLI | `~/.agents/skills/` | `.agents/skills/` |
+| Gemini CLI | `~/.gemini/skills/` | `.gemini/skills/` |
+| GitHub Copilot in VS Code | `~/.copilot/skills/` | `.github/skills/` |
+
+Agents not in the table mostly read `.agents/skills/`. To build the zips and prompt bundles from source, run `bash scripts/build.sh`; output goes to `dist/`.
+
+</details>
+
+## What this is not
+
+- **Not an AI-detector evasion tool.** The goal is text that is easier for Thai readers, and the skills never insert deliberate mistakes.
+- **No writing as someone else.** Style matching is for your own writing, or ghostwriting the person knows about (a page admin posting for the shop owner). It won't fake messages from other people.
+- **No scripts that put words in real people's mouths** for AI video, unless the user is that person or has permission, and no deceptive content such as fake news or scam clips.
+- **English source only** for translation for now.
+
+## Limitations
+
+- The skills are guidance the model follows, not deterministic programs. Review the output, and have a native Thai reader check translations before publishing.
+- Tested in depth with Claude only. Results with other models depend on how well they handle Thai.
+- Shot prompts and voice scripts have not yet been run through real video and TTS tools. The syllables-per-second figure is an estimate to calibrate on the first shot. See [tests/manual-test-v0.3.md](tests/manual-test-v0.3.md).
+- Style matching has been tested on one made-up set of samples, not yet on real writers' work. See [tests/manual-test-v0.4.md](tests/manual-test-v0.4.md).
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+[MIT](LICENSE)

package/README.md

@@ -1,3 +1,228 @@
-# Temporary Holding Version
+# humanizer-th
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg) ![version](https://img.shields.io/badge/version-0.5.0-green.svg)
+
+ชุด skill ภาษาไทยสำหรับ AI แปลซับหนัง เกม แอป และเว็บไซต์เป็นภาษาไทยที่อ่านแล้วไม่รู้ว่าแปลมา เขียนบทละครสั้นและบทพากย์สำหรับวิดีโอ AI และเกลาข้อความที่ AI เขียนให้อ่านเหมือนคนไทยเขียนเอง
+
+ใช้ได้กับ Claude, ChatGPT, Gemini, Codex, GitHub Copilot, Cursor และ AI ตัวอื่นที่รองรับ [Agent Skills](https://agentskills.io) ตัวที่ไม่รองรับก็ใช้ได้ โดยวางไฟล์รวมเป็นคำสั่งแทน
+
+[English](README.en.md)
+
+## มีอะไรบ้าง
+
+| skill | ใช้ทำอะไร | พิมพ์ประมาณนี้ |
+|---|---|---|
+| **localize-th** | แปลภาษาอังกฤษเป็นไทย ทั้งซับไตเติล บทพากย์ ข้อความในแอปและเว็บไซต์ และเกม | "แปลซับนี้เป็นไทย" "แปลไฟล์ภาษาของแอปนี้" |
+| **script-th** | เขียนและเกลาบทละครสั้นที่สร้างด้วย AI ทำพรอมต์ทีละช็อต และเตรียมบทให้ AI พากย์เสียงไทย | "เขียนบทละครสั้นเรื่อง..." "เกลาบทนี้ให้หน่อย" |
+| **humanizer-th** | เกลาข้อความไทยที่ AI เขียน เช่น โพสต์ อีเมล ข้อความ LINE และเขียนให้เป็นสำนวนของเราเองจากงานเก่าที่ส่งให้ดู | "เกลาให้หน่อย" "เขียนให้เหมือนที่เราเขียน" |
+
+ติดตั้งครั้งเดียวได้ทั้งสามตัว AI จะเลือกใช้ตัวที่ตรงกับคำสั่งเอง
+
+```bash
+npx humanizer-th
+```
+
+ไม่ใช้ terminal หรือใช้ ChatGPT กับ Gemini ดูหัวข้อ[ติดตั้ง](#ติดตั้ง)
+
+**ผู้ใช้ที่อ่านไทยไม่ออก** สั่งเป็นภาษาอังกฤษได้ งานที่ได้ยังเป็นภาษาไทย แต่บันทึกและคำอธิบายจะเป็นภาษาอังกฤษ งานสั้นจะมีคำแปลกลับเป็นภาษาอังกฤษให้ตรวจความหมายด้วย เหมาะกับบริษัทเกมและแอปต่างชาติที่จะออกเวอร์ชันไทย ดู[ตัวอย่าง](examples/localize-th/04-english-speaker.md) และ [README ภาษาอังกฤษ](README.en.md)
+
+## แปลซับ เกม แอป และเว็บไซต์ (localize-th)
+
+งานแปลส่วนใหญ่ที่ได้จาก AI ถูกทุกคำแต่คนไทยอ่านแล้วรู้ทันทีว่าแปลมา และบางครั้งทำไฟล์พังด้วย เช่น เวลาในซับเลื่อน หรือตัวแปรในแอปหาย
+
+| ต้นฉบับ | แปลแบบทั่วไป | localize-th |
+|---|---|---|
+| Oh no. (ซับ) | โอ้ไม่ | ซวยแล้ว |
+| What do you think? (ซับ) | คุณคิดว่าอย่างไร | คิดว่าไงล่ะ |
+| Payment failed. (แอป) | การชำระเงินล้มเหลว | ชำระเงินไม่สำเร็จ |
+| Your cart (แอป) | ตะกร้าของคุณ | ตะกร้า |
+| No haggling, my back can't take it. (เกม) | ห้ามต่อรอง หลังของฉันรับไม่ไหว | ห้ามต่อนะ ข้าแก่แล้ว เถียงไม่ไหว |
+
+**สิ่งที่ skill คุมให้**
+
+- **ไฟล์ไม่พัง:** เวลาและเลขบล็อกในซับ key ตัวแปรอย่าง `{name}` `%s` `[PlayerName]` และแท็กต่างๆ อยู่ครบเหมือนต้นฉบับ
+- **ซับอ่านทัน:** บรรทัดละไม่เกิน 35 ตัวอักษร ไม่เกิน 2 บรรทัด ความเร็วการอ่านไม่เกิน 20 ตัวอักษรต่อวินาที และตัดบรรทัดที่ขอบคำ ตามแนวทางซับไทยของ Netflix เปลี่ยนตัวเลขได้ถ้ามี style guide ของตัวเอง
+- **ตัวละครพูดเหมือนคน:** เลือกสรรพนามและคำลงท้ายตามความสัมพันธ์ เช่น พี่น้องใช้ "พี่" กับ "แก" เกมแฟนตาซีใช้ "ข้า" กับ "เจ้า" และใช้แบบเดียวกันตลอดเรื่อง
+- **ศัพท์ตรงกันทั้งงาน:** ใช้อภิธานศัพท์ของผู้ใช้ ถ้าไม่มีก็ใช้คำมาตรฐานที่คนไทยเห็นในแอปทั่วไป และสะกดคำทับศัพท์ตามราชบัณฑิตยสถาน
+- **บทพากย์:** ความยาวที่พูดใกล้ต้นฉบับ และเขียนให้อ่านออกเสียงได้ทันที
+
+**ไฟล์ที่รองรับ:** SRT, VTT, ASS, JSON, ARB, PO, XLIFF, iOS `.strings` `.stringsdict` `.xcstrings`, Android `strings.xml`, YAML, CSV และข้อความที่วางมาในแชต
+
+**ตรวจไฟล์ด้วยสคริปต์:** ใน skill มี `check_translation.py` เทียบไฟล์ที่แปลกับต้นฉบับ แจ้งเวลาที่เปลี่ยน key หรือตัวแปรที่หาย บรรทัดซับที่ยาวเกิน และความเร็วการอ่านที่เกิน AI ที่รันคำสั่งได้ (เช่น Claude Code, Codex) จะรันให้เอง หรือจะรันเองก็ได้
+
+```bash
+python3 skills/localize-th/scripts/check_translation.py en.srt th.srt
+```
+
+ตัวอย่างเต็ม: [ซับ SRT](examples/localize-th/01-subtitle-srt.md) / [แอป JSON](examples/localize-th/02-app-ui-json.md) / [เกม CSV](examples/localize-th/03-game-dialogue-csv.md) / [เมนูเกมสำหรับคนที่อ่านไทยไม่ออก](examples/localize-th/04-english-speaker.md)
+
+## บทละครสั้น AI และบทพากย์ (script-th)
+
+ใช้กับละครสั้นแนวตั้งที่สร้างด้วยเว็บสร้างวิดีโอ AI และงานที่ให้ AI พากย์เสียงไทย
+
+**ก่อน** (บทที่ AI เขียน)
+
+```text
+นิว: ต้น ฉันรู้สึกผิดหวังและเสียใจมากที่คุณโกหกฉันเรื่องที่คุณไปเชียงใหม่
+ต้น: นิว ผมขอโทษครับ ผมไม่ได้มีเจตนาที่จะทำให้คุณรู้สึกแย่ ซึ่งผมมีเหตุผลที่ผมไม่สามารถบอกคุณได้ในตอนนี้ครับ
+```
+
+**หลัง**
+
+```text
+นิว: เชียงใหม่สนุกมั้ย
+ต้น: (ชะงัก) ขอโทษ มีเหตุผลจริงๆ แต่ตอนนี้ยังบอกไม่ได้
+```
+
+**สั่งได้ 4 แบบ**
+
+| แบบ | ได้อะไร |
+|---|---|
+| เขียนบท | ตารางตัวละคร บทแบ่งฉาก เปิดเรื่องให้ดึงคนดูใน 3 วินาที จบตอนแบบค้างให้อยากดูต่อ |
+| เกลาบท | บทเดิมที่พูดเหมือนคนจริงขึ้น เรื่องและข้อมูลไม่เปลี่ยน |
+| ทำพรอมต์ | พรอมต์ทีละช็อตที่คัดลอกไปวางได้ทันที บทพูดยาวพอดีคลิป หน้าตาตัวละครเหมือนกันทุกช็อต |
+| เตรียมบทพากย์ | บทที่เสียง AI อ่านถูก ตัวเลขเขียนเป็นคำ คำอ่านยากเขียนตามเสียง มีทิศทางเสียงทุกบรรทัด |
+
+skill จะถามว่าจะใส่เสียงแบบไหน ให้โมเดลวิดีโอพูดเอง ใช้เสียง AI แยกแล้วทำลิปซิงก์ หรือใช้เสียงบรรยายกับซับ เพราะเว็บสร้างวิดีโอหลายตัวยังพูดภาษาไทยได้ไม่ดี
+
+ตัวอย่างเต็ม: [เขียนบทจากไอเดีย](examples/script-th/01-write-short-drama.md) / [เกลาบทที่ AI เขียน](examples/script-th/02-polish-ai-script.md) / [พรอมต์และบทพากย์](examples/script-th/03-shot-prompts-and-voice.md)
+
+## เกลาข้อความที่ AI เขียน (humanizer-th)
+
+ข้อความ LINE ขอให้รุ่นพี่ที่ทำงานเข้ากะแทน
+
+**ก่อน**
+
+> สวัสดีครับพี่เมย์ ผมหวังว่าพี่จะสบายดีนะครับ ผมต้องการที่จะขอความช่วยเหลือจากพี่ในเรื่องหนึ่งครับ เนื่องจากในวันเสาร์ที่ 7 นี้ ผมมีความจำเป็นต้องเดินทางกลับต่างจังหวัดเพื่อไปร่วมงานบวชของน้องชาย ดังนั้น ผมจึงอยากสอบถามว่าพี่จะสามารถช่วยเข้ากะแทนผมในช่วงเวลา 13.00–21.00 น. ได้หรือไม่ครับ ทั้งนี้ ผมยินดีที่จะเข้ากะแทนพี่ในวันอื่นเป็นการตอบแทนครับ ขอบคุณพี่มากๆ สำหรับการพิจารณาครับ 🙏
+
+**หลัง**
+
+> พี่เมย์ครับ ขอรบกวนหน่อย เสาร์ที่ 7 นี้ผมต้องกลับต่างจังหวัดไปงานบวชน้องชาย พี่พอจะเข้ากะแทนผมช่วง 13.00–21.00 น. ได้ไหมครับ เดี๋ยวผมเข้ากะแทนพี่วันอื่นคืนให้ ขอบคุณมากครับ
+
+สั่งได้ 4 แบบ คือ **ตรวจ** (บอกว่าตรงไหนดูเป็น AI ยังไม่แก้) **เขียนใหม่** (เกลาทั้งชิ้น) **แก้เฉพาะจุด** (แก้แค่คำที่แข็ง) และ **เลียนสไตล์** (เขียนให้เป็นสำนวนของเราเอง ดูหัวข้อถัดไป) และเลือกระดับภาษาตามที่เรียนในวิชาภาษาไทย คือ กันเอง ไม่เป็นทางการ กึ่งทางการ และทางการ
+
+ตรวจ 29 รูปแบบ ส่วนใหญ่คือสิ่งที่วิชาภาษาไทยเรียกว่า**ประโยคฟุ่มเฟือย**กับ**สำนวนต่างประเทศ** เช่น "ได้ทำการ" "ถูกพัฒนาโดย" "ทำให้แน่ใจว่า" ที่เหลือเป็นนิสัยของแชตบอต เช่น อีโมจิท้ายข้อความ ดูรายละเอียดใน [patterns.md](shared/patterns.md) และตัวอย่างอื่นใน [examples/humanizer-th/](examples/humanizer-th/)
+
+### เขียนให้เป็นสำนวนของเราเอง (เลียนสไตล์)
+
+ข้อความที่เกลาแล้วอาจเป็นธรรมชาติ แต่ยังไม่ใช่เสียงของเรา คนที่อ่านโพสต์เราทุกวันอ่านแล้วรู้สึกว่าไม่ใช่เรา โหมดนี้มีไว้แก้เรื่องนั้น ส่งงานเก่าของตัวเองมา 3 ชิ้นขึ้นไป พร้อมร่างที่ AI เขียน หรือแค่บอกว่าจะเขียนเรื่องอะไร skill จะดูว่าเราเรียกตัวเองว่าอะไร ใส่ "ครับ" ตรงไหน ขึ้นบรรทัดใหม่บ่อยแค่ไหน ชอบเปิดและปิดยังไง เขียนเวลาและราคาแบบไหน แล้วเขียนตามนั้น
+
+**ร่างจาก AI**
+
+```text
+📢 ประกาศสำคัญจากทางร้าน 📢
+
+เรียนลูกค้าทุกท่าน ทางร้านขอแจ้งให้ทราบว่า ร้านจะปิดให้บริการเป็นการชั่วคราวในวันจันทร์ที่ 14 และวันอังคารที่ 15 นี้ เนื่องจากเจ้าของร้านจะเดินทางไปเข้าร่วมการอบรมการคั่วกาแฟที่จังหวัดเชียงราย ...
+```
+
+**หลังเลียนสไตล์จากโพสต์เก่า 3 ชิ้นของเจ้าของร้าน**
+
+```text
+จันทร์ที่ 14 กับอังคารที่ 15 นี้ร้านปิดนะ
+ผมไปเรียนคั่วกาแฟที่เชียงราย
+กลับมาจะได้คั่วให้ดีกว่าเดิม
+
+ช่วงที่ร้านปิด ใครจะสั่งเมล็ดทักแชตเพจได้ตามปกติ
+เดี๋ยวผมส่งให้วันพุธ
+
+ขอโทษที่ต้องปิดไปสองวัน ขอบคุณที่แวะมากันตลอด
+พุธที่ 16 เปิดตามเดิม 8 โมงถึงบ่าย 3 ครับ
+```
+
+- **เนื้อหามาจากร่างหรือโจทย์เท่านั้น** ไม่หยิบเรื่องจากงานเก่ามาใส่ และไม่แต่งเรื่องเพิ่มให้เหมือนสไตล์ ถ้าสไตล์ต้องใช้ข้อมูลที่ไม่มี จะถามแทน
+- **เลียนเท่าที่เห็นจริง** ใช้คำติดปากถี่เท่างานเก่า ไม่ลอกคำที่สะกดผิด และไม่เลียนสำนวนแปลอย่าง "ได้ทำการ" แม้เราจะใช้ประจำ
+- **เก็บโปรไฟล์สำนวนไว้ใช้ครั้งหน้าได้** ครั้งต่อไปวางโปรไฟล์แทนงานเก่า แล้วบอกแค่ว่าจะเขียนอะไร
+- **ใช้กับงานแปลและงานบทได้ด้วย** ส่งซับตอนก่อนหรือข้อความแอปเวอร์ชันเดิมให้ `localize-th` แปลต่อให้เข้ากัน หรือส่งบทตอนก่อนให้ `script-th` เขียนตอนใหม่ในสไตล์เดิม
+
+ตัวอย่างเต็มพร้อมโปรไฟล์: [examples/humanizer-th/07-match-style.md](examples/humanizer-th/07-match-style.md)
+
+**ทั้งสาม skill ไม่แตะ** ตัวเลข วันที่ ราคา ชื่อคน ชื่อแบรนด์ ลิงก์ โค้ด และ "ครับ" "ค่ะ" ของคนเขียน และไม่เติมข้อมูลที่ต้นฉบับไม่มี
+
+## ติดตั้ง
+
+### คำสั่งเดียว
+
+เปิด Terminal (Mac) หรือ PowerShell (Windows) แล้วพิมพ์
+
+```bash
+npx humanizer-th
+```
+
+ติดตั้งทั้งสาม skill ให้ Claude Code, Codex, Gemini CLI และ GitHub Copilot ที่มีในเครื่อง เสร็จแล้วปิดเปิดโปรแกรมใหม่หนึ่งรอบ แล้วพิมพ์สั่งได้เลย
+
+- ต้องมี Node.js 18 ขึ้นไป ถ้ายังไม่มี โหลดได้ที่ [nodejs.org](https://nodejs.org) (ถ้าใช้ Claude Code หรือ Codex อยู่ ส่วนใหญ่มีแล้ว)
+- ถ้าขึ้นว่า `Ok to proceed?` ให้กด `y`
+- อัปเดต `npx humanizer-th@latest` / ลบ `npx humanizer-th uninstall` / เลือกบางตัว `npx humanizer-th --skill localize-th` / ติดตั้งเฉพาะโปรเจกต์ที่เปิดอยู่ `npx humanizer-th --project`
+
+### ไม่ใช้ terminal
+
+**Claude.ai และ Claude Desktop:** โหลดไฟล์ zip ของ skill ที่ต้องการจากหน้า [Releases](https://github.com/inatbalthazar/humanizer-th/releases/latest) (`localize-th.zip` `script-th.zip` `humanizer-th.zip`) แล้วอัปโหลดทีละไฟล์ใน Settings → Capabilities → Skills
+
+**ChatGPT, Gemini และ AI ตัวอื่น:** โหลดไฟล์รวมของ skill ที่ต้องการจากหน้า [Releases](https://github.com/inatbalthazar/humanizer-th/releases/latest) (`localize-th-prompt.md` `script-th-prompt.md` `humanizer-th-prompt.md`) แต่ละไฟล์รวมทุกอย่างของ skill นั้นไว้ในไฟล์เดียว
+
+- **ChatGPT:** สร้าง GPT หนึ่งตัวต่อหนึ่ง skill อัปโหลดไฟล์ในช่อง Knowledge แล้วพิมพ์ในช่อง Instructions ว่า "ทำตามคำสั่งในไฟล์ [ชื่อไฟล์] ทุกข้อ" (ช่อง Instructions รับได้ 8,000 ตัวอักษร วางทั้งไฟล์ไม่พอ)
+- **Gemini:** สร้าง Gem แล้ววางเนื้อหาทั้งไฟล์ในช่องคำสั่ง หรือแนบเป็นไฟล์
+- **เรียกผ่าน API:** ใช้เนื้อหาทั้งไฟล์เป็น system prompt
+- **แชตทั่วไป:** แนบไฟล์ แล้วพิมพ์ว่าให้ทำตามไฟล์นี้
+
+ไฟล์รวมยาว 59,000–94,000 ตัวอักษร ถ้าเรียกผ่าน API ทุกครั้งจะเสียค่า token พอสมควร เพราะภาษาไทยกิน token มากกว่าภาษาอังกฤษ
+
+<details>
+<summary><strong>วิธีอื่น</strong> (plugin ของ Claude Code, skills CLI, เครื่องที่ไม่มี Node.js, ติดตั้งเอง)</summary>
+
+**plugin ของ Claude Code:** พิมพ์ใน Claude Code
+
+```text
+/plugin marketplace add inatbalthazar/humanizer-th
+/plugin install humanizer-th@humanizer-th
+```
+
+**skills CLI:** ติดตั้งให้ทุกเครื่องมือที่ [skills CLI](https://github.com/vercel-labs/skills) รู้จัก รวมถึง Cursor และ Windsurf
+
+```bash
+npx skills add inatbalthazar/humanizer-th --global --agent '*'
+```
+
+**ไม่มี Node.js (Mac หรือ Linux):**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/inatbalthazar/humanizer-th/main/install.sh | bash
+```
+
+ต้องการแค่บางตัว ใช้ `| bash -s -- --skill localize-th` ถ้าจะลบ ใช้ `| bash -s -- --uninstall`
+
+**ติดตั้งเอง:** คัดลอกโฟลเดอร์ใน `skills/` ไปไว้ในโฟลเดอร์ skill ของเครื่องมือที่ใช้
+
+| เครื่องมือ | ใช้กับทุกโปรเจกต์ | ใช้เฉพาะโปรเจกต์ |
+|---|---|---|
+| Claude Code | `~/.claude/skills/` | `.claude/skills/` |
+| Codex CLI | `~/.agents/skills/` | `.agents/skills/` |
+| Gemini CLI | `~/.gemini/skills/` | `.gemini/skills/` |
+| GitHub Copilot ใน VS Code | `~/.copilot/skills/` | `.github/skills/` |
+
+เครื่องมือที่ไม่อยู่ในตาราง ส่วนใหญ่อ่าน `.agents/skills/` ได้ ถ้าจะสร้างไฟล์ zip และไฟล์รวมเองจากโค้ดล่าสุด รัน `bash scripts/build.sh` ไฟล์จะอยู่ในโฟลเดอร์ `dist/`
+
+</details>
+
+## สิ่งที่ไม่ทำ
+
+- **ไม่ได้มีไว้หลบ AI detector** ทำมาให้คนอ่านอ่านง่ายขึ้น และจะไม่แกล้งใส่คำผิดให้ดูเหมือนคนเขียน
+- **ไม่เขียนในนามคนอื่น** โหมดเลียนสไตล์ใช้กับงานของตัวเอง หรืองานที่เขียนแทนโดยเจ้าตัวรู้ เช่น แอดมินเขียนโพสต์ในนามเจ้าของร้าน ไม่ใช้ปลอมข้อความของคนอื่น
+- **ไม่เขียนบทให้คนจริงพูด** เช่น ดารา นักการเมือง เพื่อเอาไปทำวิดีโอ AI เว้นแต่เป็นตัวผู้ใช้เองหรือได้รับอนุญาต และไม่เขียนบทหลอกลวง เช่น ข่าวปลอม คลิปหลอกโอนเงิน
+- **แปลจากภาษาอังกฤษเท่านั้น** ยังไม่มีกฎสำหรับต้นฉบับภาษาอื่น
+
+## ข้อจำกัด
+
+- AI ทำตามคำแนะนำในไฟล์ ไม่ได้รันเป็นโปรแกรม ผลแต่ละครั้งจึงไม่เหมือนกันเป๊ะ ควรอ่านทวนก่อนเอาไปใช้ งานแปลที่จะเผยแพร่ควรมีคนไทยอ่านทวนอีกรอบ
+- ทดสอบกับ Claude เท่านั้น ตัวอื่นใช้กฎชุดเดียวกัน แต่ผลขึ้นกับว่าโมเดลนั้นเก่งภาษาไทยแค่ไหน
+- ยังไม่ได้ลองเอาพรอมต์และบทพากย์ไปใช้กับเว็บสร้างวิดีโอและเสียง AI จริง ตัวเลขพยางค์ต่อวินาทีเป็นค่าประมาณ ให้ลองช็อตแรกแล้วปรับ ดูผลทดสอบใน [tests/manual-test-v0.3.md](tests/manual-test-v0.3.md)
+- โหมดเลียนสไตล์ทดสอบกับตัวอย่างที่แต่งขึ้นชุดเดียว ยังไม่ได้ลองกับงานจริงหลายแบบ ดู [tests/manual-test-v0.4.md](tests/manual-test-v0.4.md)
+- บางรูปแบบเป็นเรื่องรสนิยม ทุกรูปแบบจึงเขียนไว้ด้วยว่าตอนไหนไม่ต้องแก้
+
+## อยากช่วยพัฒนา
+
+ถ้าเจอสำนวนที่ AI ชอบใช้แต่ยังไม่อยู่ในรายการ คำแปลที่ skill เลือกแล้วแปลก หรือบทพูดที่ยังฟังเหมือน AI ดูวิธีเสนอได้ใน [CONTRIBUTING.md](CONTRIBUTING.md)
+
+## สัญญาอนุญาต
+
+MIT ดูรายละเอียดใน [LICENSE](LICENSE)

package/bin/cli.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+// Install the Thai skills (humanizer-th, localize-th, script-th) into every
+// AI tool found on this machine.
+//
+//   npx humanizer-th                      install all three skills
+//   npx humanizer-th --skill localize-th  install one skill (repeatable)
+//   npx humanizer-th --project            install into the current folder only
+//   npx humanizer-th --target DIR         install into DIR/<skill>
+//   npx humanizer-th uninstall            remove the skills
+"use strict";
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+const ALL_SKILLS = ["humanizer-th", "localize-th", "script-th"];
+const SRC = path.join(__dirname, "..", "skills");
+const VERSION = require("../package.json").version;
+
+const HELP = `humanizer-th ${VERSION}
+
+  npx humanizer-th                      ติดตั้งทั้งสาม skill / install all three skills
+  npx humanizer-th --skill localize-th  ติดตั้งบางตัว / install one skill (repeatable)
+  npx humanizer-th --project            ติดตั้งเฉพาะโฟลเดอร์นี้ / this folder only
+  npx humanizer-th --target DIR         ติดตั้งลง DIR / install into DIR
+  npx humanizer-th uninstall            ลบออก / remove
+
+Skills: ${ALL_SKILLS.join(", ")}`;
+
+function fail(message) {
+  console.error(message);
+  process.exit(1);
+}
+
+function parseArgs(argv) {
+  const opts = { command: "install", skills: [], target: "", project: false };
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "install" || arg === "uninstall") opts.command = arg;
+    else if (arg === "--skill") opts.skills.push(argv[++i] || fail("--skill needs a name"));
+    else if (arg === "--target") opts.target = argv[++i] || fail("--target needs a folder");
+    else if (arg === "--project") opts.project = true;
+    else if (arg === "-h" || arg === "--help" || arg === "help") opts.command = "help";
+    else if (arg === "-v" || arg === "--version") opts.command = "version";
+    else fail(`Unknown option: ${arg}\n\n${HELP}`);
+  }
+  if (opts.skills.length === 0) opts.skills = ALL_SKILLS;
+  for (const s of opts.skills) {
+    if (!ALL_SKILLS.includes(s)) fail(`Unknown skill: ${s} (choose from ${ALL_SKILLS.join(", ")})`);
+  }
+  return opts;
+}
+
+// Skill folders to install into, with the tool each one serves.
+// .agents/skills is shared by Codex and other tools that follow the Agent
+// Skills standard, so it is always used. The rest only when the tool exists.
+function destinations(opts) {
+  if (opts.target) return [{ dir: path.resolve(opts.target), tool: opts.target }];
+  if (opts.project) {
+    const cwd = process.cwd();
+    return [
+      { dir: path.join(cwd, ".agents", "skills"), tool: "Codex and others" },
+      { dir: path.join(cwd, ".claude", "skills"), tool: "Claude Code" },
+    ];
+  }
+  const home = os.homedir();
+  const dests = [{ dir: path.join(home, ".agents", "skills"), tool: "Codex and others" }];
+  const optional = [
+    [".claude", "Claude Code"],
+    [".gemini", "Gemini CLI"],
+    [".copilot", "GitHub Copilot"],
+  ];
+  for (const [folder, tool] of optional) {
+    if (fs.existsSync(path.join(home, folder))) dests.push({ dir: path.join(home, folder, "skills"), tool });
+  }
+  return dests;
+}
+
+function install(opts) {
+  for (const s of opts.skills) {
+    if (!fs.existsSync(path.join(SRC, s, "SKILL.md"))) fail(`${s}/SKILL.md is missing from this package`);
+  }
+  const dests = destinations(opts);
+  for (const { dir } of dests) {
+    fs.mkdirSync(dir, { recursive: true });
+    for (const s of opts.skills) {
+      const to = path.join(dir, s);
+      fs.rmSync(to, { recursive: true, force: true });
+      fs.cpSync(path.join(SRC, s), to, { recursive: true });
+    }
+  }
+  console.log(`humanizer-th ${VERSION}: ${opts.skills.join(", ")}`);
+  for (const { dir, tool } of dests) console.log(`  ${dir}  (${tool})`);
+  console.log(`
+เสร็จแล้ว ถ้าเปิดโปรแกรม AI อยู่ ให้ปิดแล้วเปิดใหม่ก่อน แล้วลองพิมพ์
+  "แปลซับนี้เป็นไทย" แล้วแนบไฟล์ซับ
+  "เขียนบทละครสั้นเรื่อง..."
+  "เกลาให้หน่อย" ตามด้วยข้อความภาษาไทย
+
+Done. Restart your AI tool, then just ask, e.g. "Translate this subtitle file into Thai".
+อัปเดตเวอร์ชันใหม่ / update: npx humanizer-th@latest`);
+}
+
+function uninstall(opts) {
+  let removed = 0;
+  for (const { dir } of destinations(opts)) {
+    for (const s of opts.skills) {
+      const to = path.join(dir, s);
+      if (fs.existsSync(to)) {
+        fs.rmSync(to, { recursive: true, force: true });
+        console.log(`Removed ${to}`);
+        removed++;
+      }
+    }
+  }
+  if (removed === 0) console.log("ไม่พบ skill ที่ติดตั้งไว้ / Nothing to remove");
+}
+
+const opts = parseArgs(process.argv.slice(2));
+if (opts.command === "help") console.log(HELP);
+else if (opts.command === "version") console.log(VERSION);
+else if (opts.command === "uninstall") uninstall(opts);
+else install(opts);

package/package.json

@@ -1,6 +1,35 @@
 {
   "name": "humanizer-th",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.5.0",
+  "description": "Thai-language Agent Skills: translate subtitles, games, apps and websites into natural Thai, write dialogue and voice scripts for AI short dramas, and edit AI-written Thai. One command installs them into Claude Code, Codex, Gemini CLI and Copilot.",
+  "bin": {
+    "humanizer-th": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "skills/",
+    "README.en.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "agent-skills",
+    "claude-code",
+    "codex",
+    "thai",
+    "translation",
+    "localization",
+    "subtitles",
+    "humanizer"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/inatbalthazar/humanizer-th.git"
+  },
+  "homepage": "https://github.com/inatbalthazar/humanizer-th#readme",
+  "bugs": "https://github.com/inatbalthazar/humanizer-th/issues",
+  "license": "MIT",
+  "author": "inatbalthazar"
+}