Skip to content

Formerly KrillinAI, VideoTranslation and Dubbing Tool for 120+ Languages. Open-source AI workspace for creators, powered by Codex. Video downloader, video translation, create videos, images, audios, and edits with Agents in one place. For your Social Media like YouTube, TikTok, Instagram, etc.

docs: add contributing guides in 9 more languages

Joshua Yin Junxi661883aa8e83
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 320c99c2..9128e24d 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,6 +1,6 @@
# Contributing to OpenCreator
-> English | [简体中文](./docs/zh/CONTRIBUTING.md)
+> English | [简体中文](./docs/zh/CONTRIBUTING.md) | [日本語](./docs/ja/CONTRIBUTING.md) | [한국어](./docs/ko/CONTRIBUTING.md) | [Bahasa Indonesia](./docs/id/CONTRIBUTING.md) | [Español](./docs/es/CONTRIBUTING.md) | [Français](./docs/fr/CONTRIBUTING.md) | [Deutsch](./docs/de/CONTRIBUTING.md) | [Português](./docs/pt/CONTRIBUTING.md) | [Русский](./docs/ru/CONTRIBUTING.md) | [العربية](./docs/ar/CONTRIBUTING.md)
Thanks for thinking about contributing. OpenCreator is a local-first creator workspace built on the Codex agent loop, and most of its value lives in focused additions: one Skill folder, one creation template, one well-scoped fix. This guide tells you where each type of contribution lives and what bar a PR has to clear before we merge it.
diff --git a/docs/ar/CONTRIBUTING.md b/docs/ar/CONTRIBUTING.md
new file mode 100644
index 00000000..25157351
--- /dev/null
+++ b/docs/ar/CONTRIBUTING.md
@@ -0,0 +1,67 @@
+# دليل المساهمة (العربية)
+
+> [English](../../CONTRIBUTING.md) | [简体中文](../zh/CONTRIBUTING.md) | [日本語](../ja/CONTRIBUTING.md) | [한국어](../ko/CONTRIBUTING.md) | [Bahasa Indonesia](../id/CONTRIBUTING.md) | [Español](../es/CONTRIBUTING.md) | [Français](../fr/CONTRIBUTING.md) | [Deutsch](../de/CONTRIBUTING.md) | [Português](../pt/CONTRIBUTING.md) | [Русский](../ru/CONTRIBUTING.md) | **العربية**
+
+شكرًا لتفكيرك في المساهمة. OpenCreator هو مساحة عمل للمبدعين تعمل محليًا أولًا ومبنية على حلقة وكيل Codex، ومعظم قيمته تأتي من إضافات صغيرة ومركّزة: مجلد Skill واحد، قالب إنشاء واحد، أو إصلاح واحد محدد النطاق. يوضح هذا الدليل أين يجب أن يكون كل نوع من المساهمات وما المعايير التي يجب أن يستوفيها طلب الدمج قبل قبوله.
+
+---
+
+## خريطة المساهمات
+
+| إذا كنت تريد… | فأنت في الواقع تضيف | أين يوجد | حجم التسليم |
+|---|---|---|---|
+| إصلاح خطأ أو تحسين سير عمل | كود | `apps/web/`، `apps/daemon/` | طلب دمج واحد مركّز مع اختبارات |
+| إضافة سير عمل قابل لإعادة الاستخدام للوكيل | **Skill** | [`skills/<skill-الخاص-بك>/`](../../skills/) | مجلد واحد يحتوي `SKILL.md` ومراجع اختيارية ← [الدليل](./contributing/skills-contributing.md) |
+| إضافة إعداد مسبق قابل لإعادة الاستخدام للصور أو الفيديو أو الأغلفة | **قالب إنشاء** | [`template/<module>/<id>/<version>/`](../../template/) | مجلد واحد يحتوي `template.json` وأصوله ← [الدليل](./contributing/templates-contributing.md) |
+| المساهمة برسوم توضيحية أو أيقونات أو تصاميم واجهة | أصول تصميم | موقع أصول متفق عليه | طلب دمج واحد مع معاينات وملفات مصدر وترخيص |
+| ربط خدمة ذكاء اصطناعي أو وسائط | **تكامل خدمة** | وحدة Web أو Daemon ذات الصلة | طلب دمج واحد مع معالجة الأخطاء وأمان بيانات الاعتماد واختبارات |
+| تحسين التوثيق أو الترجمات | مستندات | `README.md`، `docs/`، `docs/<locale>/README.md` | طلب دمج واحد |
+
+إذا لم تكن متأكدًا من الفئة التي تنتمي إليها فكرتك، [افتح مشكلة أولًا](https://github.com/krillinai/OpenCreator/issues/new) وسنوجهك إلى المكان الصحيح.
+
+---
+
+## الإعداد المحلي
+
+الإعداد الكامل موجود في [البدء السريع في README](../../README.md#quick-start). الملخص للمساهمين:
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable # يختار إصدار pnpm المثبت في packageManager
+pnpm install
+pnpm web:dev # ‏web + الخادم المحلي عند الطلب
+pnpm typecheck # فحوصات TypeScript عبر المستودع
+pnpm test # اختبارات الوحدة والتكامل في مساحة العمل
+```
+
+مطلوب Node.js 22+ وملف Codex CLI تنفيذي. افتح `http://127.0.0.1:19861/` بعد `pnpm web:dev`؛ يجهّز Runtime مشروعًا افتراضيًا عند التشغيل الأول ويصبح محرر الإدخال جاهزًا فور اكتمال الاتصال.
+
+---
+
+## كيفية المساهمة
+
+1. صِف المشكلة وحالة الاستخدام والسلوك المتوقع في [مشكلة](https://github.com/krillinai/OpenCreator/issues).
+2. أنشئ فرعًا مركّزًا للميزة أو الإصلاح من أحدث فرع تطوير.
+3. اتبع البنية الحالية: تُنفَّذ القدرات العامة للمنتج **مرة واحدة** في Web وDaemon، وتُعزل الاختلافات الأصلية في Desktop خلف قدرات صريحة (مثل `canSelectDirectory`).
+4. أضف تغطية اختبارات وحدة أو تكامل أو E2E مناسبة لتغييرات السلوك، واذكر في طلب الدمج التحققات المنفَّذة والمتخطّاة معًا.
+5. لا تُدرج أبدًا `.runtime/` أو بيانات الاعتماد المحلية أو جلسات Codex أو ذاكرات التخزين المؤقت للبناء أو غيرها من بيانات المستخدم.
+
+## ما يتحقق منه المراجعون
+
+- **تنفيذ واحد للسلوك المشترك.** يجب ألا تُنفَّذ الميزة نفسها بشكل منفصل لـ Browser Bridge وDesktop Bridge.
+- **التحكم بالقدرات وليس الكيانات الوهمية الصامتة.** يجب إخفاء المدخل الخاص بالمنصة عندما تكون القدرة غير متاحة — لا تعرض أبدًا زرًا لا يفعل شيئًا بصمت.
+- **الاختبارات تتناسب مع مخاطر التغيير.** تعديلات النصوص أو الأنماط الصغيرة تحتاج فحوصات موجهة فقط؛ تغييرات الحالة المشتركة أو الاستمرارية أو عقود Runtime تتطلب على الأقل اختبارات الوحدة المعنية وtypecheck.
+- **التوثيق يُحدَّث مع السلوك.** إذا غيّر تعديلك سير عمل مرئيًا للمستخدم، حدّث README أو المستند ذا الصلة في `docs/` ضمن طلب الدمج نفسه.
+
+## الأسباب الشائعة لإرجاع طلبات الدمج
+
+- أُضيف المنطق نفسه بشكل منفصل في مساري Web وDesktop بدلًا من طبقة الخدمة المشتركة.
+- زر غير مدعوم من المنصة ظاهر لكن معالجه يعود بصمت.
+- تغيّر السلوك دون اختبارات أو ملاحظة تحقق.
+- طلب الدمج يخلط إعادة هيكلة أو إصلاحًا غير مرتبط بالتغيير الرئيسي.
+- أُدرجت ملفات مولّدة أو بيانات `.runtime/` أو بيانات اعتماد.
+
+---
+
+OpenCreator · Create locally, work continuously.
diff --git a/docs/ar/contributing/skills-contributing.md b/docs/ar/contributing/skills-contributing.md
new file mode 100644
index 00000000..b2cb11a4
--- /dev/null
+++ b/docs/ar/contributing/skills-contributing.md
@@ -0,0 +1,96 @@
+# المساهمة بـ Skill (العربية)
+
+> [English](../../contributing/skills-contributing.md) | [简体中文](../../zh/contributing/skills-contributing.md) | [日本語](../../ja/contributing/skills-contributing.md) | [한국어](../../ko/contributing/skills-contributing.md) | [Bahasa Indonesia](../../id/contributing/skills-contributing.md) | [Español](../../es/contributing/skills-contributing.md) | [Français](../../fr/contributing/skills-contributing.md) | [Deutsch](../../de/contributing/skills-contributing.md) | [Português](../../pt/contributing/skills-contributing.md) | [Русский](../../ru/contributing/skills-contributing.md) | **العربية**
+
+الـ Skill هو مجلد داخل [`skills/`](../../../skills/) يحتوي على ملف `SKILL.md` في جذره، ويتبع [اتفاقية `SKILL.md`](https://agentskills.io). يغلّف سير عمل قابلًا لإعادة الاستخدام للوكيل: متى يُستخدم، وما الأوامر أو الأدوات التي يجب استدعاؤها، وكيفية تفسير المخرجات. يشرح هذا الدليل كيفية إضافة واحد.
+
+---
+
+## ما هو الـ Skill وما ليس كذلك
+
+**الـ Skill هو:**
+- سير عمل قابل للتكرار يمكن للوكيل اتباعه، موصوف بلغة طبيعية مع أوامر.
+- معرفة متخصصة لا مكان لها في الكود الأساسي: كيفية استدعاء مرحلة CLI، وكيفية بناء موجه لمزود وسائط، وكيفية التحقق من خطة.
+- صغير. مجلد واحد، ملف `SKILL.md` واحد، ومجلد `references/` اختياري للمواد الطويلة التي يقرأها الوكيل عند الحاجة.
+
+**الـ Skill ليس:**
+- ميزة منتج. تغييرات الواجهة ونقاط نهاية Runtime الجديدة وسلوكيات مساحة العمل الجديدة هي مساهمات كود (`apps/web/`، `apps/daemon/`).
+- نسخة من Skill موجود مع تعديلات طفيفة في الصياغة. إذا كان تغييرك يحسّن سير عمل موجودًا، فحرّر ذلك الـ Skill مباشرة.
+- غلافًا حول بيانات اعتماد أو مسارات محلية خاصة بمستخدم معين. يجب أن تعمل الـ Skills من نسخة نظيفة من المستودع.
+
+## البدء السريع
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable && pnpm install
+cp -r skills/krillinai-tts skills/<skill-الخاص-بك> # ابدأ من أقرب Skill موجود
+# حرّر skills/<skill-الخاص-بك>/SKILL.md
+pnpm web:dev # تحقق من أن الوكيل يتعرف عليه في محادثة
+```
+
+أسرع طريق هو نسخ الـ Skill الأقرب لفكرتك ثم إعادة كتابته — الـ Skills الموجودة `krillinai-*` توضح البنية والأسلوب المتوقعين.
+
+## بنية الـ Skill
+
+```
+skills/<skill-الخاص-بك>/
+├── SKILL.md # مطلوب: frontmatter + تعليمات
+└── references/ # اختياري: مستندات طويلة يشير إليها SKILL.md
+ └── cli-contract.md
+```
+
+يبدأ `SKILL.md` بـ YAML frontmatter:
+
+```yaml
+---
+name: your-skill
+description: Use when <شرط التفعيل>, including <القدرات الرئيسية>.
+---
+```
+
+قاعدتان يطبقهما المراجعون:
+
+- **يجب أن يتطابق `name` مع اسم المجلد.** أحرف صغيرة مفصولة بشرطات.
+- **`description` هو سطح الاكتشاف.** إنه ما يقرأه الوكيل ليقرر ما إذا كان هذا الـ Skill ينطبق. اكتبه بصيغة "Use when …"، واذكر المُفعِّل والنتيجة، واجعله في جملة أو جملتين. الأوصاف الغامضة ("يساعد في الفيديو") تُرجَع.
+
+يجب أن يغطي المتن، بالترتيب:
+
+1. **متى تستخدمه** — فقرة واحدة.
+2. **الأوامر** — كتل كود بالاستدعاء الدقيق، بما في ذلك متغيرات البيئة أو مجلدات العمل المطلوبة.
+3. **المدخلات والأعلام** — جدول لكل ما هو غير بديهي؛ ميّز المطلوب عن الاختياري.
+4. **المخرجات** — أين تُحفظ النتائج وكيف تقرؤها (مثلاً، "اقرأ المسارات من الـ manifest").
+5. **أنماط الفشل** — الأخطاء المعروفة وما يجب فعله حيالها.
+
+حافظ على `SKILL.md` سهل المسح. انقل العقود الطويلة أو قوائم الأعلام الكاملة أو المواد الخلفية إلى `references/` واربطها بمسارات نسبية — الوكيل يقرأ المراجع فقط عند الحاجة.
+
+## الاختبار المحلي
+
+بعد `pnpm web:dev`، ابدأ محادثة وصف مهمة يجب أن تُفعِّل الـ Skill الخاص بك. تحقق من:
+
+- الوكيل يختار الـ Skill للطلبات الصحيحة — ولا يختاره للطلبات غير المرتبطة.
+- الأوامر في الـ Skill تعمل من نسخة نظيفة دون إصلاحات يدوية.
+- مسارات المخرجات ومعالجة الأخطاء تطابق الموثَّق.
+
+## معايير الدمج
+
+سيتحقق المراجع من كل عنصر أدناه — الصقها في طلب الدمج وعلّم عليها:
+
+- [ ] اسم المجلد و`name` في frontmatter متطابقان؛ أحرف صغيرة بشرطات.
+- [ ] `description` يذكر شرط التفعيل والنتيجة ("Use when …").
+- [ ] الأوامر تعمل من نسخة نظيفة؛ بدون مسارات محلية مطلقة أو بيانات اعتماد.
+- [ ] المدخلات والمخرجات وأنماط الفشل موثّقة.
+- [ ] المواد المرجعية الطويلة في `references/` وليست مضمّنة.
+- [ ] تم التحقق في محادثة حقيقية: يُفعَّل الـ Skill عندما يجب — وفقط عندئذ.
+- [ ] إذا كان الـ Skill يتداخل مع واحد موجود، يشرح طلب الدمج لماذا يُبرَّر skill منفصل.
+
+## أنماط الرفض الشائعة
+
+- **تكرار لـ Skill موجود** مع تغييرات شكلية في الصياغة فقط — حسّن الموجود بدلًا من ذلك.
+- **ميزة متنكرة** — الـ Skill يعمل فقط إذا اقترن بتغييرات كود في Runtime أو الواجهة؛ أرسل تغيير الكود كطلب دمج مستقل.
+- **أوامر غير مختبَرة** — أعلام غير موجودة، أو مخرجات لا تطابق المسارات الموثّقة.
+- **متطلبات مسبقة غير موثّقة** — الـ Skill يفترض ضمنيًا إعداد مزود أو ملفًا ثنائيًا أو خدمة شبكة.
+
+---
+
+لديك أسئلة؟ [افتح مشكلة](https://github.com/krillinai/OpenCreator/issues/new) بموضوع `skill` وسنساعدك في تحديد النطاق.
diff --git a/docs/ar/contributing/templates-contributing.md b/docs/ar/contributing/templates-contributing.md
new file mode 100644
index 00000000..57ecdc75
--- /dev/null
+++ b/docs/ar/contributing/templates-contributing.md
@@ -0,0 +1,102 @@
+# المساهمة بقالب إنشاء (العربية)
+
+> [English](../../contributing/templates-contributing.md) | [简体中文](../../zh/contributing/templates-contributing.md) | [日本語](../../ja/contributing/templates-contributing.md) | [한국어](../../ko/contributing/templates-contributing.md) | [Bahasa Indonesia](../../id/contributing/templates-contributing.md) | [Español](../../es/contributing/templates-contributing.md) | [Français](../../fr/contributing/templates-contributing.md) | [Deutsch](../../de/contributing/templates-contributing.md) | [Português](../../pt/contributing/templates-contributing.md) | [Русский](../../ru/contributing/templates-contributing.md) | **العربية**
+
+قالب الإنشاء هو مجلد داخل [`template/<module>/<id>/<version>/`](../../../template/) يحتوي على ملف `template.json` وأصوله المحلية. تغذي القوالب أدوات الاختيار المرئية لتوليد الصور والفيديو والأغلفة — يبدأ المستخدمون من الإعداد المسبق الخاص بك بدلًا من موجه فارغ. يشرح هذا الدليل كيفية إضافة واحد.
+
+---
+
+## ما هو قالب الإنشاء وما ليس كذلك
+
+**القالب هو:**
+- إعداد مسبق مضبوط: موجهات افتراضية، تلميحات أسلوبية، إعدادات النسبة/المدة/الجودة، بالإضافة إلى غلاف ومعاينة يعرضان النتيجة.
+- مكتفٍ ذاتيًا. كل ما يعرضه المُنتقي موجود داخل مجلد القالب.
+
+**القالب ليس:**
+- *نوعًا* جديدًا من القوالب. الوحدات الحالية هي `image-generation` و`video-generation` و`cover-generator`. إذا كنت تحتاج وحدة جديدة، افتح مشكلة للنقاش أولًا — هذا تغيير في المنتج وليس قالبًا.
+- كومة من الموجهات. القوالب ذات الموجه الفارغ أو العام بدون قيم افتراضية مترجمة ستُرجَع؛ القيمة في الضبط.
+- عمل شخص آخر بدون حقوق. راجع [النسب والحقوق](#النسب-والحقوق).
+
+## البدء السريع
+
+```bash
+corepack enable && pnpm install
+cp -r template/cover-generator/images-go-hard-thumbnail template/<module>/<template-id-الخاص-بك>
+# حرّر template.json، واستبدل أصول الغلاف/المعاينة
+pnpm templates:validate # يجب أن ينجح قبل فتح طلب دمج
+```
+
+معرّفات القوالب بأحرف صغيرة مفصولة بشرطات وفريدة داخل الوحدة. يبدأ الإصدار من `1` — مجلد واحد لكل إصدار، لذا التحديثات تنشئ `<id>/2/` بدلًا من تعديل `<id>/1/`.
+
+## بنية المجلد
+
+```
+template/<module>/<id>/1/
+├── template.json # مطلوب: بيانات وصفية، قيم افتراضية، محتوى مترجم
+├── cover.jpg # مطلوب: يُعرض في منتقي القوالب
+├── preview.jpg # وحدتا الصورة/الغلاف: معاينة أكبر للنتيجة
+├── previewVideo # وحدة الفيديو: مقطع مثال، مثل example.mp4
+└── author-avatar.jpg # اختياري: صورة المؤلف المنسوب إليه
+```
+
+## حقول template.json
+
+| الحقل | مطلوب | ملاحظات |
+|---|---|---|
+| `schemaVersion` | نعم | حاليًا `1`. |
+| `id`، `version`، `module` | نعم | يجب أن تطابق مسار المجلد `<module>/<id>/<version>/`. |
+| `runtimeTemplate` | نعم | يربط بمنفّذ Runtime، مثل `{"id": "cover", "version": 2}`. انسخ من قالب في الوحدة نفسها. |
+| `status` | نعم | `published` للنشر؛ استخدم `draft` أثناء العمل. |
+| `title`، `description` | نعم | `zh-CN` و`en-US` مطلوبان. اللغات الأخرى اختيارية. |
+| `cover` | نعم | مسار نسبي لصورة المُنتقي المصغّرة. |
+| `preview` / `previewVideo` | حسب الوحدة | `preview` لوحدتي الصورة والغلاف، `previewVideo` للفيديو. |
+| `defaults` | نعم | الإعدادات الأساسية التي يبدأ منها المستخدم (الموجه، النسبة، المدة، الجودة…). |
+| `defaultsByLocale` | موصى به بشدة | تجاوزات الموجه والأسلوب المترجمة لكل لغة. الضبط الحقيقي يعيش هنا — انظر أدناه. |
+| `tags` | موصى به | تسميات قابلة للبحث؛ حافظ على موضوعيتها. |
+| `author` | عند الاقتضاء | `name` و`url` و`avatar` للمصادر الخارجية المنسوبة. |
+| `featured`، `sortOrder` | لا | اترك `featured: false`؛ المشرفون يقررون الإبراز. |
+
+## الموجه هو المنتج
+
+يقضي المراجعون معظم وقتهم في `defaults` و`defaultsByLocale`:
+
+- **يجب أن تكون كلتا اللغتين موجهات حقيقية**، وليست ترجمات فقدت الضبط. يجب أن تنتج موجهات `zh-CN` و`en-US` نتائج متكافئة مع الاستفادة من نقاط قوة كل لغة.
+- **جعِل ما يُفترض أن يتغير قابلًا للتخصيص.** إذا كان نص العنوان أو الموضوع قابلًا للتحرير من المستخدم، فاذكر ذلك صراحةً في الموجه (تستخدم القوالب الموجودة علامات مثل "Customizable text: …").
+- **اذكر القيود.** "بدون علامة مائية، بدون نص إضافي، بدون أشخاص إضافيين" — القيود السلبية مهمة بقدر الوصف للحصول على نتائج قابلة للتكرار.
+- **طابق بنية `defaults` للوحدة.** قوالب الصور تحمل ratio/candidateCount/quality؛ قوالب الفيديو تحمل size/duration؛ قوالب الأغلفة تحمل العنوان الرئيسي ولغة النص وحقول الأسلوب. انسخ البنية من قالب موجود في وحدتك.
+
+## الأصول
+
+- ولّد `cover.jpg` والمعاينة **بالقالب نفسه** — صورة جاهزة أو عمل فني غير مرتبط سيُرفَض.
+- حافظ على أحجام ملفات معقولة؛ هذه الملفات تُوزَّع مع التطبيق وتُحمَّل في المُنتقي.
+- يجب أن تمثل المعاينة نتيجة *نموذجية*، وليس أفضل نتيجة من خمسين محاولة.
+
+## النسب والحقوق
+
+إذا كان قالبك يقتبس موجهًا أو أسلوبًا منشورًا لشخص آخر:
+
+- يجب أن يكون لديك حق إعادة توزيعه.
+- املأ حقل `author` بـ `name` و`url` (و`author-avatar.jpg` إن توفر)، كما تفعل القوالب الموجودة.
+- عند الشك، افتح مشكلة واسأل قبل بدء العمل.
+
+## معايير الدمج
+
+- [ ] مسار المجلد يطابق `id`/`version`/`module`؛ المعرّف فريد في الوحدة.
+- [ ] `pnpm templates:validate` ينجح.
+- [ ] `title` و`description` متوفران بـ `zh-CN` و`en-US`.
+- [ ] `defaultsByLocale` يحتوي موجهات مضبوطة لكلتا اللغتين.
+- [ ] أصول الغلاف والمعاينة مولّدة بالقالب نفسه.
+- [ ] نسب `author` مضمّن عند اقتباس عمل خارجي.
+- [ ] `featured: false`، `status: "published"` (أو `draft` مع ملاحظة في طلب الدمج).
+
+## أنماط الرفض الشائعة
+
+- **موجه عام** — القالب لا يضيف شيئًا فوق الموجه الفارغ؛ المُنتقي لا يحتاجه.
+- **لغة مفقودة** — لغة واحدة فقط مضبوطة، أو ترجمة آلية فقدت قيود الأسلوب.
+- **أصول غير متطابقة** — الغلاف لا يطابق ما يولّده الموجه فعليًا.
+- **حقوق غير واضحة** — اقتباس عمل شخص ما بدون نسب أو إذن.
+- **تعديل الإصدار القديم في مكانه** — أنشئ مجلد إصدار جديد بدلًا من إعادة كتابة تاريخ `<id>/1/`.
+
+---
+
+لديك أسئلة؟ [افتح مشكلة](https://github.com/krillinai/OpenCreator/issues/new) مع فكرة قالبك ونموذج مخرجات، وسنساعدك في تحديد النطاق.
diff --git a/docs/contributing/skills-contributing.md b/docs/contributing/skills-contributing.md
index 0f21cb7f..1bba3848 100644
--- a/docs/contributing/skills-contributing.md
+++ b/docs/contributing/skills-contributing.md
@@ -1,6 +1,6 @@
# Contributing a Skill
-> English | [简体中文](../zh/contributing/skills-contributing.md)
+> English | [简体中文](../zh/contributing/skills-contributing.md) | [日本語](../ja/contributing/skills-contributing.md) | [한국어](../ko/contributing/skills-contributing.md) | [Bahasa Indonesia](../id/contributing/skills-contributing.md) | [Español](../es/contributing/skills-contributing.md) | [Français](../fr/contributing/skills-contributing.md) | [Deutsch](../de/contributing/skills-contributing.md) | [Português](../pt/contributing/skills-contributing.md) | [Русский](../ru/contributing/skills-contributing.md) | [العربية](../ar/contributing/skills-contributing.md)
A Skill is a folder under [`skills/`](../../skills/) with a `SKILL.md` at its root, following the [`SKILL.md` convention](https://agentskills.io). It packages a reusable Agent workflow: when to use it, what commands or tools to call, and how to interpret outputs. This guide walks through adding one.
diff --git a/docs/contributing/templates-contributing.md b/docs/contributing/templates-contributing.md
index 9fcfd7dc..2e06c07f 100644
--- a/docs/contributing/templates-contributing.md
+++ b/docs/contributing/templates-contributing.md
@@ -1,6 +1,6 @@
# Contributing a Creation Template
-> English | [简体中文](../zh/contributing/templates-contributing.md)
+> English | [简体中文](../zh/contributing/templates-contributing.md) | [日本語](../ja/contributing/templates-contributing.md) | [한국어](../ko/contributing/templates-contributing.md) | [Bahasa Indonesia](../id/contributing/templates-contributing.md) | [Español](../es/contributing/templates-contributing.md) | [Français](../fr/contributing/templates-contributing.md) | [Deutsch](../de/contributing/templates-contributing.md) | [Português](../pt/contributing/templates-contributing.md) | [Русский](../ru/contributing/templates-contributing.md) | [العربية](../ar/contributing/templates-contributing.md)
A creation template is a folder under [`template/<module>/<id>/<version>/`](../../template/) with a `template.json` and its local assets. Templates power the visual pickers for image generation, video generation, and cover generation — users start from your preset instead of a blank prompt. This guide walks through adding one.
diff --git a/docs/de/CONTRIBUTING.md b/docs/de/CONTRIBUTING.md
new file mode 100644
index 00000000..67a43d47
--- /dev/null
+++ b/docs/de/CONTRIBUTING.md
@@ -0,0 +1,67 @@
+# Leitfaden für Beiträge (Deutsch)
+
+> [English](../../CONTRIBUTING.md) | [简体中文](../zh/CONTRIBUTING.md) | [日本語](../ja/CONTRIBUTING.md) | [한국어](../ko/CONTRIBUTING.md) | [Bahasa Indonesia](../id/CONTRIBUTING.md) | [Español](../es/CONTRIBUTING.md) | [Français](../fr/CONTRIBUTING.md) | **Deutsch** | [Português](../pt/CONTRIBUTING.md) | [Русский](../ru/CONTRIBUTING.md) | [العربية](../ar/CONTRIBUTING.md)
+
+Danke, dass du zu OpenCreator beitragen möchtest. OpenCreator ist ein Local-First-Workspace für Kreative auf Basis des Codex-Agent-Loops, und der größte Mehrwert entsteht durch fokussierte Ergänzungen: ein Skill-Ordner, ein Creation-Template, ein klar abgegrenzter Fix. Dieser Leitfaden zeigt, wo jede Art von Beitrag hingehört und welche Anforderungen ein PR vor dem Merge erfüllen muss.
+
+---
+
+## Beitrags-Übersicht
+
+| Wenn du … | Dann fügst du hinzu | Ort | Umfang |
+|---|---|---|---|
+| einen Bug beheben oder einen Workflow verbessern möchtest | Code | `apps/web/`, `apps/daemon/` | ein fokussierter PR mit Tests |
+| einen wiederverwendbaren Agent-Workflow hinzufügen möchtest | einen **Skill** | [`skills/<dein-skill>/`](../../skills/) | ein Ordner mit `SKILL.md` und optionalen Referenzen → [Anleitung](./contributing/skills-contributing.md) |
+| ein wiederverwendbares Bild-, Video- oder Cover-Preset hinzufügen möchtest | ein **Creation-Template** | [`template/<module>/<id>/<version>/`](../../template/) | ein Ordner mit `template.json` und Assets → [Anleitung](./contributing/templates-contributing.md) |
+| Illustrationen, Icons oder UI-Designs beisteuern möchtest | Design-Assets | vereinbarter Asset-Ort | ein PR mit Vorschauen, Quelldateien und Lizenz |
+| einen KI- oder Mediendienst anbinden möchtest | eine **Service-Integration** | relevantes Web- oder Daemon-Modul | ein PR mit Fehlerbehandlung, Credential-Sicherheit und Tests |
+| Dokumentation oder Übersetzungen verbessern möchtest | Docs | `README.md`, `docs/`, `docs/<locale>/README.md` | ein PR |
+
+Wenn du nicht sicher bist, in welche Kategorie deine Idee fällt, [öffne zuerst ein Issue](https://github.com/krillinai/OpenCreator/issues/new) — wir zeigen dir die richtige Anlaufstelle.
+
+---
+
+## Lokale Einrichtung
+
+Die vollständige Einrichtung steht im [README-Quickstart](../../README.md#quick-start). Kurzfassung für Contributors:
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable # wählt die gepinnte pnpm-Version aus packageManager
+pnpm install
+pnpm web:dev # Web + lokaler Daemon bei Bedarf
+pnpm typecheck # TypeScript-Prüfungen im gesamten Repository
+pnpm test # Unit- und Integrationstests des Workspaces
+```
+
+Node.js 22+ und eine Codex-CLI sind erforderlich. Nach `pnpm web:dev` `http://127.0.0.1:19861/` öffnen; die Runtime erstellt beim ersten Start automatisch ein Standardprojekt, und der Composer ist bereit, sobald die Verbindung steht.
+
+---
+
+## So trägst du bei
+
+1. Beschreibe das Problem, den Anwendungsfall und das erwartete Verhalten in einem [Issue](https://github.com/krillinai/OpenCreator/issues).
+2. Erstelle einen fokussierten Feature- oder Fix-Branch vom aktuellen Entwicklungsbranch.
+3. Folge der bestehenden Architektur: Allgemeine Produktfunktionen werden **einmal** in Web und Daemon implementiert; Desktop-native Unterschiede werden über explizite Capabilities isoliert (z. B. `canSelectDirectory`).
+4. Füge für Verhaltensänderungen passende Unit-, Integrations- oder E2E-Tests hinzu und liste im PR sowohl durchgeführte als auch übersprungene Verifizierungen auf.
+5. Committe niemals `.runtime/`, lokale Zugangsdaten, Codex-Sessions, Build-Caches oder andere Nutzerdaten.
+
+## Was Reviewer prüfen
+
+- **Eine einzige Implementierung für geteiltes Verhalten.** Dieselbe Funktion darf nicht getrennt für Browser Bridge und Desktop Bridge implementiert werden.
+- **Capability-Gating statt stiller Stubs.** Ein plattformspezifischer Einstieg muss ausgeblendet werden, wenn die Capability nicht verfügbar ist — niemals einen Button zeigen, der still nichts tut.
+- **Tests passend zum Änderungsrisiko.** Kleine Text- oder Style-Anpassungen brauchen nur gezielte Prüfungen; Änderungen an geteiltem State, Persistenz oder Runtime-Verträgen erfordern mindestens Modultests und Typecheck.
+- **Dokumentation wird mit dem Verhalten aktualisiert.** Wenn deine Änderung einen nutzersichtbaren Workflow verändert, aktualisiere im selben PR die README oder die relevante Datei in `docs/`.
+
+## Häufige Gründe für zurückgewiesene PRs
+
+- Dieselbe Logik wurde getrennt in Web- und Desktop-Pfaden hinzugefügt statt im geteilten Service-Layer.
+- Ein von der Plattform nicht unterstützter Button ist sichtbar, aber der Handler kehrt still zurück.
+- Verhalten geändert ohne Tests oder Verifizierungshinweis.
+- Der PR mischt ein unrelated Refactoring oder einen fremden Fix in eine Feature-Änderung.
+- Generierte Dateien, `.runtime/`-Daten oder Zugangsdaten wurden committet.
+
+---
+
+OpenCreator · Create locally, work continuously.
diff --git a/docs/de/contributing/skills-contributing.md b/docs/de/contributing/skills-contributing.md
new file mode 100644
index 00000000..9a96a8c6
--- /dev/null
+++ b/docs/de/contributing/skills-contributing.md
@@ -0,0 +1,96 @@
+# Einen Skill beitragen (Deutsch)
+
+> [English](../../contributing/skills-contributing.md) | [简体中文](../../zh/contributing/skills-contributing.md) | [日本語](../../ja/contributing/skills-contributing.md) | [한국어](../../ko/contributing/skills-contributing.md) | [Bahasa Indonesia](../../id/contributing/skills-contributing.md) | [Español](../../es/contributing/skills-contributing.md) | [Français](../../fr/contributing/skills-contributing.md) | **Deutsch** | [Português](../../pt/contributing/skills-contributing.md) | [Русский](../../ru/contributing/skills-contributing.md) | [العربية](../../ar/contributing/skills-contributing.md)
+
+Ein Skill ist ein Ordner unter [`skills/`](../../../skills/) mit einer `SKILL.md` im Wurzelverzeichnis, der der [`SKILL.md`-Konvention](https://agentskills.io) folgt. Er bündelt einen wiederverwendbaren Agent-Workflow: wann er zu nutzen ist, welche Befehle oder Tools aufzurufen sind und wie die Ausgaben zu interpretieren sind. Diese Anleitung zeigt, wie du einen Skill hinzufügst.
+
+---
+
+## Was ein Skill IST / NICHT ist
+
+**Ein Skill IST:**
+- Ein wiederholbarer Workflow, dem der Agent folgen kann, beschrieben in natürlicher Sprache plus Befehlen.
+- Domänenwissen, das nicht in den Kerncode gehört: wie eine CLI-Stufe aufgerufen wird, wie ein Prompt für einen Medienanbieter aufgebaut ist, wie ein Plan validiert wird.
+- Klein. Ein Ordner, eine `SKILL.md`, optionale `references/` für längeres Material, das der Agent bei Bedarf liest.
+
+**Ein Skill IST NICHT:**
+- Ein Produkt-Feature. UI-Änderungen, neue Runtime-Endpunkte und neues Workspace-Verhalten sind Code-Beiträge (`apps/web/`, `apps/daemon/`).
+- Eine Kopie eines bestehenden Skills mit leicht geänderten Formulierungen. Wenn deine Änderung einen bestehenden Workflow verbessert, bearbeite diesen Skill direkt.
+- Ein Wrapper um Zugangsdaten oder benutzerspezifische lokale Pfade. Skills müssen aus einem sauberen Checkout heraus funktionieren.
+
+## Schnellstart
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable && pnpm install
+cp -r skills/krillinai-tts skills/<dein-skill> # vom ähnlichsten bestehenden Skill starten
+# skills/<dein-skill>/SKILL.md bearbeiten
+pnpm web:dev # prüfen, ob der Agent ihn in einer Konversation erkennt
+```
+
+Der schnellste Weg ist, den Skill zu kopieren, der deiner Idee am nächsten kommt, und ihn umzuschreiben — die bestehenden `krillinai-*`-Skills zeigen die erwartete Struktur und Tonalität.
+
+## Skill-Aufbau
+
+```
+skills/<dein-skill>/
+├── SKILL.md # erforderlich: Frontmatter + Anweisungen
+└── references/ # optional: längere Docs, auf die SKILL.md verweist
+ └── cli-contract.md
+```
+
+`SKILL.md` beginnt mit YAML-Frontmatter:
+
+```yaml
+---
+name: dein-skill
+description: Use when <Auslösebedingung>, including <Hauptfähigkeiten>.
+---
+```
+
+Zwei Regeln, die Reviewer durchsetzen:
+
+- **`name` muss dem Ordnernamen entsprechen.** Kleinbuchstaben, mit Bindestrichen.
+- **`description` ist die Auffindbarkeits-Fläche.** Der Agent liest sie, um zu entscheiden, ob dieser Skill passt. Formuliere sie als "Use when …", nenne Auslöser und Ergebnis und halte sie bei ein bis zwei Sätzen. Vage Beschreibungen ("hilft bei Video") werden zurückgewiesen.
+
+Der Inhalt sollte in dieser Reihenfolge aufgebaut sein:
+
+1. **Wann nutzen** — ein Absatz.
+2. **Befehle** — Codeblöcke mit dem exakten Aufruf, inklusive erforderlicher Umgebungsvariablen oder Arbeitsverzeichnisse.
+3. **Eingaben und Flags** — eine Tabelle für alles Nicht-offensichtliche; erforderlich vs. optional kennzeichnen.
+4. **Ausgaben** — wo Ergebnisse landen und wie man sie liest (z. B. "Pfade aus dem Manifest lesen").
+5. **Fehlerfälle** — bekannte Fehler und was dagegen zu tun ist.
+
+Halte `SKILL.md` überfliegbar. Lange Verträge, vollständige Flag-Listen oder Hintergrundmaterial gehören in `references/` und werden per relativem Pfad verlinkt — der Agent liest Referenzen nur bei Bedarf.
+
+## Lokales Testen
+
+Starte nach `pnpm web:dev` eine Konversation und beschreibe eine Aufgabe, die deinen Skill auslösen sollte. Prüfe:
+
+- Der Agent wählt den Skill bei den richtigen Anfragen — und nicht bei unrelated Anfragen.
+- Die Befehle im Skill laufen aus einem sauberen Checkout ohne manuelle Nacharbeit.
+- Ausgabepfade und Fehlerbehandlung entsprechen der Dokumentation.
+
+## Merge-Kriterien
+
+Ein Reviewer prüft jeden der folgenden Punkte — füge sie in deinen PR ein und hake sie ab:
+
+- [ ] Ordnername und `name`-Frontmatter stimmen überein; Kleinbuchstaben mit Bindestrichen.
+- [ ] `description` nennt Auslösebedingung und Ergebnis ("Use when …").
+- [ ] Befehle laufen aus einem sauberen Checkout; keine absoluten lokalen Pfade oder Zugangsdaten.
+- [ ] Eingaben, Ausgaben und Fehlerfälle sind dokumentiert.
+- [ ] Langes Referenzmaterial liegt in `references/`, nicht inline.
+- [ ] In einer echten Konversation verifiziert: der Skill triggert, wenn er soll — und nur dann.
+- [ ] Falls der Skill einen bestehenden überlappt, erklärt der PR, warum ein separater Skill gerechtfertigt ist.
+
+## Häufige Ablehnungsgründe
+
+- **Duplikat eines bestehenden Skills** mit nur kosmetischen Formulierungsänderungen — verbessere stattdessen den bestehenden.
+- **Ein getarntes Feature** — der Skill funktioniert nur mit Code-Änderungen an Runtime oder UI; reiche die Code-Änderung als eigenen PR ein.
+- **Ungetestete Befehle** — Flags, die nicht existieren, oder Ausgaben, die nicht den dokumentierten Pfaden entsprechen.
+- **Nicht dokumentierte Voraussetzungen** — der Skill setzt stillschweigend eine Provider-Konfiguration, ein Binary oder einen Netzwerkdienst voraus.
+
+---
+
+Fragen? [Öffne ein Issue](https://github.com/krillinai/OpenCreator/issues/new) mit dem Thema `skill` — wir helfen dir beim Abgrenzen.
diff --git a/docs/de/contributing/templates-contributing.md b/docs/de/contributing/templates-contributing.md
new file mode 100644
index 00000000..08a3955c
--- /dev/null
+++ b/docs/de/contributing/templates-contributing.md
@@ -0,0 +1,102 @@
+# Ein Creation-Template beitragen (Deutsch)
+
+> [English](../../contributing/templates-contributing.md) | [简体中文](../../zh/contributing/templates-contributing.md) | [日本語](../../ja/contributing/templates-contributing.md) | [한국어](../../ko/contributing/templates-contributing.md) | [Bahasa Indonesia](../../id/contributing/templates-contributing.md) | [Español](../../es/contributing/templates-contributing.md) | [Français](../../fr/contributing/templates-contributing.md) | **Deutsch** | [Português](../../pt/contributing/templates-contributing.md) | [Русский](../../ru/contributing/templates-contributing.md) | [العربية](../../ar/contributing/templates-contributing.md)
+
+Ein Creation-Template ist ein Ordner unter [`template/<module>/<id>/<version>/`](../../../template/) mit einer `template.json` und lokalen Assets. Templates versorgen die visuellen Auswahldialoge für Bildgenerierung, Videogenerierung und Cover-Generierung — Nutzer starten mit deinem Preset statt mit einem leeren Prompt. Diese Anleitung zeigt, wie du eines hinzufügst.
+
+---
+
+## Was ein Creation-Template IST / NICHT ist
+
+**Ein Template IST:**
+- Ein abgestimmtes Preset: Prompt-Defaults, Stilhinweise, Verhältnis-/Dauer-/Qualitätseinstellungen, plus Cover und Vorschau, die das Ergebnis zeigen.
+- Eigenständig. Alles, was der Picker anzeigt, liegt im Template-Ordner.
+
+**Ein Template IST NICHT:**
+- Ein neuer Template-*Typ*. Die aktuellen Module sind `image-generation`, `video-generation` und `cover-generator`. Wenn du ein neues Modul brauchst, öffne zuerst ein Issue — das ist eine Produktänderung, kein Template.
+- Eine Prompt-Sammlung. Templates mit leerem oder generischem Prompt und ohne lokalisierte Defaults werden zurückgewiesen; der Wert liegt in der Abstimmung.
+- Die Arbeit anderer ohne Rechte. Siehe [Namensnennung und Rechte](#namensnennung-und-rechte).
+
+## Schnellstart
+
+```bash
+corepack enable && pnpm install
+cp -r template/cover-generator/images-go-hard-thumbnail template/<module>/<deine-template-id>
+# template.json bearbeiten, Cover-/Vorschau-Assets ersetzen
+pnpm templates:validate # muss vor dem PR bestehen
+```
+
+Template-IDs sind kleingeschrieben mit Bindestrichen und innerhalb des Moduls eindeutig. Die Version startet bei `1` — ein Ordner pro Version, Updates entstehen also als `<id>/2/` statt `<id>/1/` zu bearbeiten.
+
+## Ordneraufbau
+
+```
+template/<module>/<id>/1/
+├── template.json # erforderlich: Metadaten, Defaults, lokalisierte Inhalte
+├── cover.jpg # erforderlich: im Template-Picker angezeigt
+├── preview.jpg # Bild-/Cover-Module: größere Ergebnisvorschau
+├── previewVideo # Video-Modul: Beispielclip, z. B. example.mp4
+└── author-avatar.jpg # optional: Avatar des genannten Autors
+```
+
+## template.json-Felder
+
+| Feld | Pflicht | Hinweise |
+|---|---|---|
+| `schemaVersion` | ja | Derzeit `1`. |
+| `id`, `version`, `module` | ja | Muss dem Ordnerpfad `<module>/<id>/<version>/` entsprechen. |
+| `runtimeTemplate` | ja | Abbildung auf den Runtime-Executor, z. B. `{"id": "cover", "version": 2}`. Von einem Template desselben Moduls kopieren. |
+| `status` | ja | `published` zum Veröffentlichen; `draft` während der Arbeit. |
+| `title`, `description` | ja | `zh-CN` und `en-US` sind erforderlich. Weitere Sprachen optional. |
+| `cover` | ja | Relativer Pfad zum Picker-Thumbnail. |
+| `preview` / `previewVideo` | modulabhängig | `preview` für Bild- und Cover-Module, `previewVideo` für Video. |
+| `defaults` | ja | Die Basiseinstellungen, mit denen Nutzer starten (Prompt, Verhältnis, Dauer, Qualität …). |
+| `defaultsByLocale` | dringend empfohlen | Lokalisierte Prompt- und Stil-Overrides pro Sprache. Hier steckt die eigentliche Abstimmung — siehe unten. |
+| `tags` | empfohlen | Durchsuchbare Labels; sachlich halten. |
+| `author` | falls zutreffend | `name`, `url`, `avatar` für genannte externe Quellen. |
+| `featured`, `sortOrder` | nein | `featured: false` lassen; Maintainer entscheiden über Featuring. |
+
+## Der Prompt ist das Produkt
+
+Reviewer verbringen die meiste Zeit mit `defaults` und `defaultsByLocale`:
+
+- **Beide Sprachen müssen echte Prompts sein**, keine Übersetzungen, die die Abstimmung verloren haben. Die `zh-CN`- und `en-US`-Prompts sollen mit ihren jeweiligen sprachlichen Stärken gleichwertige Ergebnisse erzeugen.
+- **Parametrisiere, was sich ändern soll.** Wenn Überschrift oder Motiv vom Nutzer editierbar sind, sage das explizit im Prompt (bestehende Templates nutzen Marker wie "Customizable text: …").
+- **Formuliere Einschränkungen.** "Kein Wasserzeichen, kein zusätzlicher Text, keine zusätzlichen Personen" — negative Constraints sind für reproduzierbare Ergebnisse genauso wichtig wie die Beschreibung.
+- **Passe zur Defaults-Struktur des Moduls.** Bild-Templates tragen ratio/candidateCount/quality; Video-Templates size/duration; Cover-Templates Headline, Textsprache und Stilfelder. Kopiere die Struktur von einem bestehenden Template deines Moduls.
+
+## Assets
+
+- Erzeuge `cover.jpg` und die Vorschau **mit dem Template selbst** — ein Stock-Foto oder fremdes Artwork wird abgelehnt.
+- Halte Dateigrößen moderat; diese Dateien werden mit der App ausgeliefert und im Picker geladen.
+- Die Vorschau sollte ein *typisches* Ergebnis zeigen, nicht das beste aus fünfzig Versuchen.
+
+## Namensnennung und Rechte
+
+Wenn dein Template einen veröffentlichten Prompt oder Stil anderer adaptiert:
+
+- Du musst das Recht zur Weiterverbreitung haben.
+- Fülle das `author`-Feld mit `name` und `url` aus (und `author-avatar.jpg`, falls verfügbar), wie es bestehende Templates tun.
+- Im Zweifel: öffne ein Issue und frag, bevor du die Arbeit investierst.
+
+## Merge-Kriterien
+
+- [ ] Ordnerpfad stimmt mit `id`/`version`/`module` überein; ID ist im Modul eindeutig.
+- [ ] `pnpm templates:validate` besteht.
+- [ ] `title` und `description` in `zh-CN` und `en-US` vorhanden.
+- [ ] `defaultsByLocale` enthält abgestimmte Prompts für beide Sprachen.
+- [ ] Cover- und Vorschau-Assets wurden mit dem Template selbst erzeugt.
+- [ ] `author`-Nennung enthalten, wenn externe Arbeit adaptiert wurde.
+- [ ] `featured: false`, `status: "published"` (oder `draft` mit Hinweis im PR).
+
+## Häufige Ablehnungsgründe
+
+- **Generischer Prompt** — das Template bietet keinen Mehrwert gegenüber einem leeren Prompt.
+- **Fehlende Sprache** — nur eine Sprache abgestimmt, oder eine maschinelle Übersetzung, die die Stil-Constraints verloren hat.
+- **Unpassende Assets** — das Cover entspricht nicht dem, was der Prompt tatsächlich erzeugt.
+- **Unklare Rechte** — von fremder Arbeit adaptiert ohne Nennung oder Erlaubnis.
+- **Alte Version überschrieben** — statt `<id>/1/` zu verändern, einen neuen Versionsordner anlegen.
+
+---
+
+Fragen? [Öffne ein Issue](https://github.com/krillinai/OpenCreator/issues/new) mit deiner Template-Idee und einem Beispiel-Ergebnis — wir helfen beim Abgrenzen.
diff --git a/docs/es/CONTRIBUTING.md b/docs/es/CONTRIBUTING.md
new file mode 100644
index 00000000..07500e0a
--- /dev/null
+++ b/docs/es/CONTRIBUTING.md
@@ -0,0 +1,67 @@
+# Guía de contribución (Español)
+
+> [English](../../CONTRIBUTING.md) | [简体中文](../zh/CONTRIBUTING.md) | [日本語](../ja/CONTRIBUTING.md) | [한국어](../ko/CONTRIBUTING.md) | [Bahasa Indonesia](../id/CONTRIBUTING.md) | **Español** | [Français](../fr/CONTRIBUTING.md) | [Deutsch](../de/CONTRIBUTING.md) | [Português](../pt/CONTRIBUTING.md) | [Русский](../ru/CONTRIBUTING.md) | [العربية](../ar/CONTRIBUTING.md)
+
+Gracias por querer contribuir a OpenCreator. OpenCreator es un espacio de trabajo local-first para creadores construido sobre el bucle del agente Codex, y la mayor parte de su valor proviene de aportes pequeños y enfocados: una carpeta de Skill, una plantilla de creación, un arreglo bien delimitado. Esta guía indica dónde va cada tipo de contribución y qué debe cumplir un PR antes de ser fusionado.
+
+---
+
+## Mapa de contribuciones
+
+| Si quieres… | En realidad añades | Dónde vive | Tamaño de entrega |
+|---|---|---|---|
+| Corregir un bug o mejorar un flujo de trabajo | código | `apps/web/`, `apps/daemon/` | un PR enfocado con pruebas |
+| Añadir un flujo de trabajo reutilizable para el agente | un **Skill** | [`skills/<tu-skill>/`](../../skills/) | una carpeta con `SKILL.md` y referencias opcionales → [guía](./contributing/skills-contributing.md) |
+| Añadir un preset reutilizable de imagen, video o portada | una **plantilla de creación** | [`template/<módulo>/<id>/<versión>/`](../../template/) | una carpeta con `template.json` y recursos → [guía](./contributing/templates-contributing.md) |
+| Aportar ilustraciones, iconos o diseños de UI | recursos de diseño | ubicación acordada | un PR con vistas previas, archivos fuente y licencia |
+| Integrar un servicio de IA o de medios | una **integración de servicio** | módulo Web o Daemon correspondiente | un PR con manejo de errores, seguridad de credenciales y pruebas |
+| Mejorar documentación o traducciones | docs | `README.md`, `docs/`, `docs/<locale>/README.md` | un PR |
+
+Si no sabes en qué categoría encaja tu idea, [abre primero un issue](https://github.com/krillinai/OpenCreator/issues/new) y te indicaremos el lugar correcto.
+
+---
+
+## Configuración local
+
+La configuración completa está en el [inicio rápido del README](../../README.md#quick-start). Resumen para contribuyentes:
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable # selecciona el pnpm fijado en packageManager
+pnpm install
+pnpm web:dev # web + daemon local bajo demanda
+pnpm typecheck # comprobaciones de TypeScript en todo el repositorio
+pnpm test # pruebas unitarias e de integración del workspace
+```
+
+Se requiere Node.js 22+ y un ejecutable de Codex CLI. Abre `http://127.0.0.1:19861/` tras `pnpm web:dev`; el Runtime prepara un proyecto por defecto en el primer inicio y el editor queda listo en cuanto se completa la conexión.
+
+---
+
+## Cómo contribuir
+
+1. Describe el problema, el caso de uso y el comportamiento esperado en un [issue](https://github.com/krillinai/OpenCreator/issues).
+2. Crea una rama enfocada de funcionalidad o corrección desde la rama de desarrollo más reciente.
+3. Sigue la arquitectura existente: las capacidades generales del producto se implementan **una sola vez** en Web y Daemon; las diferencias nativas de Desktop se aíslan detrás de capabilities explícitas (por ejemplo `canSelectDirectory`).
+4. Añade cobertura de pruebas unitarias, de integración o E2E apropiada para los cambios de comportamiento, y enumera en el PR tanto las verificaciones realizadas como las omitidas.
+5. Nunca confirmes `.runtime/`, credenciales locales, sesiones de Codex, cachés de compilación u otros datos de usuario.
+
+## Qué revisan los revisores
+
+- **Una única implementación para el comportamiento compartido.** La misma función no debe implementarse por separado para Browser Bridge y Desktop Bridge.
+- **Control por capabilities, no stubs silenciosos.** Una entrada específica de plataforma debe ocultarse cuando la capability no está disponible; nunca mostrar un botón que no hace nada silenciosamente.
+- **Las pruebas corresponden al riesgo del cambio.** Ajustes pequeños de texto o estilo solo necesitan comprobaciones dirigidas; cambios en estado compartido, persistencia o contratos del Runtime requieren al menos pruebas de módulo y typecheck.
+- **La documentación se actualiza con el comportamiento.** Si tu cambio altera un flujo visible para el usuario, actualiza el README o el documento correspondiente en `docs/` en el mismo PR.
+
+## Razones frecuentes de rechazo de PRs
+
+- La misma lógica se añadió por separado en las rutas de Web y Desktop en lugar de en la capa de servicio compartida.
+- Un botón no soportado por la plataforma es visible pero su manejador retorna silenciosamente.
+- Comportamiento modificado sin pruebas ni nota de verificación.
+- El PR mezcla una refactorización o corrección no relacionada con el cambio principal.
+- Se confirmaron archivos generados, datos de `.runtime/` o credenciales.
+
+---
+
+OpenCreator · Create locally, work continuously.
diff --git a/docs/es/contributing/skills-contributing.md b/docs/es/contributing/skills-contributing.md
new file mode 100644
index 00000000..bac8474e
--- /dev/null
+++ b/docs/es/contributing/skills-contributing.md
@@ -0,0 +1,96 @@
+# Contribuir un Skill (Español)
+
+> [English](../../contributing/skills-contributing.md) | [简体中文](../../zh/contributing/skills-contributing.md) | [日本語](../../ja/contributing/skills-contributing.md) | [한국어](../../ko/contributing/skills-contributing.md) | [Bahasa Indonesia](../../id/contributing/skills-contributing.md) | **Español** | [Français](../../fr/contributing/skills-contributing.md) | [Deutsch](../../de/contributing/skills-contributing.md) | [Português](../../pt/contributing/skills-contributing.md) | [Русский](../../ru/contributing/skills-contributing.md) | [العربية](../../ar/contributing/skills-contributing.md)
+
+Un Skill es una carpeta dentro de [`skills/`](../../../skills/) con un `SKILL.md` en su raíz, que sigue la [convención `SKILL.md`](https://agentskills.io). Empaqueta un flujo de trabajo reutilizable para el agente: cuándo usarlo, qué comandos o herramientas invocar y cómo interpretar las salidas. Esta guía explica cómo añadir uno.
+
+---
+
+## Qué ES / NO ES un Skill
+
+**Un Skill ES:**
+- Un flujo de trabajo repetible que el agente puede seguir, descrito en lenguaje natural más comandos.
+- Conocimiento de dominio que no pertenece al código central: cómo invocar una etapa de CLI, cómo estructurar un prompt para un proveedor de medios, cómo validar un plan.
+- Pequeño. Una carpeta, un `SKILL.md`, y `references/` opcional para material más extenso que el agente lee bajo demanda.
+
+**Un Skill NO ES:**
+- Una funcionalidad de producto. Los cambios de UI, nuevos endpoints del Runtime y nuevos comportamientos del workspace son contribuciones de código (`apps/web/`, `apps/daemon/`).
+- Una copia de un Skill existente con redacción ligeramente modificada. Si tu cambio mejora un flujo existente, edita ese Skill directamente.
+- Un envoltorio de credenciales o rutas locales de un usuario específico. Los Skills deben funcionar desde un checkout limpio.
+
+## Inicio rápido
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable && pnpm install
+cp -r skills/krillinai-tts skills/<tu-skill> # empieza desde el Skill existente más cercano
+# edita skills/<tu-skill>/SKILL.md
+pnpm web:dev # verifica que el agente lo detecta en una conversación
+```
+
+El camino más rápido es copiar el Skill más cercano a tu idea y reescribirlo: los Skills `krillinai-*` existentes muestran la estructura y el tono esperados.
+
+## Anatomía de un Skill
+
+```
+skills/<tu-skill>/
+├── SKILL.md # obligatorio: frontmatter + instrucciones
+└── references/ # opcional: docs extensos a los que apunta SKILL.md
+ └── cli-contract.md
+```
+
+`SKILL.md` comienza con frontmatter YAML:
+
+```yaml
+---
+name: tu-skill
+description: Use when <condición de activación>, including <capacidades principales>.
+---
+```
+
+Dos reglas que los revisores aplican:
+
+- **`name` debe coincidir con el nombre de la carpeta.** Minúsculas con guiones.
+- **`description` es la superficie de descubrimiento.** Es lo que el agente lee para decidir si este Skill aplica. Escríbela como "Use when …", nombra el disparador y el resultado, y limítala a una o dos frases. Las descripciones vagas ("ayuda con video") se rechazan.
+
+El cuerpo debe cubrir, en orden:
+
+1. **Cuándo usarlo** — un párrafo.
+2. **Comandos** — bloques de código con la invocación exacta, incluyendo variables de entorno o directorios de trabajo requeridos.
+3. **Entradas y flags** — una tabla para lo no evidente; marca requerido vs. opcional.
+4. **Salidas** — dónde quedan los resultados y cómo leerlos (por ejemplo, "leer rutas del manifest").
+5. **Modos de fallo** — errores conocidos y qué hacer ante ellos.
+
+Mantén `SKILL.md` escaneable. Traslada contratos largos, listas completas de flags o material de contexto a `references/` y enlázalos con rutas relativas: el agente solo lee las referencias cuando las necesita.
+
+## Pruebas locales
+
+Tras `pnpm web:dev`, inicia una conversación y describe una tarea que debería activar tu Skill. Verifica:
+
+- El agente selecciona el Skill para las peticiones correctas — y no lo selecciona para peticiones ajenas.
+- Los comandos del Skill se ejecutan desde un checkout limpio sin arreglos manuales.
+- Las rutas de salida y el manejo de errores coinciden con lo documentado.
+
+## Criterios de fusión
+
+Un revisor comprobará cada punto: pégalo en tu PR y márcalos:
+
+- [ ] El nombre de la carpeta y el frontmatter `name` coinciden; minúsculas con guiones.
+- [ ] `description` nombra la condición de activación y el resultado ("Use when …").
+- [ ] Los comandos funcionan desde un checkout limpio; sin rutas locales absolutas ni credenciales.
+- [ ] Entradas, salidas y modos de fallo documentados.
+- [ ] El material de referencia extenso vive en `references/`, no en línea.
+- [ ] Verificado en una conversación real: el Skill se activa cuando debe y solo entonces.
+- [ ] Si el Skill se solapa con uno existente, el PR explica por qué se justifica uno separado.
+
+## Patrones frecuentes de rechazo
+
+- **Duplicado de un Skill existente** con solo cambios cosméticos de redacción: mejora el existente en su lugar.
+- **Una funcionalidad disfrazada** — el Skill solo funciona con cambios de código en el Runtime o la UI; envía el cambio de código como PR propio.
+- **Comandos sin probar** — flags que no existen o salidas que no coinciden con las rutas documentadas.
+- **Prerrequisitos no documentados** — el Skill asume silenciosamente una configuración de proveedor, un binario o un servicio de red.
+
+---
+
+¿Preguntas? [Abre un issue](https://github.com/krillinai/OpenCreator/issues/new) con el tema `skill` y te ayudaremos a delimitarlo.
diff --git a/docs/es/contributing/templates-contributing.md b/docs/es/contributing/templates-contributing.md
new file mode 100644
index 00000000..5ff1c420
--- /dev/null
+++ b/docs/es/contributing/templates-contributing.md
@@ -0,0 +1,102 @@
+# Contribuir una plantilla de creación (Español)
+
+> [English](../../contributing/templates-contributing.md) | [简体中文](../../zh/contributing/templates-contributing.md) | [日本語](../../ja/contributing/templates-contributing.md) | [한국어](../../ko/contributing/templates-contributing.md) | [Bahasa Indonesia](../../id/contributing/templates-contributing.md) | **Español** | [Français](../../fr/contributing/templates-contributing.md) | [Deutsch](../../de/contributing/templates-contributing.md) | [Português](../../pt/contributing/templates-contributing.md) | [Русский](../../ru/contributing/templates-contributing.md) | [العربية](../../ar/contributing/templates-contributing.md)
+
+Una plantilla de creación es una carpeta dentro de [`template/<módulo>/<id>/<versión>/`](../../../template/) con un `template.json` y sus recursos locales. Las plantillas alimentan los selectores visuales de generación de imágenes, videos y portadas: los usuarios empiezan desde tu preset en lugar de un prompt en blanco. Esta guía explica cómo añadir una.
+
+---
+
+## Qué ES / NO ES una plantilla de creación
+
+**Una plantilla ES:**
+- Un preset afinado: prompts por defecto, indicaciones de estilo, ajustes de proporción/duración/calidad, más una portada y vista previa que muestran el resultado.
+- Autocontenida. Todo lo que muestra el selector vive en la carpeta de la plantilla.
+
+**Una plantilla NO ES:**
+- Un nuevo *tipo* de plantilla. Los módulos actuales son `image-generation`, `video-generation` y `cover-generator`. Si necesitas un módulo nuevo, abre primero un issue: es un cambio de producto, no una plantilla.
+- Un volcado de prompts. Las plantillas con prompt vacío o genérico y sin defaults localizados serán rechazadas; el valor está en el ajuste.
+- Trabajo ajeno sin derechos. Consulta [Atribución y derechos](#atribución-y-derechos).
+
+## Inicio rápido
+
+```bash
+corepack enable && pnpm install
+cp -r template/cover-generator/images-go-hard-thumbnail template/<módulo>/<tu-id-de-plantilla>
+# edita template.json, sustituye los recursos de portada/vista previa
+pnpm templates:validate # debe pasar antes de abrir un PR
+```
+
+Los IDs de plantilla usan minúsculas con guiones y son únicos dentro del módulo. La versión empieza en `1`: una carpeta por versión, así que las actualizaciones crean `<id>/2/` en lugar de editar `<id>/1/`.
+
+## Anatomía de la carpeta
+
+```
+template/<módulo>/<id>/1/
+├── template.json # obligatorio: metadatos, defaults, contenido localizado
+├── cover.jpg # obligatorio: se muestra en el selector de plantillas
+├── preview.jpg # módulos de imagen/portada: vista previa ampliada del resultado
+├── previewVideo # módulo de video: clip de ejemplo, p. ej. example.mp4
+└── author-avatar.jpg # opcional: avatar del autor acreditado
+```
+
+## Campos de template.json
+
+| Campo | Obligatorio | Notas |
+|---|---|---|
+| `schemaVersion` | sí | Actualmente `1`. |
+| `id`, `version`, `module` | sí | Deben coincidir con la ruta `<módulo>/<id>/<versión>/`. |
+| `runtimeTemplate` | sí | Corresponde al ejecutor del Runtime, p. ej. `{"id": "cover", "version": 2}`. Copia de una plantilla del mismo módulo. |
+| `status` | sí | `published` para publicar; usa `draft` mientras iteras. |
+| `title`, `description` | sí | `zh-CN` y `en-US` son obligatorios. Otros idiomas opcionales. |
+| `cover` | sí | Ruta relativa a la miniatura del selector. |
+| `preview` / `previewVideo` | según módulo | `preview` para imagen y portada, `previewVideo` para video. |
+| `defaults` | sí | Ajustes base desde los que parte el usuario (prompt, proporción, duración, calidad…). |
+| `defaultsByLocale` | muy recomendado | Prompts y estilos localizados por idioma. Aquí reside el verdadero ajuste — ver abajo. |
+| `tags` | recomendado | Etiquetas buscables; mantenlas objetivas. |
+| `author` | si aplica | `name`, `url`, `avatar` para fuentes externas acreditadas. |
+| `featured`, `sortOrder` | no | Deja `featured: false`; los mantenedores deciden el destacado. |
+
+## El prompt es el producto
+
+Los revisores dedican la mayor parte del tiempo a `defaults` y `defaultsByLocale`:
+
+- **Ambos idiomas deben ser prompts reales**, no traducciones que perdieron el ajuste. Los prompts `zh-CN` y `en-US` deben producir resultados equivalentes aprovechando las fortalezas de cada idioma.
+- **Parametriza lo que debe cambiar.** Si el titular o el sujeto son editables por el usuario, dilo explícitamente en el prompt (las plantillas existentes usan marcadores como "Customizable text: …").
+- **Declara restricciones.** "Sin marca de agua, sin texto extra, sin personas extra": las restricciones negativas importan tanto como la descripción para resultados reproducibles.
+- **Respeta la forma de `defaults` del módulo.** Las plantillas de imagen llevan ratio/candidateCount/quality; las de video size/duration; las de portada titular, idioma del texto y campos de estilo. Copia la forma de una plantilla existente de tu módulo.
+
+## Recursos
+
+- Genera `cover.jpg` y la vista previa **con la propia plantilla**: una imagen de stock o arte ajeno será rechazada.
+- Mantén tamaños de archivo razonables; estos archivos se distribuyen con la app y se cargan en el selector.
+- La vista previa debe representar un resultado *típico*, no el mejor de cincuenta intentos.
+
+## Atribución y derechos
+
+Si tu plantilla adapta un prompt o estilo publicado por otra persona:
+
+- Debes tener derecho a redistribuirlo.
+- Rellena el campo `author` con `name` y `url` (y `author-avatar.jpg` si está disponible), como hacen las plantillas existentes.
+- En caso de duda, abre un issue y pregunta antes de hacer el trabajo.
+
+## Criterios de fusión
+
+- [ ] La ruta de la carpeta coincide con `id`/`version`/`module`; el ID es único en el módulo.
+- [ ] `pnpm templates:validate` pasa.
+- [ ] `title` y `description` en `zh-CN` y `en-US`.
+- [ ] `defaultsByLocale` contiene prompts afinados para ambos idiomas.
+- [ ] Los recursos de portada y vista previa fueron generados por la propia plantilla.
+- [ ] Atribución `author` incluida al adaptar trabajo externo.
+- [ ] `featured: false`, `status: "published"` (o `draft` con nota en el PR).
+
+## Patrones frecuentes de rechazo
+
+- **Prompt genérico** — la plantilla no aporta nada sobre un prompt en blanco; el selector no la necesita.
+- **Idioma faltante** — solo un idioma afinado, o una traducción automática que perdió las restricciones de estilo.
+- **Recursos incoherentes** — la portada no coincide con lo que el prompt realmente genera.
+- **Derechos poco claros** — adaptado de trabajo ajeno sin atribución ni permiso.
+- **Versión antigua editada en su lugar** — crea una carpeta de versión nueva en vez de reescribir el historial de `<id>/1/`.
+
+---
+
+¿Preguntas? [Abre un issue](https://github.com/krillinai/OpenCreator/issues/new) con tu idea de plantilla y una salida de ejemplo, y te ayudaremos a delimitarla.
diff --git a/docs/fr/CONTRIBUTING.md b/docs/fr/CONTRIBUTING.md
new file mode 100644
index 00000000..956941b3
--- /dev/null
+++ b/docs/fr/CONTRIBUTING.md
@@ -0,0 +1,67 @@
+# Guide de contribution (Français)
+
+> [English](../../CONTRIBUTING.md) | [简体中文](../zh/CONTRIBUTING.md) | [日本語](../ja/CONTRIBUTING.md) | [한국어](../ko/CONTRIBUTING.md) | [Bahasa Indonesia](../id/CONTRIBUTING.md) | [Español](../es/CONTRIBUTING.md) | **Français** | [Deutsch](../de/CONTRIBUTING.md) | [Português](../pt/CONTRIBUTING.md) | [Русский](../ru/CONTRIBUTING.md) | [العربية](../ar/CONTRIBUTING.md)
+
+Merci de vouloir contribuer à OpenCreator. OpenCreator est un espace de travail local-first pour les créateurs, construit sur la boucle d'agent Codex, et l'essentiel de sa valeur tient à des ajouts ciblés : un dossier de Skill, un modèle de création, un correctif bien délimité. Ce guide indique où placer chaque type de contribution et quels critères une PR doit remplir avant d'être fusionnée.
+
+---
+
+## Carte des contributions
+
+| Si vous voulez… | Vous ajoutez en fait | Où cela vit | Taille de livraison |
+|---|---|---|---|
+| Corriger un bug ou améliorer un flux de travail | du code | `apps/web/`, `apps/daemon/` | une PR ciblée avec des tests |
+| Ajouter un flux de travail réutilisable pour l'agent | un **Skill** | [`skills/<votre-skill>/`](../../skills/) | un dossier avec `SKILL.md` et des références optionnelles → [guide](./contributing/skills-contributing.md) |
+| Ajouter un préréglage réutilisable d'image, vidéo ou couverture | un **modèle de création** | [`template/<module>/<id>/<version>/`](../../template/) | un dossier avec `template.json` et ses ressources → [guide](./contributing/templates-contributing.md) |
+| Contribuer des illustrations, icônes ou designs d'UI | des ressources de design | emplacement convenu | une PR avec aperçus, fichiers sources et licence |
+| Intégrer un service d'IA ou de médias | une **intégration de service** | module Web ou Daemon concerné | une PR avec gestion d'erreurs, sécurité des identifiants et tests |
+| Améliorer la documentation ou les traductions | des docs | `README.md`, `docs/`, `docs/<locale>/README.md` | une PR |
+
+Si vous ne savez pas dans quelle catégorie votre idée se range, [ouvrez d'abord une issue](https://github.com/krillinai/OpenCreator/issues/new) et nous vous indiquerons le bon endroit.
+
+---
+
+## Installation locale
+
+L'installation complète se trouve dans le [démarrage rapide du README](../../README.md#quick-start). Version courte pour les contributeurs :
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable # sélectionne le pnpm épinglé dans packageManager
+pnpm install
+pnpm web:dev # web + daemon local à la demande
+pnpm typecheck # vérifications TypeScript sur tout le dépôt
+pnpm test # tests unitaires et d'intégration du workspace
+```
+
+Node.js 22+ et un exécutable Codex CLI sont requis. Ouvrez `http://127.0.0.1:19861/` après `pnpm web:dev` ; le Runtime prépare un projet par défaut au premier lancement et l'éditeur est prêt dès que la connexion est établie.
+
+---
+
+## Comment contribuer
+
+1. Décrivez le problème, le cas d'usage et le comportement attendu dans une [issue](https://github.com/krillinai/OpenCreator/issues).
+2. Créez une branche ciblée de fonctionnalité ou de correctif depuis la dernière branche de développement.
+3. Suivez l'architecture existante : les capacités générales du produit sont implémentées **une seule fois** dans Web et Daemon ; les différences natives de Desktop sont isolées derrière des capabilities explicites (par exemple `canSelectDirectory`).
+4. Ajoutez une couverture de tests unitaires, d'intégration ou E2E adaptée aux changements de comportement, et listez dans la PR les vérifications effectuées comme celles ignorées.
+5. Ne commitez jamais `.runtime/`, des identifiants locaux, des sessions Codex, des caches de build ou d'autres données utilisateur.
+
+## Ce que vérifient les relecteurs
+
+- **Une seule implémentation pour le comportement partagé.** La même fonctionnalité ne doit pas être implémentée séparément pour Browser Bridge et Desktop Bridge.
+- **Contrôle par capabilities, pas de stubs silencieux.** Une entrée spécifique à une plateforme doit être masquée quand la capability n'est pas disponible — jamais un bouton affiché qui ne fait silencieusement rien.
+- **Les tests correspondent au risque du changement.** De petits ajustements de texte ou de style n'exigent que des vérifications ciblées ; les changements d'état partagé, de persistance ou de contrats Runtime exigent au minimum des tests de module et un typecheck.
+- **La documentation suit le comportement.** Si votre changement modifie un flux visible par l'utilisateur, mettez à jour le README ou le document concerné dans `docs/` dans la même PR.
+
+## Raisons fréquentes de retour des PRs
+
+- La même logique a été ajoutée séparément dans les chemins Web et Desktop au lieu de la couche de service partagée.
+- Un bouton non pris en charge par la plateforme est visible mais son gestionnaire retourne silencieusement.
+- Comportement modifié sans test ni note de vérification.
+- La PR mélange un refactoring ou un correctif sans rapport avec le changement principal.
+- Des fichiers générés, des données `.runtime/` ou des identifiants ont été commités.
+
+---
+
+OpenCreator · Create locally, work continuously.
diff --git a/docs/fr/contributing/skills-contributing.md b/docs/fr/contributing/skills-contributing.md
new file mode 100644
index 00000000..3721ca66
--- /dev/null
+++ b/docs/fr/contributing/skills-contributing.md
@@ -0,0 +1,96 @@
+# Contribuer un Skill (Français)
+
+> [English](../../contributing/skills-contributing.md) | [简体中文](../../zh/contributing/skills-contributing.md) | [日本語](../../ja/contributing/skills-contributing.md) | [한국어](../../ko/contributing/skills-contributing.md) | [Bahasa Indonesia](../../id/contributing/skills-contributing.md) | [Español](../../es/contributing/skills-contributing.md) | **Français** | [Deutsch](../../de/contributing/skills-contributing.md) | [Português](../../pt/contributing/skills-contributing.md) | [Русский](../../ru/contributing/skills-contributing.md) | [العربية](../../ar/contributing/skills-contributing.md)
+
+Un Skill est un dossier sous [`skills/`](../../../skills/) avec un `SKILL.md` à sa racine, suivant la [convention `SKILL.md`](https://agentskills.io). Il empaquette un flux de travail réutilisable pour l'agent : quand l'utiliser, quelles commandes ou quels outils appeler, et comment interpréter les sorties. Ce guide explique comment en ajouter un.
+
+---
+
+## Ce qu'un Skill EST / N'EST PAS
+
+**Un Skill EST :**
+- Un flux de travail répétable que l'agent peut suivre, décrit en langage naturel plus des commandes.
+- De la connaissance métier qui n'a pas sa place dans le code cœur : comment invoquer une étape CLI, comment structurer un prompt pour un fournisseur de médias, comment valider un plan.
+- Petit. Un dossier, un `SKILL.md`, des `references/` optionnelles pour les contenus longs que l'agent lit à la demande.
+
+**Un Skill N'EST PAS :**
+- Une fonctionnalité produit. Les changements d'UI, les nouveaux endpoints Runtime et les nouveaux comportements du workspace sont des contributions de code (`apps/web/`, `apps/daemon/`).
+- Une copie d'un Skill existant avec une formulation légèrement modifiée. Si votre changement améliore un flux existant, modifiez ce Skill directement.
+- Une enveloppe autour d'identifiants ou de chemins locaux propres à un utilisateur. Les Skills doivent fonctionner depuis un checkout propre.
+
+## Démarrage rapide
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable && pnpm install
+cp -r skills/krillinai-tts skills/<votre-skill> # partez du Skill existant le plus proche
+# modifiez skills/<votre-skill>/SKILL.md
+pnpm web:dev # vérifiez que l'agent le détecte en conversation
+```
+
+Le chemin le plus rapide consiste à copier le Skill le plus proche de votre idée puis à le réécrire — les Skills `krillinai-*` existants montrent la structure et le ton attendus.
+
+## Anatomie d'un Skill
+
+```
+skills/<votre-skill>/
+├── SKILL.md # obligatoire : frontmatter + instructions
+└── references/ # optionnel : docs longues pointées par SKILL.md
+ └── cli-contract.md
+```
+
+`SKILL.md` commence par un frontmatter YAML :
+
+```yaml
+---
+name: votre-skill
+description: Use when <condition de déclenchement>, including <capacités principales>.
+---
+```
+
+Deux règles appliquées par les relecteurs :
+
+- **`name` doit correspondre au nom du dossier.** Minuscules avec tirets.
+- **`description` est la surface de découverte.** C'est ce que l'agent lit pour décider si ce Skill s'applique. Rédigez-la en « Use when … », nommez le déclencheur et le résultat, et limitez-vous à une ou deux phrases. Les descriptions vagues (« aide avec la vidéo ») sont renvoyées.
+
+Le corps doit couvrir, dans l'ordre :
+
+1. **Quand l'utiliser** — un paragraphe.
+2. **Commandes** — blocs de code avec l'invocation exacte, y compris les variables d'environnement ou répertoires de travail requis.
+3. **Entrées et options** — un tableau pour tout ce qui n'est pas évident ; marquez obligatoire vs. optionnel.
+4. **Sorties** — où aboutissent les résultats et comment les lire (par ex. « lire les chemins depuis le manifest »).
+5. **Modes d'échec** — erreurs connues et conduite à tenir.
+
+Gardez `SKILL.md` scannable. Déplacez les contrats longs, listes complètes d'options ou contextes dans `references/` et liez-les par chemins relatifs — l'agent ne lit les références qu'en cas de besoin.
+
+## Tests locaux
+
+Après `pnpm web:dev`, démarrez une conversation et décrivez une tâche qui devrait déclencher votre Skill. Vérifiez :
+
+- L'agent sélectionne le Skill pour les bonnes requêtes — et pas pour des requêtes sans rapport.
+- Les commandes du Skill s'exécutent depuis un checkout propre sans corrections manuelles.
+- Les chemins de sortie et la gestion d'erreurs correspondent à la documentation.
+
+## Critères de fusion
+
+Un relecteur vérifiera chaque élément — collez cette liste dans votre PR et cochez-la :
+
+- [ ] Le nom du dossier et le frontmatter `name` correspondent ; minuscules avec tirets.
+- [ ] `description` nomme la condition de déclenchement et le résultat (« Use when … »).
+- [ ] Les commandes fonctionnent depuis un checkout propre ; aucun chemin local absolu ni identifiant.
+- [ ] Entrées, sorties et modes d'échec documentés.
+- [ ] Les contenus de référence longs vivent dans `references/`, pas en ligne.
+- [ ] Vérifié dans une conversation réelle : le Skill se déclenche quand il doit — et seulement alors.
+- [ ] Si le Skill chevauche un existant, la PR explique pourquoi un Skill séparé est justifié.
+
+## Motifs fréquents de rejet
+
+- **Doublon d'un Skill existant** avec seulement des changements cosmétiques de formulation — améliorez plutôt l'existant.
+- **Une fonctionnalité déguisée** — le Skill ne fonctionne qu'avec des changements de code dans le Runtime ou l'UI ; soumettez le changement de code dans sa propre PR.
+- **Commandes non testées** — options inexistantes ou sorties ne correspondant pas aux chemins documentés.
+- **Prérequis non documentés** — le Skill suppose tacitement une configuration de fournisseur, un binaire ou un service réseau.
+
+---
+
+Des questions ? [Ouvrez une issue](https://github.com/krillinai/OpenCreator/issues/new) avec le sujet `skill` et nous vous aiderons à cadrer.
diff --git a/docs/fr/contributing/templates-contributing.md b/docs/fr/contributing/templates-contributing.md
new file mode 100644
index 00000000..20e0f658
--- /dev/null
+++ b/docs/fr/contributing/templates-contributing.md
@@ -0,0 +1,102 @@
+# Contribuer un modèle de création (Français)
+
+> [English](../../contributing/templates-contributing.md) | [简体中文](../../zh/contributing/templates-contributing.md) | [日本語](../../ja/contributing/templates-contributing.md) | [한국어](../../ko/contributing/templates-contributing.md) | [Bahasa Indonesia](../../id/contributing/templates-contributing.md) | [Español](../../es/contributing/templates-contributing.md) | **Français** | [Deutsch](../../de/contributing/templates-contributing.md) | [Português](../../pt/contributing/templates-contributing.md) | [Русский](../../ru/contributing/templates-contributing.md) | [العربية](../../ar/contributing/templates-contributing.md)
+
+Un modèle de création est un dossier sous [`template/<module>/<id>/<version>/`](../../../template/) avec un `template.json` et ses ressources locales. Les modèles alimentent les sélecteurs visuels de génération d'images, de vidéos et de couvertures — les utilisateurs partent de votre préréglage plutôt que d'un prompt vide. Ce guide explique comment en ajouter un.
+
+---
+
+## Ce qu'un modèle de création EST / N'EST PAS
+
+**Un modèle EST :**
+- Un préréglage affiné : prompts par défaut, indications de style, réglages de ratio/durée/qualité, plus une couverture et un aperçu montrant le résultat.
+- Autonome. Tout ce que le sélecteur affiche vit dans le dossier du modèle.
+
+**Un modèle N'EST PAS :**
+- Un nouveau *type* de modèle. Les modules actuels sont `image-generation`, `video-generation` et `cover-generator`. Si vous avez besoin d'un nouveau module, ouvrez d'abord une issue — c'est un changement produit, pas un modèle.
+- Un simple recueil de prompts. Les modèles avec un prompt vide ou générique et sans valeurs localisées seront renvoyés ; la valeur réside dans l'affinage.
+- Le travail d'autrui sans droits. Voir [Attribution et droits](#attribution-et-droits).
+
+## Démarrage rapide
+
+```bash
+corepack enable && pnpm install
+cp -r template/cover-generator/images-go-hard-thumbnail template/<module>/<votre-id-de-modele>
+# modifiez template.json, remplacez les ressources de couverture/aperçu
+pnpm templates:validate # doit passer avant d'ouvrir une PR
+```
+
+Les identifiants de modèle sont en minuscules avec tirets et uniques au sein du module. La version commence à `1` — un dossier par version : les mises à jour créent `<id>/2/` au lieu de modifier `<id>/1/`.
+
+## Anatomie du dossier
+
+```
+template/<module>/<id>/1/
+├── template.json # obligatoire : métadonnées, défauts, contenus localisés
+├── cover.jpg # obligatoire : affiché dans le sélecteur de modèles
+├── preview.jpg # modules image/couverture : aperçu agrandi du résultat
+├── previewVideo # module vidéo : clip d'exemple, par ex. example.mp4
+└── author-avatar.jpg # optionnel : avatar de l'auteur crédité
+```
+
+## Champs de template.json
+
+| Champ | Obligatoire | Remarques |
+|---|---|---|
+| `schemaVersion` | oui | Actuellement `1`. |
+| `id`, `version`, `module` | oui | Doivent correspondre au chemin `<module>/<id>/<version>/`. |
+| `runtimeTemplate` | oui | Correspond à l'exécuteur Runtime, par ex. `{"id": "cover", "version": 2}`. Copiez depuis un modèle du même module. |
+| `status` | oui | `published` pour publier ; utilisez `draft` pendant l'itération. |
+| `title`, `description` | oui | `zh-CN` et `en-US` sont obligatoires. Les autres langues sont optionnelles. |
+| `cover` | oui | Chemin relatif vers la vignette du sélecteur. |
+| `preview` / `previewVideo` | selon le module | `preview` pour image et couverture, `previewVideo` pour la vidéo. |
+| `defaults` | oui | Les réglages de base de départ (prompt, ratio, durée, qualité…). |
+| `defaultsByLocale` | fortement recommandé | Prompts et styles localisés par langue. C'est là que réside le vrai affinage — voir ci-dessous. |
+| `tags` | recommandé | Étiquettes recherchables ; restez factuel. |
+| `author` | si applicable | `name`, `url`, `avatar` pour les sources externes créditées. |
+| `featured`, `sortOrder` | non | Laissez `featured: false` ; les mainteneurs décident de la mise en avant. |
+
+## Le prompt est le produit
+
+Les relecteurs passent l'essentiel de leur temps sur `defaults` et `defaultsByLocale` :
+
+- **Les deux langues doivent être de vrais prompts**, pas des traductions ayant perdu l'affinage. Les prompts `zh-CN` et `en-US` doivent produire des résultats équivalents en tirant parti des forces de chaque langue.
+- **Paramétrez ce qui doit changer.** Si le titre ou le sujet est modifiable par l'utilisateur, dites-le explicitement dans le prompt (les modèles existants utilisent des marqueurs comme « Customizable text: … »).
+- **Énoncez les contraintes.** « Pas de filigrane, pas de texte supplémentaire, pas de personnes supplémentaires » — les contraintes négatives comptent autant que la description pour des résultats reproductibles.
+- **Respectez la structure des `defaults` du module.** Les modèles d'image portent ratio/candidateCount/quality ; ceux de vidéo size/duration ; ceux de couverture le titre, la langue du texte et les champs de style. Copiez la structure d'un modèle existant de votre module.
+
+## Ressources
+
+- Générez `cover.jpg` et l'aperçu **avec le modèle lui-même** — une image de stock ou un visuel sans rapport sera rejetée.
+- Gardez des tailles de fichiers raisonnables ; ces fichiers sont distribués avec l'application et chargés dans le sélecteur.
+- L'aperçu doit représenter un résultat *typique*, pas le meilleur de cinquante essais.
+
+## Attribution et droits
+
+Si votre modèle adapte un prompt ou un style publié par quelqu'un d'autre :
+
+- Vous devez avoir le droit de le redistribuer.
+- Renseignez le champ `author` avec `name` et `url` (et `author-avatar.jpg` si disponible), comme le font les modèles existants.
+- En cas de doute, ouvrez une issue et demandez avant d'investir le travail.
+
+## Critères de fusion
+
+- [ ] Le chemin du dossier correspond à `id`/`version`/`module` ; l'ID est unique dans le module.
+- [ ] `pnpm templates:validate` passe.
+- [ ] `title` et `description` fournis en `zh-CN` et `en-US`.
+- [ ] `defaultsByLocale` contient des prompts affinés pour les deux langues.
+- [ ] Les ressources de couverture et d'aperçu ont été générées par le modèle lui-même.
+- [ ] Attribution `author` incluse lors de l'adaptation d'un travail externe.
+- [ ] `featured: false`, `status: "published"` (ou `draft` avec une note dans la PR).
+
+## Motifs fréquents de rejet
+
+- **Prompt générique** — le modèle n'apporte rien par rapport à un prompt vide ; le sélecteur n'en a pas besoin.
+- **Langue manquante** — une seule langue affinée, ou une traduction automatique ayant perdu les contraintes de style.
+- **Ressources incohérentes** — la couverture ne correspond pas à ce que le prompt génère réellement.
+- **Droits incertains** — adaptation du travail d'autrui sans attribution ni permission.
+- **Ancienne version modifiée sur place** — créez un nouveau dossier de version au lieu de réécrire l'historique de `<id>/1/`.
+
+---
+
+Des questions ? [Ouvrez une issue](https://github.com/krillinai/OpenCreator/issues/new) avec votre idée de modèle et un exemple de résultat, et nous vous aiderons à cadrer.
diff --git a/docs/id/CONTRIBUTING.md b/docs/id/CONTRIBUTING.md
new file mode 100644
index 00000000..eb33ef50
--- /dev/null
+++ b/docs/id/CONTRIBUTING.md
@@ -0,0 +1,67 @@
+# Panduan Kontribusi (Bahasa Indonesia)
+
+> [English](../../CONTRIBUTING.md) | [简体中文](../zh/CONTRIBUTING.md) | [日本語](../ja/CONTRIBUTING.md) | [한국어](../ko/CONTRIBUTING.md) | **Bahasa Indonesia** | [Español](../es/CONTRIBUTING.md) | [Français](../fr/CONTRIBUTING.md) | [Deutsch](../de/CONTRIBUTING.md) | [Português](../pt/CONTRIBUTING.md) | [Русский](../ru/CONTRIBUTING.md) | [العربية](../ar/CONTRIBUTING.md)
+
+Terima kasih telah mempertimbangkan untuk berkontribusi. OpenCreator adalah workspace kreator local-first yang dibangun di atas loop agen Codex, dan sebagian besar nilainya berasal dari tambahan yang kecil dan terfokus: satu folder Skill, satu templat kreasi, satu perbaikan dengan cakupan jelas. Panduan ini menjelaskan di mana setiap jenis kontribusi ditempatkan dan standar apa yang harus dipenuhi PR sebelum digabungkan.
+
+---
+
+## Peta kontribusi
+
+| Jika Anda ingin… | Yang sebenarnya Anda tambahkan | Lokasi | Ukuran pengiriman |
+|---|---|---|---|
+| Memperbaiki bug atau meningkatkan alur kerja | kode | `apps/web/`, `apps/daemon/` | satu PR terfokus dengan pengujian |
+| Menambahkan alur kerja Agen yang dapat digunakan kembali | sebuah **Skill** | [`skills/<skill-anda>/`](../../skills/) | satu folder berisi `SKILL.md` dan referensi opsional → [panduan](./contributing/skills-contributing.md) |
+| Menambahkan preset gambar, video, atau sampul yang dapat digunakan kembali | sebuah **templat kreasi** | [`template/<modul>/<id>/<versi>/`](../../template/) | satu folder berisi `template.json` beserta asetnya → [panduan](./contributing/templates-contributing.md) |
+| Menyumbangkan ilustrasi, ikon, atau desain UI | aset desain | lokasi aset yang disepakati | satu PR dengan pratinjau, file sumber, dan lisensi |
+| Menghubungkan layanan AI atau media | sebuah **integrasi layanan** | modul Web atau Daemon terkait | satu PR dengan penanganan error, keamanan kredensial, dan pengujian |
+| Meningkatkan dokumentasi atau terjemahan | dokumen | `README.md`, `docs/`, `docs/<locale>/README.md` | satu PR |
+
+Jika Anda tidak yakin ide Anda termasuk kategori mana, [buka issue terlebih dahulu](https://github.com/krillinai/OpenCreator/issues/new) dan kami akan mengarahkan Anda ke tempat yang tepat.
+
+---
+
+## Persiapan lokal
+
+Persiapan lengkap ada di [Panduan Cepat README](../../README.md#quick-start). Ringkasan untuk kontributor:
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable # memilih pnpm yang dikunci dari packageManager
+pnpm install
+pnpm web:dev # web + daemon lokal sesuai kebutuhan
+pnpm typecheck # pemeriksaan TypeScript di seluruh repositori
+pnpm test # pengujian unit dan integrasi workspace
+```
+
+Node.js 22+ dan executable Codex CLI diperlukan. Buka `http://127.0.0.1:19861/` setelah `pnpm web:dev`; Runtime menyiapkan proyek default saat pertama kali dijalankan dan composer siap digunakan segera setelah koneksi selesai.
+
+---
+
+## Cara berkontribusi
+
+1. Jelaskan masalah, kasus penggunaan, dan perilaku yang diharapkan dalam [issue](https://github.com/krillinai/OpenCreator/issues).
+2. Buat branch fitur atau perbaikan yang terfokus dari branch pengembangan terbaru.
+3. Ikuti arsitektur yang ada: kemampuan produk umum diimplementasikan **sekali** di Web dan Daemon, dan perbedaan native Desktop diisolasi di balik capability eksplisit (misalnya `canSelectDirectory`).
+4. Tambahkan cakupan pengujian unit, integrasi, atau E2E yang sesuai untuk perubahan perilaku, dan cantumkan verifikasi yang dilakukan maupun yang dilewati dalam PR.
+5. Jangan pernah melakukan commit `.runtime/`, kredensial lokal, sesi Codex, cache build, atau data pengguna lainnya.
+
+## Apa yang diperiksa reviewer
+
+- **Satu implementasi untuk perilaku bersama.** Fitur yang sama tidak boleh diimplementasikan secara terpisah untuk Browser Bridge dan Desktop Bridge.
+- **Capability gating, bukan stub senyap.** Entri khusus platform harus disembunyikan saat capability tidak tersedia — jangan pernah menampilkan tombol yang diam-diam tidak melakukan apa-apa.
+- **Pengujian sesuai risiko perubahan.** Perubahan kecil pada teks atau gaya hanya perlu pemeriksaan terarah; perubahan pada state bersama, persistensi, atau kontrak Runtime memerlukan minimal pengujian modul dan typecheck.
+- **Dokumentasi diperbarui bersama perilaku.** Jika perubahan Anda mengubah alur kerja yang terlihat pengguna, perbarui README atau dokumen terkait di `docs/` dalam PR yang sama.
+
+## Alasan umum PR dikembalikan
+
+- Logika yang sama ditambahkan secara terpisah di jalur Web dan Desktop, bukan di lapisan layanan bersama.
+- Tombol yang tidak didukung platform tetap terlihat, tetapi handler-nya return secara diam-diam.
+- Perilaku berubah tanpa pengujian atau catatan verifikasi.
+- PR mencampur refaktor atau perbaikan yang tidak terkait dengan perubahan utama.
+- File hasil generate, data `.runtime/`, atau kredensial di-commit.
+
+---
+
+OpenCreator · Create locally, work continuously.
diff --git a/docs/id/contributing/skills-contributing.md b/docs/id/contributing/skills-contributing.md
new file mode 100644
index 00000000..b07d3298
--- /dev/null
+++ b/docs/id/contributing/skills-contributing.md
@@ -0,0 +1,96 @@
+# Berkontribusi Skill (Bahasa Indonesia)
+
+> [English](../../contributing/skills-contributing.md) | [简体中文](../../zh/contributing/skills-contributing.md) | [日本語](../../ja/contributing/skills-contributing.md) | [한국어](../../ko/contributing/skills-contributing.md) | **Bahasa Indonesia** | [Español](../../es/contributing/skills-contributing.md) | [Français](../../fr/contributing/skills-contributing.md) | [Deutsch](../../de/contributing/skills-contributing.md) | [Português](../../pt/contributing/skills-contributing.md) | [Русский](../../ru/contributing/skills-contributing.md) | [العربية](../../ar/contributing/skills-contributing.md)
+
+Skill adalah folder di bawah [`skills/`](../../../skills/) dengan `SKILL.md` di root-nya, mengikuti [konvensi `SKILL.md`](https://agentskills.io). Skill mengemas alur kerja Agen yang dapat digunakan kembali: kapan menggunakannya, perintah atau tool apa yang dipanggil, dan cara menafsirkan outputnya. Panduan ini menjelaskan cara menambahkannya.
+
+---
+
+## Apa yang TERMASUK / BUKAN Skill
+
+**Skill TERMASUK:**
+- Alur kerja yang dapat diulang dan dapat diikuti Agen, dijelaskan dalam bahasa alami plus perintah.
+- Pengetahuan domain yang tidak seharusnya ada di kode inti: cara memanggil tahap CLI, cara menyusun prompt untuk penyedia media, cara memvalidasi rencana.
+- Kecil. Satu folder, satu `SKILL.md`, `references/` opsional untuk materi panjang yang dibaca Agen sesuai kebutuhan.
+
+**Skill BUKAN:**
+- Fitur produk. Perubahan UI, endpoint Runtime baru, dan perilaku workspace baru adalah kontribusi kode (`apps/web/`, `apps/daemon/`).
+- Salinan Skill yang ada dengan perubahan redaksional kecil. Jika perubahan Anda meningkatkan alur kerja yang ada, edit Skill tersebut secara langsung.
+- Pembungkus kredensial atau path lokal milik pengguna tertentu. Skill harus berfungsi dari checkout yang bersih.
+
+## Mulai cepat
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable && pnpm install
+cp -r skills/krillinai-tts skills/<skill-anda> # mulai dari Skill yang paling mirip
+# edit skills/<skill-anda>/SKILL.md
+pnpm web:dev # verifikasi Agen mengenalinya dalam percakapan
+```
+
+Cara tercepat adalah menyalin Skill yang paling dekat dengan ide Anda lalu menuliskannya ulang — Skill `krillinai-*` yang ada menunjukkan struktur dan nada yang diharapkan.
+
+## Anatomi Skill
+
+```
+skills/<skill-anda>/
+├── SKILL.md # wajib: frontmatter + instruksi
+└── references/ # opsional: dokumen panjang yang dirujuk SKILL.md
+ └── cli-contract.md
+```
+
+`SKILL.md` diawali dengan frontmatter YAML:
+
+```yaml
+---
+name: skill-anda
+description: Use when <kondisi pemicu>, including <kemampuan utama>.
+---
+```
+
+Dua aturan yang ditegakkan reviewer:
+
+- **`name` harus sama dengan nama folder.** Huruf kecil, dipisah tanda hubung.
+- **`description` adalah permukaan penemuan.** Inilah yang dibaca Agen untuk memutuskan apakah Skill ini relevan. Tulis dengan format "Use when …", sebutkan pemicu dan hasilnya, dan batasi satu atau dua kalimat. Deskripsi yang samar ("membantu dengan video") akan dikembalikan.
+
+Isi harus mencakup, secara berurutan:
+
+1. **Kapan digunakan** — satu paragraf.
+2. **Perintah** — blok kode dengan pemanggilan persis, termasuk variabel lingkungan atau direktori kerja yang diperlukan.
+3. **Input dan flag** — tabel untuk hal yang tidak jelas; tandai wajib vs opsional.
+4. **Output** — di mana hasil disimpan dan cara membacanya (misalnya, "baca path dari manifest").
+5. **Mode kegagalan** — error yang diketahui dan cara mengatasinya.
+
+Jaga `SKILL.md` tetap mudah dipindai. Pindahkan kontrak panjang, daftar flag lengkap, atau materi latar ke `references/` dan tautkan dengan path relatif — Agen hanya membaca referensi saat diperlukan.
+
+## Pengujian lokal
+
+Setelah `pnpm web:dev`, mulai percakapan dan jelaskan tugas yang seharusnya memicu Skill Anda. Verifikasi:
+
+- Agen memilih Skill untuk permintaan yang tepat — dan tidak memilihnya untuk permintaan yang tidak terkait.
+- Perintah dalam Skill berjalan dari checkout bersih tanpa perbaikan manual.
+- Path output dan penanganan error sesuai dengan dokumentasi.
+
+## Standar penggabungan
+
+Reviewer akan memeriksa setiap item berikut — tempelkan ke PR Anda dan centang:
+
+- [ ] Nama folder dan frontmatter `name` cocok; huruf kecil dengan tanda hubung.
+- [ ] `description` menyebutkan kondisi pemicu dan hasil ("Use when …").
+- [ ] Perintah berjalan dari checkout bersih; tanpa path lokal absolut atau kredensial.
+- [ ] Input, output, dan mode kegagalan terdokumentasi.
+- [ ] Materi referensi panjang ada di `references/`, bukan inline.
+- [ ] Terverifikasi dalam percakapan nyata: Skill terpicu saat seharusnya dan hanya saat itu.
+- [ ] Jika Skill tumpang tindih dengan yang sudah ada, PR menjelaskan mengapa Skill terpisah diperlukan.
+
+## Pola penolakan umum
+
+- **Duplikat Skill yang ada** dengan hanya perubahan redaksional kosmetik — tingkatkan yang sudah ada sebagai gantinya.
+- **Fitur yang menyamar** — Skill hanya berfungsi jika disertai perubahan kode pada Runtime atau UI; kirimkan perubahan kode sebagai PR tersendiri.
+- **Perintah yang belum diuji** — flag yang tidak ada, atau output yang tidak cocok dengan path yang terdokumentasi.
+- **Prasyarat tidak terdokumentasi** — Skill diam-diam mengasumsikan konfigurasi penyedia, binary, atau layanan jaringan.
+
+---
+
+Ada pertanyaan? [Buka issue](https://github.com/krillinai/OpenCreator/issues/new) dengan topik `skill` dan kami akan membantu Anda menentukan cakupannya.
diff --git a/docs/id/contributing/templates-contributing.md b/docs/id/contributing/templates-contributing.md
new file mode 100644
index 00000000..5979a1e9
--- /dev/null
+++ b/docs/id/contributing/templates-contributing.md
@@ -0,0 +1,102 @@
+# Berkontribusi Templat Kreasi (Bahasa Indonesia)
+
+> [English](../../contributing/templates-contributing.md) | [简体中文](../../zh/contributing/templates-contributing.md) | [日本語](../../ja/contributing/templates-contributing.md) | [한국어](../../ko/contributing/templates-contributing.md) | **Bahasa Indonesia** | [Español](../../es/contributing/templates-contributing.md) | [Français](../../fr/contributing/templates-contributing.md) | [Deutsch](../../de/contributing/templates-contributing.md) | [Português](../../pt/contributing/templates-contributing.md) | [Русский](../../ru/contributing/templates-contributing.md) | [العربية](../../ar/contributing/templates-contributing.md)
+
+Templat kreasi adalah folder di bawah [`template/<modul>/<id>/<versi>/`](../../../template/) dengan `template.json` dan aset lokalnya. Templat menggerakkan pemilih visual untuk generasi gambar, generasi video, dan generasi sampul — pengguna memulai dari preset Anda, bukan prompt kosong. Panduan ini menjelaskan cara menambahkannya.
+
+---
+
+## Apa yang TERMASUK / BUKAN templat kreasi
+
+**Templat TERMASUK:**
+- Preset yang telah disetel: default prompt, petunjuk gaya, pengaturan rasio/durasi/kualitas, plus sampul dan pratinjau yang menunjukkan hasilnya.
+- Mandiri. Semua yang ditampilkan pemilih ada di dalam folder templat.
+
+**Templat BUKAN:**
+- *Jenis* templat baru. Modul saat ini adalah `image-generation`, `video-generation`, dan `cover-generator`. Jika Anda membutuhkan modul baru, buka issue untuk mendiskusikannya terlebih dahulu — itu adalah perubahan produk, bukan templat.
+- Kumpulan prompt. Templat dengan prompt kosong atau generik dan tanpa default terlokalisasi akan dikembalikan; nilainya ada pada penyetelan.
+- Karya orang lain tanpa hak. Lihat [Atribusi dan hak](#atribusi-dan-hak).
+
+## Mulai cepat
+
+```bash
+corepack enable && pnpm install
+cp -r template/cover-generator/images-go-hard-thumbnail template/<modul>/<id-templat-anda>
+# edit template.json, ganti aset sampul/pratinjau
+pnpm templates:validate # harus lulus sebelum membuka PR
+```
+
+ID templat menggunakan huruf kecil dengan tanda hubung dan unik dalam modulnya. Versi dimulai dari `1` — satu folder per versi, jadi pembaruan membuat `<id>/2/` alih-alih mengedit `<id>/1/`.
+
+## Anatomi folder
+
+```
+template/<modul>/<id>/1/
+├── template.json # wajib: metadata, default, konten terlokalisasi
+├── cover.jpg # wajib: ditampilkan di pemilih templat
+├── preview.jpg # modul gambar/sampul: pratinjau hasil lebih besar
+├── previewVideo # modul video: klip contoh, mis. example.mp4
+└── author-avatar.jpg # opsional: avatar penulis yang dikreditkan
+```
+
+## Panduan kolom template.json
+
+| Kolom | Wajib | Catatan |
+|---|---|---|
+| `schemaVersion` | ya | Saat ini `1`. |
+| `id`, `version`, `module` | ya | Harus cocok dengan path folder `<modul>/<id>/<versi>/`. |
+| `runtimeTemplate` | ya | Memetakan ke eksekutor Runtime, mis. `{"id": "cover", "version": 2}`. Salin dari templat dalam modul yang sama. |
+| `status` | ya | `published` untuk rilis; gunakan `draft` saat iterasi. |
+| `title`, `description` | ya | `zh-CN` dan `en-US` wajib. Bahasa lain opsional. |
+| `cover` | ya | Path relatif ke thumbnail pemilih. |
+| `preview` / `previewVideo` | tergantung modul | `preview` untuk modul gambar dan sampul, `previewVideo` untuk video. |
+| `defaults` | ya | Pengaturan dasar tempat pengguna memulai (prompt, rasio, durasi, kualitas…). |
+| `defaultsByLocale` | sangat dianjurkan | Override prompt dan gaya terlokalisasi per bahasa. Penyetelan sesungguhnya ada di sini — lihat di bawah. |
+| `tags` | dianjurkan | Label yang dapat dicari; jaga tetap faktual. |
+| `author` | jika berlaku | `name`, `url`, `avatar` untuk sumber eksternal yang dikreditkan. |
+| `featured`, `sortOrder` | tidak | Biarkan `featured: false`; maintainer yang memutuskan fitur unggulan. |
+
+## Prompt adalah produknya
+
+Reviewer menghabiskan sebagian besar waktu pada `defaults` dan `defaultsByLocale`:
+
+- **Kedua bahasa harus berupa prompt sungguhan**, bukan terjemahan yang kehilangan penyetelannya. Prompt `zh-CN` dan `en-US` harus menghasilkan hasil yang setara dengan kekuatan frasa masing-masing bahasa.
+- **Parameterkan apa yang memang dimaksudkan untuk berubah.** Jika teks judul atau subjek dapat diedit pengguna, nyatakan secara eksplisit dalam prompt (templat yang ada menggunakan penanda seperti "Customizable text: …").
+- **Nyatakan batasan.** "Tanpa watermark, tanpa teks tambahan, tanpa orang tambahan" — batasan negatif sama pentingnya dengan deskripsi untuk output yang dapat direproduksi.
+- **Cocokkan bentuk `defaults` modul.** Templat gambar membawa ratio/candidateCount/quality; templat video membawa size/duration; templat sampul membawa judul, bahasa teks, dan kolom gaya. Salin bentuknya dari templat yang ada di modul Anda.
+
+## Aset
+
+- Hasilkan `cover.jpg` dan pratinjau **dengan templat itu sendiri** — gambar stok atau karya yang tidak terkait akan ditolak.
+- Jaga ukuran file tetap wajar; file-file ini didistribusikan bersama aplikasi dan dimuat di pemilih.
+- Pratinjau harus mewakili hasil yang *tipikal*, bukan hasil terbaik dari lima puluh percobaan.
+
+## Atribusi dan hak
+
+Jika templat Anda mengadaptasi prompt atau gaya yang dipublikasikan orang lain:
+
+- Anda harus memiliki hak untuk mendistribusikannya kembali.
+- Isi kolom `author` dengan `name` dan `url` (serta `author-avatar.jpg` jika tersedia), seperti yang dilakukan templat yang ada.
+- Jika ragu, buka issue dan tanyakan sebelum mengerjakannya.
+
+## Standar penggabungan
+
+- [ ] Path folder cocok dengan `id`/`version`/`module`; ID unik dalam modul.
+- [ ] `pnpm templates:validate` lulus.
+- [ ] `title` dan `description` tersedia dalam `zh-CN` dan `en-US`.
+- [ ] `defaultsByLocale` berisi prompt yang disetel untuk kedua bahasa.
+- [ ] Aset sampul dan pratinjau dihasilkan oleh templat itu sendiri.
+- [ ] Atribusi `author` disertakan saat mengadaptasi karya eksternal.
+- [ ] `featured: false`, `status: "published"` (atau `draft` dengan catatan di PR).
+
+## Pola penolakan umum
+
+- **Prompt generik** — templat tidak menambahkan apa pun dibanding prompt kosong; pemilih tidak membutuhkannya.
+- **Bahasa hilang** — hanya satu bahasa yang disetel, atau terjemahan mesin yang kehilangan batasan gayanya.
+- **Aset tidak cocok** — sampul tidak sesuai dengan apa yang benar-benar dihasilkan prompt.
+- **Hak tidak jelas** — mengadaptasi karya orang lain tanpa atribusi atau izin.
+- **Versi lama diedit di tempat** — buat folder versi baru alih-alih menulis ulang riwayat `<id>/1/`.
+
+---
+
+Ada pertanyaan? [Buka issue](https://github.com/krillinai/OpenCreator/issues/new) dengan ide templat Anda dan contoh hasilnya, dan kami akan membantu menentukan cakupannya.
diff --git a/docs/ja/CONTRIBUTING.md b/docs/ja/CONTRIBUTING.md
new file mode 100644
index 00000000..1ecfc2a2
--- /dev/null
+++ b/docs/ja/CONTRIBUTING.md
@@ -0,0 +1,67 @@
+# コントリビューションガイド(日本語)
+
+> [English](../../CONTRIBUTING.md) | [简体中文](../zh/CONTRIBUTING.md) | **日本語** | [한국어](../ko/CONTRIBUTING.md) | [Bahasa Indonesia](../id/CONTRIBUTING.md) | [Español](../es/CONTRIBUTING.md) | [Français](../fr/CONTRIBUTING.md) | [Deutsch](../de/CONTRIBUTING.md) | [Português](../pt/CONTRIBUTING.md) | [Русский](../ru/CONTRIBUTING.md) | [العربية](../ar/CONTRIBUTING.md)
+
+OpenCreator への貢献を検討していただきありがとうございます。OpenCreator は Codex エージェントループを基盤としたローカルファーストのクリエイターワークスペースであり、その価値の多くは小さく焦点の絞られた追加——1 つの Skill フォルダ、1 つの作成テンプレート、1 つの範囲の明確な修正——から生まれます。このガイドでは、各種類の貢献をどこに置くべきか、そして PR がマージまでに満たすべき基準を説明します。
+
+---
+
+## コントリビューションマップ
+
+| したいこと | 実際に追加するもの | 場所 | 成果物の規模 |
+|---|---|---|---|
+| バグ修正やワークフロー改善 | コード | `apps/web/`、`apps/daemon/` | テスト付きの焦点を絞った PR 1 件 |
+| 再利用可能なエージェントワークフローの追加 | **Skill** | [`skills/<your-skill>/`](../../skills/) | `SKILL.md` と任意の references を含む 1 フォルダ → [ガイド](./contributing/skills-contributing.md) |
+| 再利用可能な画像・動画・カバープリセットの追加 | **作成テンプレート** | [`template/<module>/<id>/<version>/`](../../template/) | `template.json` とアセットを含む 1 フォルダ → [ガイド](./contributing/templates-contributing.md) |
+| イラスト、アイコン、UI デザインの提供 | デザインアセット | 合意したアセット配置場所 | プレビュー、ソースファイル、ライセンスを含む PR 1 件 |
+| AI またはメディアサービスの接続 | **サービス連携** | 該当する Web または Daemon モジュール | エラーハンドリング、認証情報の安全性、テストを含む PR 1 件 |
+| ドキュメントや翻訳の改善 | ドキュメント | `README.md`、`docs/`、`docs/<locale>/README.md` | PR 1 件 |
+
+自分のアイデアがどの分類に該当するか不明な場合は、まず [Issue を作成](https://github.com/krillinai/OpenCreator/issues/new)してください。適切な場所を案内します。
+
+---
+
+## ローカルセットアップ
+
+完全なセットアップは [README のクイックスタート](../../README.md#quick-start) にあります。コントリビューター向けの要約:
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable # packageManager で固定された pnpm を選択
+pnpm install
+pnpm web:dev # Web + 必要時にローカル daemon を起動
+pnpm typecheck # リポジトリ全体の TypeScript チェック
+pnpm test # ワークスペースのユニット・統合テスト
+```
+
+Node.js 22 以上と Codex CLI 実行ファイルが必要です。`pnpm web:dev` の後に `http://127.0.0.1:19861/` を開いてください。初回起動時に Runtime がデフォルトプロジェクトを自動準備し、接続完了後すぐに入力できるようになります。
+
+---
+
+## 貢献の手順
+
+1. [Issue](https://github.com/krillinai/OpenCreator/issues) で問題、ユースケース、期待される動作を説明する。
+2. 最新の開発ブランチから、焦点を絞った機能・修正ブランチを作成する。
+3. 既存のアーキテクチャに従う:汎用的なプロダクト機能は Web と Daemon で**一度だけ**実装し、Desktop ネイティブの差異は明示的な capability(例:`canSelectDirectory`)で隔離する。
+4. 動作変更には適切なユニット・統合・E2E テストを追加し、PR には実行した検証とスキップした検証の両方を記載する。
+5. `.runtime/`、ローカルの認証情報、Codex セッション、ビルドキャッシュ、その他のユーザーデータをコミットしない。
+
+## レビュアーが確認すること
+
+- **共有動作の実装は 1 つだけ。** 同じ機能を Browser Bridge と Desktop Bridge で個別に実装してはいけません。
+- **サイレントなスタブではなく capability ゲーティング。** capability が利用できない場合、プラットフォーム固有の入口は非表示にする必要があります。何もしないボタンを表示してはいけません。
+- **テストは変更リスクに見合ったものを。** 文言やスタイルの微調整は対象を絞ったチェックのみで構いません。共有状態、永続化、Runtime コントラクトの変更には、最低限モジュールテストと typecheck が必要です。
+- **ドキュメントは動作と一緒に更新。** 変更がユーザーに見えるワークフローを変える場合、同じ PR で README または `docs/` の関連ドキュメントを更新してください。
+
+## PR が差し戻される主な理由
+
+- 同じロジックが共有サービス層ではなく Web と Desktop の両パスに個別に追加されている。
+- プラットフォームがサポートしていないボタンが表示されているが、ハンドラがサイレントに return する。
+- 動作が変更されているのにテストや検証の記載がない。
+- PR に無関係なリファクタリングや修正が混ざっている。
+- 生成物、`.runtime/` データ、認証情報がコミットされている。
+
+---
+
+OpenCreator · Create locally, work continuously.
diff --git a/docs/ja/contributing/skills-contributing.md b/docs/ja/contributing/skills-contributing.md
new file mode 100644
index 00000000..c3e00607
--- /dev/null
+++ b/docs/ja/contributing/skills-contributing.md
@@ -0,0 +1,96 @@
+# Skill を貢献する(日本語)
+
+> [English](../../contributing/skills-contributing.md) | [简体中文](../../zh/contributing/skills-contributing.md) | **日本語** | [한국어](../../ko/contributing/skills-contributing.md) | [Bahasa Indonesia](../../id/contributing/skills-contributing.md) | [Español](../../es/contributing/skills-contributing.md) | [Français](../../fr/contributing/skills-contributing.md) | [Deutsch](../../de/contributing/skills-contributing.md) | [Português](../../pt/contributing/skills-contributing.md) | [Русский](../../ru/contributing/skills-contributing.md) | [العربية](../../ar/contributing/skills-contributing.md)
+
+Skill とは、[`skills/`](../../../skills/) 配下のフォルダで、ルートに `SKILL.md` を持ち、[`SKILL.md` 規約](https://agentskills.io)に従うものです。再利用可能なエージェントワークフロー——いつ使うか、どのコマンドやツールを呼ぶか、出力をどう解釈するか——をパッケージ化します。このガイドでは追加方法を説明します。
+
+---
+
+## Skill であるもの / でないもの
+
+**Skill であるもの:**
+- エージェントが従える再現可能なワークフロー。自然言語とコマンドで記述します。
+- コアコードに属さないドメイン知識:CLI ステージの呼び出し方、メディアプロバイダ向けプロンプトの構成、プランの検証方法。
+- 小さいもの。1 フォルダ、1 つの `SKILL.md`、必要に応じてエージェントがオンデマンドで読む長めの資料用の `references/`。
+
+**Skill でないもの:**
+- プロダクト機能。UI 変更、新しい Runtime エンドポイント、ワークスペースの新しい動作はコード貢献です(`apps/web/`、`apps/daemon/`)。
+- 既存 Skill の文言を変えただけのコピー。変更が既存ワークフローを改善するなら、その Skill を直接編集してください。
+- 認証情報や特定ユーザーのローカルパスを包むラッパー。Skill はクリーンなチェックアウトから動作する必要があります。
+
+## クイックスタート
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable && pnpm install
+cp -r skills/krillinai-tts skills/<your-skill> # 最も近い既存 Skill から始める
+# skills/<your-skill>/SKILL.md を編集
+pnpm web:dev # 会話でエージェントが認識するか確認
+```
+
+最速の方法は、アイデアに最も近い Skill をコピーして書き直すことです。既存の `krillinai-*` Skill が期待される構造とトーンを示しています。
+
+## Skill の構造
+
+```
+skills/<your-skill>/
+├── SKILL.md # 必須:frontmatter + 手順
+└── references/ # 任意:SKILL.md から参照する長文ドキュメント
+ └── cli-contract.md
+```
+
+`SKILL.md` は YAML frontmatter で始まります:
+
+```yaml
+---
+name: your-skill
+description: Use when <発動条件>, including <主な機能>.
+---
+```
+
+レビュアーが徹底する 2 つのルール:
+
+- **`name` はフォルダ名と一致させる。** 小文字、ハイフン区切り。
+- **`description` は発見の入口。** エージェントはこれを読んでこの Skill が適用されるか判断します。"Use when …" の形式で、トリガーと結果を明記し、1〜2 文に収めてください。曖昧な説明(「動画を手伝う」)は差し戻されます。
+
+本文は以下の順序で構成してください:
+
+1. **いつ使うか** —— 1 段落。
+2. **コマンド** —— 必要な環境変数や作業ディレクトリを含む正確な呼び出しをコードブロックで。
+3. **入力とフラグ** —— 自明でないものは表で説明し、必須/任意を明記。
+4. **出力** —— 結果がどこに出力され、どう読むか(例:「manifest からパスを読む」)。
+5. **失敗パターン** —— 既知のエラーと対処方法。
+
+`SKILL.md` は流し読みできる状態に保ってください。長いコントラクト、全フラグのリスト、背景資料は `references/` に移し、相対パスでリンクしてください。エージェントは必要なときだけ references を読みます。
+
+## ローカルでの検証
+
+`pnpm web:dev` の後、会話を開始してその Skill が発動するはずのタスクを記述します。以下を確認:
+
+- 正しいリクエストでエージェントがその Skill を選択し、無関係なリクエストでは選択しない。
+- Skill 内のコマンドがクリーンなチェックアウトから手直しなしで実行できる。
+- 出力パスとエラーハンドリングがドキュメントと一致している。
+
+## マージ基準
+
+レビュアーは以下の全項目を確認します。PR に貼り付けてチェックしてください:
+
+- [ ] フォルダ名と `name` frontmatter が一致。小文字ハイフン区切り。
+- [ ] `description` が発動条件と結果を明示("Use when …")。
+- [ ] コマンドがクリーンなチェックアウトで実行可能。絶対ローカルパスや認証情報を含まない。
+- [ ] 入力、出力、失敗パターンが文書化されている。
+- [ ] 長い参考資料はインラインではなく `references/` にある。
+- [ ] 実際の会話で検証済み:発動すべきときに発動し、それ以外では発動しない。
+- [ ] 既存 Skill と重複する場合、独立した Skill が必要な理由を PR で説明している。
+
+## 主な却下パターン
+
+- **既存 Skill の重複**で、文言の表面的な変更のみ —— 既存の Skill を改善してください。
+- **機能の偽装** —— Runtime や UI のコード変更と組み合わせないと動作しない Skill。コード変更は別の PR として提出してください。
+- **未テストのコマンド** —— 存在しないフラグ、またはドキュメント記載のパスと一致しない出力。
+- **文書化されていない前提条件** —— プロバイダ設定、バイナリ、ネットワークサービスを暗黙に仮定している。
+
+---
+
+質問がありますか? `skill` のトピックで [Issue を作成](https://github.com/krillinai/OpenCreator/issues/new)してください。範囲の調整をお手伝いします。
diff --git a/docs/ja/contributing/templates-contributing.md b/docs/ja/contributing/templates-contributing.md
new file mode 100644
index 00000000..c90c812d
--- /dev/null
+++ b/docs/ja/contributing/templates-contributing.md
@@ -0,0 +1,102 @@
+# 作成テンプレートを貢献する(日本語)
+
+> [English](../../contributing/templates-contributing.md) | [简体中文](../../zh/contributing/templates-contributing.md) | **日本語** | [한국어](../../ko/contributing/templates-contributing.md) | [Bahasa Indonesia](../../id/contributing/templates-contributing.md) | [Español](../../es/contributing/templates-contributing.md) | [Français](../../fr/contributing/templates-contributing.md) | [Deutsch](../../de/contributing/templates-contributing.md) | [Português](../../pt/contributing/templates-contributing.md) | [Русский](../../ru/contributing/templates-contributing.md) | [العربية](../../ar/contributing/templates-contributing.md)
+
+作成テンプレートとは、[`template/<module>/<id>/<version>/`](../../../template/) 配下のフォルダで、`template.json` とローカルアセットを含むものです。テンプレートは画像生成・動画生成・カバー生成のビジュアルピッカーを支え、ユーザーは空白のプロンプトではなくあなたのプリセットから作成を始められます。このガイドでは追加方法を説明します。
+
+---
+
+## 作成テンプレートであるもの / でないもの
+
+**テンプレートであるもの:**
+- 調整済みのプリセット:プロンプトのデフォルト、スタイルのヒント、アスペクト比/長さ/品質の設定、結果を示すカバーとプレビュー。
+- 自己完結型。ピッカーに表示されるすべてがテンプレートフォルダ内にあります。
+
+**テンプレートでないもの:**
+- 新しいテンプレート*種別*。現在のモジュールは `image-generation`、`video-generation`、`cover-generator` です。新しいモジュールが必要な場合は、まず Issue で議論してください。それはプロダクト変更であり、テンプレートではありません。
+- プロンプトの寄せ集め。プロンプトが空または汎用的で、ローカライズされたデフォルトのないテンプレートは差し戻されます。価値は調整にあります。
+- 権利のない他人の作品。[帰属と権利](#帰属と権利)を参照してください。
+
+## クイックスタート
+
+```bash
+corepack enable && pnpm install
+cp -r template/cover-generator/images-go-hard-thumbnail template/<module>/<your-template-id>
+# template.json を編集し、カバー/プレビューアセットを差し替える
+pnpm templates:validate # PR 前に必須
+```
+
+テンプレート ID は小文字ハイフン区切りで、モジュール内で一意です。バージョンは `1` から始めます。1 バージョン 1 フォルダなので、更新時は `<id>/1/` を編集せず `<id>/2/` を作成します。
+
+## フォルダ構造
+
+```
+template/<module>/<id>/1/
+├── template.json # 必須:メタデータ、デフォルト、ローカライズ済みコンテンツ
+├── cover.jpg # 必須:テンプレートピッカーに表示
+├── preview.jpg # 画像/カバーモジュール:大きめの結果プレビュー
+├── previewVideo # 動画モジュール:サンプルクリップ(例:example.mp4)
+└── author-avatar.jpg # 任意:クレジットする作者のアバター
+```
+
+## template.json フィールド説明
+
+| フィールド | 必須 | 備考 |
+|---|---|---|
+| `schemaVersion` | はい | 現在は `1`。 |
+| `id`、`version`、`module` | はい | フォルダパス `<module>/<id>/<version>/` と一致させる。 |
+| `runtimeTemplate` | はい | Runtime 実行エンジンへの対応(例:`{"id": "cover", "version": 2}`)。同モジュールのテンプレートからコピー。 |
+| `status` | はい | 公開は `published`、作業中は `draft`。 |
+| `title`、`description` | はい | `zh-CN` と `en-US` は必須。他言語は任意。 |
+| `cover` | はい | ピッカーのサムネイルへの相対パス。 |
+| `preview` / `previewVideo` | モジュールによる | 画像とカバーは `preview`、動画は `previewVideo`。 |
+| `defaults` | はい | ユーザーが開始する基準設定(プロンプト、比率、長さ、品質など)。 |
+| `defaultsByLocale` | 強く推奨 | ロケールごとのプロンプトとスタイルの上書き。本当の調整はここにあります。下記参照。 |
+| `tags` | 推奨 | 検索可能なラベル。事実ベースで。 |
+| `author` | 該当する場合 | 外部ソースをクレジットする `name`、`url`、`avatar`。 |
+| `featured`、`sortOrder` | いいえ | `featured: false` のまま。フィーチャーするかはメンテナーが決定。 |
+
+## プロンプトこそがプロダクト
+
+レビュアーはほとんどの時間を `defaults` と `defaultsByLocale` に費やします:
+
+- **両言語とも本物のプロンプトであること。** 調整が失われた翻訳は不可。`zh-CN` と `en-US` のプロンプトは、それぞれの言語の強みを活かしつつ同等の結果を生成すべきです。
+- **変更されるべき部分をパラメータ化する。** 見出しテキストや被写体がユーザー編集可能なら、プロンプト内で明示してください(既存テンプレートは "Customizable text: …" のようなマーカーを使用)。
+- **制約を明記する。** 「透かしなし、余分なテキストなし、余分な人物なし」——再現可能な出力には、否定的制約が記述と同じくらい重要です。
+- **モジュールの defaults 構造に合わせる。** 画像テンプレートは ratio/candidateCount/quality、動画は size/duration、カバーは見出し・テキスト言語・スタイルフィールドを持ちます。同モジュールの既存テンプレートから構造をコピーしてください。
+
+## アセット
+
+- `cover.jpg` とプレビューは**テンプレート自身で生成**してください。ストック画像や無関係なアートワークは却下されます。
+- ファイルサイズは適切に。これらのファイルはアプリに同梱され、ピッカーで読み込まれます。
+- プレビューは 50 回中の最高の 1 枚ではなく、*典型的な*結果を表してください。
+
+## 帰属と権利
+
+テンプレートが他人の公開済みプロンプトやスタイルを改変したものである場合:
+
+- 再配布する権利が必要です。
+- 既存テンプレートと同様に、`author` フィールドに `name` と `url`(あれば `author-avatar.jpg`)を記入してください。
+- 不明な場合は、作業に着手する前に Issue で質問してください。
+
+## マージ基準
+
+- [ ] フォルダパスが `id`/`version`/`module` と一致。ID はモジュール内で一意。
+- [ ] `pnpm templates:validate` がパスする。
+- [ ] `title` と `description` が `zh-CN` と `en-US` の両方で提供されている。
+- [ ] `defaultsByLocale` に両言語で調整済みのプロンプトが含まれている。
+- [ ] カバーとプレビューのアセットがテンプレート自身で生成されている。
+- [ ] 外部作品を改変した場合に `author` の帰属がある。
+- [ ] `featured: false`、`status: "published"`(または `draft` で PR に注記)。
+
+## 主な却下パターン
+
+- **汎用的なプロンプト** —— 空白のプロンプトと比べて付加価値がない。ピッカーに不要です。
+- **言語の欠落** —— 片方の言語しか調整されていない、または機械翻訳でスタイル制約が失われている。
+- **アセットの不一致** —— カバーがプロンプトの実際の生成結果と合っていない。
+- **権利が不明確** —— 帰属や許可なく他人の作品を改変している。
+- **旧バージョンの上書き** —— `<id>/1/` の履歴を書き換えるのではなく、新しいバージョンフォルダを作成してください。
+
+---
+
+質問がありますか? テンプレートのアイデアとサンプル出力を添えて [Issue を作成](https://github.com/krillinai/OpenCreator/issues/new)してください。範囲の調整をお手伝いします。
diff --git a/docs/ko/CONTRIBUTING.md b/docs/ko/CONTRIBUTING.md
new file mode 100644
index 00000000..b0dc27c4
--- /dev/null
+++ b/docs/ko/CONTRIBUTING.md
@@ -0,0 +1,67 @@
+# 기여 가이드 (한국어)
+
+> [English](../../CONTRIBUTING.md) | [简体中文](../zh/CONTRIBUTING.md) | [日本語](../ja/CONTRIBUTING.md) | **한국어** | [Bahasa Indonesia](../id/CONTRIBUTING.md) | [Español](../es/CONTRIBUTING.md) | [Français](../fr/CONTRIBUTING.md) | [Deutsch](../de/CONTRIBUTING.md) | [Português](../pt/CONTRIBUTING.md) | [Русский](../ru/CONTRIBUTING.md) | [العربية](../ar/CONTRIBUTING.md)
+
+OpenCreator에 기여해 주셔서 감사합니다. OpenCreator는 Codex 에이전트 루프 위에 구축된 로컬 우선 크리에이터 워크스페이스이며, 프로젝트 가치의 대부분은 작고 집중된 추가 — Skill 폴터 하나, 생성 템플릿 하나, 범위가 명확한 수정 하나 — 에서 나옵니다. 이 가이드는 각 유형의 기여가 어디에 위치해야 하는지, 그리고 PR이 머지되기 전에 충족해야 하는 기준을 설명합니다.
+
+---
+
+## 기여 지도
+
+| 원하는 작업 | 실제로 추가하는 것 | 위치 | 전달 규모 |
+|---|---|---|---|
+| 버그 수정 또는 워크플로 개선 | 코드 | `apps/web/`, `apps/daemon/` | 테스트를 포함한 집중된 PR 1개 |
+| 재사용 가능한 에이전트 워크플로 추가 | **Skill** | [`skills/<your-skill>/`](../../skills/) | `SKILL.md`와 선택적 references가 포함된 폴터 1개 → [가이드](./contributing/skills-contributing.md) |
+| 재사용 가능한 이미지/비디오/커버 프리셋 추가 | **생성 템플릿** | [`template/<module>/<id>/<version>/`](../../template/) | `template.json`과 에셋이 포함된 폴터 1개 → [가이드](./contributing/templates-contributing.md) |
+| 일러스트, 아이콘, UI 디자인 기여 | 디자인 에셋 | 합의된 에셋 위치 | 미리보기, 소스 파일, 라이선스가 포함된 PR 1개 |
+| AI 또는 미디어 서비스 연동 | **서비스 통합** | 관련 Web 또는 Daemon 모듈 | 오류 처리, 자격 증명 보안, 테스트가 포함된 PR 1개 |
+| 문서 또는 번역 개선 | 문서 | `README.md`, `docs/`, `docs/<locale>/README.md` | PR 1개 |
+
+아이디어가 어느 분류에 해당하는지 확실하지 않다면, 먼저 [이슈를 열어](https://github.com/krillinai/OpenCreator/issues/new) 주세요. 적절한 위치를 안내해 드리겠습니다.
+
+---
+
+## 로컬 설정
+
+전체 설정은 [README 빠른 시작](../../README.md#quick-start)에 있습니다. 기여자를 위한 요약:
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable # packageManager에 고정된 pnpm 선택
+pnpm install
+pnpm web:dev # Web + 필요 시 로컬 daemon 실행
+pnpm typecheck # 저장소 전체 TypeScript 검사
+pnpm test # 워크스페이스 단위 및 통합 테스트
+```
+
+Node.js 22 이상과 Codex CLI 실행 파일이 필요합니다. `pnpm web:dev` 후 `http://127.0.0.1:19861/`을 여세요. 첫 실행 시 Runtime이 기본 프로젝트를 자동으로 준비하며, 연결이 완료되면 바로 입력할 수 있습니다.
+
+---
+
+## 기여 방법
+
+1. [이슈](https://github.com/krillinai/OpenCreator/issues)에서 문제, 사용 사례, 기대 동작을 설명합니다.
+2. 최신 개발 브랜치에서 집중된 기능 또는 수정 브랜치를 생성합니다.
+3. 기존 아키텍처를 따릅니다: 범용 제품 기능은 Web과 Daemon에서 **한 번만** 구현하고, Desktop 네이티브 차이는 명시적 capability(예: `canSelectDirectory`)로 분리합니다.
+4. 동작 변경에는 적절한 단위, 통합 또는 E2E 테스트를 추가하고, PR에 수행한 검증과 건너뛴 검증을 모두 나열합니다.
+5. `.runtime/`, 로컬 자격 증명, Codex 세션, 빌드 캐시 또는 기타 사용자 데이터를 절대 커밋하지 않습니다.
+
+## 리뷰어가 확인하는 사항
+
+- **공유 동작은 단일 구현.** 동일한 기능을 Browser Bridge와 Desktop Bridge에 각각 구현해서는 안 됩니다.
+- **조용한 스텁이 아닌 capability 게이팅.** capability를 사용할 수 없을 때 플랫폼 전용 진입점은 숨겨야 하며, 클릭필도 아무 반응이 없는 버튼을 표시해서는 안 됩니다.
+- **테스트는 변경 위험도에 맞게.** 작은 문구나 스타일 조정은 대상 검사만으로 충분하며, 공유 상태, 영속성, Runtime 계약 변경은 최소 모듈 테스트와 typecheck가 필요합니다.
+- **문서는 동작과 함께 업데이트.** 변경이 사용자에게 보이는 워크플로를 바꾼다면 같은 PR에서 README나 `docs/`의 관련 문서를 업데이트하세요.
+
+## PR이 반려되는 일반적인 이유
+
+- 동일한 로직이 공유 서비스 레이어가 아닌 Web과 Desktop 경로에 각각 추가됨.
+- 플랫폼이 지원하지 않는 버튼이 보이지만 핸들러가 조용히 return함.
+- 동작이 변경되었지만 테스트나 검증 설명이 없음.
+- PR에 무관한 리팩터링이나 수정이 섞여 있음.
+- 생성된 파일, `.runtime/` 데이터 또는 자격 증명이 커밋됨.
+
+---
+
+OpenCreator · Create locally, work continuously.
diff --git a/docs/ko/contributing/skills-contributing.md b/docs/ko/contributing/skills-contributing.md
new file mode 100644
index 00000000..0f45c866
--- /dev/null
+++ b/docs/ko/contributing/skills-contributing.md
@@ -0,0 +1,96 @@
+# Skill 기여하기 (한국어)
+
+> [English](../../contributing/skills-contributing.md) | [简体中文](../../zh/contributing/skills-contributing.md) | [日本語](../../ja/contributing/skills-contributing.md) | **한국어** | [Bahasa Indonesia](../../id/contributing/skills-contributing.md) | [Español](../../es/contributing/skills-contributing.md) | [Français](../../fr/contributing/skills-contributing.md) | [Deutsch](../../de/contributing/skills-contributing.md) | [Português](../../pt/contributing/skills-contributing.md) | [Русский](../../ru/contributing/skills-contributing.md) | [العربية](../../ar/contributing/skills-contributing.md)
+
+Skill은 [`skills/`](../../../skills/) 아래의 폴터로, 루트에 `SKILL.md`를 두고 [`SKILL.md` 규약](https://agentskills.io)을 따릅니다. 재사용 가능한 에이전트 워크플로 — 언제 사용하는지, 어떤 명령이나 도구를 호출하는지, 출력을 어떻게 해석하는지 — 를 패키징합니다. 이 가이드는 Skill을 추가하는 방법을 안내합니다.
+
+---
+
+## Skill인 것 / 아닌 것
+
+**Skill인 것:**
+- 에이전트가 따를 수 있는 반복 가능한 워크플로로, 자연어와 명령으로 설명합니다.
+- 코어 코드에 속하지 않는 도메인 지식: CLI 단계 호출 방법, 미디어 제공자용 프롬프트 구성 방법, 플랜 검증 방법.
+- 작은 것. 폴터 하나, `SKILL.md` 하나, 에이전트가 필요할 때 읽는 긴 자료를 위한 선택적 `references/`.
+
+**Skill이 아닌 것:**
+- 제품 기능. UI 변경, 새로운 Runtime 엔드포인트, 새로운 워크스페이스 동작은 코드 기여입니다(`apps/web/`, `apps/daemon/`).
+- 기존 Skill의 표현만 살짝 바꾼 복사본. 변경이 기존 워크플로를 개선한다면 해당 Skill을 직접 수정하세요.
+- 자격 증명이나 특정 사용자의 로컬 경로를 감싸는 래퍼. Skill은 깨끗한 체크아웃에서 동작해야 합니다.
+
+## 빠른 시작
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable && pnpm install
+cp -r skills/krillinai-tts skills/<your-skill> # 가장 비슷한 기존 Skill에서 시작
+# skills/<your-skill>/SKILL.md 편집
+pnpm web:dev # 대화에서 에이전트가 인식하는지 확인
+```
+
+가장 빠른 방법은 아이디어와 가장 비슷한 Skill을 복사해 다시 작성하는 것입니다. 기존 `krillinai-*` Skill들이 기대되는 구조와 어조를 보여줍니다.
+
+## Skill 구조
+
+```
+skills/<your-skill>/
+├── SKILL.md # 필수: frontmatter + 지침
+└── references/ # 선택: SKILL.md가 가리키는 긴 문서
+ └── cli-contract.md
+```
+
+`SKILL.md`는 YAML frontmatter로 시작합니다:
+
+```yaml
+---
+name: your-skill
+description: Use when <트리거 조건>, including <주요 기능>.
+---
+```
+
+리뷰어가 적용하는 두 가지 규칙:
+
+- **`name`은 폴터 이름과 일치해야 합니다.** 소문자, 하이픈 구분.
+- **`description`은 발견의 표면입니다.** 에이전트가 이 Skill의 적용 여부를 결정할 때 읽는 내용입니다. "Use when …" 형태로 작성하고, 트리거와 결과를 명시하며, 한두 문장으로 유지하세요. 모호한 설명("비디오에 도움")은 반려됩니다.
+
+본문은 다음 순서로 구성하세요:
+
+1. **언제 사용하는가** — 한 단락.
+2. **명령** — 필요한 환경 변수나 작업 디렉터리를 포함한 정확한 호출을 코드 블록으로.
+3. **입력과 플래그** — 자명하지 않은 것은 표로 정리하고 필수/선택을 표시.
+4. **출력** — 결과가 어디에 생성되고 어떻게 읽는지(예: "manifest에서 경로 읽기").
+5. **실패 모드** — 알려진 오류와 대처 방법.
+
+`SKILL.md`는 훑어보기 쉽게 유지하세요. 긴 계약, 전체 플래그 목록, 배경 자료는 `references/`로 옮기고 상대 경로로 링크하세요. 에이전트는 필요할 때만 references를 읽습니다.
+
+## 로컬 검증
+
+`pnpm web:dev` 후 대화를 시작하고 Skill이 트리거되어야 할 작업을 설명하세요. 확인 사항:
+
+- 에이전트가 올바른 요청에 Skill을 선택하고, 무관한 요청에는 선택하지 않는가.
+- Skill의 명령이 깨끗한 체크아웃에서 수동 수정 없이 실행되는가.
+- 출력 경로와 오류 처리가 문서와 일치하는가.
+
+## 머지 기준
+
+리뷰어는 아래 모든 항목을 확인합니다. PR에 붙여넣고 체크하세요:
+
+- [ ] 폴터 이름과 `name` frontmatter가 일치. 소문자 하이픈 구분.
+- [ ] `description`이 트리거 조건과 결과를 명시("Use when …").
+- [ ] 명령이 깨끗한 체크아웃에서 실행됨. 절대 로컬 경로나 자격 증명 없음.
+- [ ] 입력, 출력, 실패 모드가 문서화됨.
+- [ ] 긴 참고 자료가 인라인이 아닌 `references/`에 있음.
+- [ ] 실제 대화에서 검증됨: 트리거되어야 할 때만 트리거됨.
+- [ ] 기존 Skill과 중복되는 경우 별도 Skill이 필요한 이유를 PR에서 설명.
+
+## 일반적인 반려 패턴
+
+- **기존 Skill의 중복** — 표현상의 미세한 변경만 있는 경우. 대신 기존 Skill을 개선하세요.
+- **기능의 위장** — Runtime이나 UI 코드 변경과 함께해야만 동작하는 Skill. 코드 변경은 별도 PR로 제출하세요.
+- **테스트되지 않은 명령** — 존재하지 않는 플래그, 문서에 명시된 경로와 일치하지 않는 출력.
+- **문서화되지 않은 전제 조건** — 제공자 설정, 바이너리, 네트워크 서비스를 암묵적으로 가정.
+
+---
+
+질문이 있으신가요? `skill` 주제로 [이슈를 열어](https://github.com/krillinai/OpenCreator/issues/new) 주시면 범위 조정을 도와드리겠습니다.
diff --git a/docs/ko/contributing/templates-contributing.md b/docs/ko/contributing/templates-contributing.md
new file mode 100644
index 00000000..fffa6b33
--- /dev/null
+++ b/docs/ko/contributing/templates-contributing.md
@@ -0,0 +1,102 @@
+# 생성 템플릿 기여하기 (한국어)
+
+> [English](../../contributing/templates-contributing.md) | [简体中文](../../zh/contributing/templates-contributing.md) | [日本語](../../ja/contributing/templates-contributing.md) | **한국어** | [Bahasa Indonesia](../../id/contributing/templates-contributing.md) | [Español](../../es/contributing/templates-contributing.md) | [Français](../../fr/contributing/templates-contributing.md) | [Deutsch](../../de/contributing/templates-contributing.md) | [Português](../../pt/contributing/templates-contributing.md) | [Русский](../../ru/contributing/templates-contributing.md) | [العربية](../../ar/contributing/templates-contributing.md)
+
+생성 템플릿은 [`template/<module>/<id>/<version>/`](../../../template/) 아래의 폴터로, `template.json`과 로컬 에셋을 포함합니다. 템플릿은 이미지 생성, 비디오 생성, 커버 생성의 비주얼 선택기를 구동하며, 사용자는 빈 프롬프트 대신 당신의 프리셋에서 시작합니다. 이 가이드는 템플릿을 추가하는 방법을 안내합니다.
+
+---
+
+## 생성 템플릿인 것 / 아닌 것
+
+**템플릿인 것:**
+- 조정된 프리셋: 프롬프트 기본값, 스타일 힌트, 비율/길이/품질 설정, 결과를 보여주는 커버와 미리보기.
+- 자급자족적. 선택기가 표시하는 모든 것이 템플릿 폴터 안에 있습니다.
+
+**템플릿이 아닌 것:**
+- 새로운 템플릿 *유형*. 현재 모듈은 `image-generation`, `video-generation`, `cover-generator`입니다. 새 모듈이 필요하면 먼저 이슈에서 논의하세요. 그것은 제품 변경이지 템플릿이 아닙니다.
+- 프롬프트 모음. 프롬프트가 비어 있거나 일반적이고 현지화된 기본값이 없는 템플릿은 반려됩니다. 가치는 조정에 있습니다.
+- 권리 없는 타인의 작업. [저작자 표시와 권리](#저작자-표시와-권리)를 참조하세요.
+
+## 빠른 시작
+
+```bash
+corepack enable && pnpm install
+cp -r template/cover-generator/images-go-hard-thumbnail template/<module>/<your-template-id>
+# template.json 편집, 커버/미리보기 에셋 교체
+pnpm templates:validate # PR 전에 반드시 통과
+```
+
+템플릿 ID는 소문자 하이픈 구분이며 모듈 내에서 고유합니다. 버전은 `1`부터 시작하며, 버전당 폴터 하나이므로 업데이트는 `<id>/1/`을 수정하는 대신 `<id>/2/`를 생성합니다.
+
+## 폴터 구조
+
+```
+template/<module>/<id>/1/
+├── template.json # 필수: 메타데이터, 기본값, 현지화 콘텐츠
+├── cover.jpg # 필수: 템플릿 선택기에 표시
+├── preview.jpg # 이미지/커버 모듈: 더 큰 결과 미리보기
+├── previewVideo # 비디오 모듈: 예시 클립 (예: example.mp4)
+└── author-avatar.jpg # 선택: 저작자 아바타
+```
+
+## template.json 필드 설명
+
+| 필드 | 필수 | 참고 |
+|---|---|---|
+| `schemaVersion` | 예 | 현재 `1`. |
+| `id`, `version`, `module` | 예 | 폴터 경로 `<module>/<id>/<version>/`와 일치해야 함. |
+| `runtimeTemplate` | 예 | Runtime 실행기에 대응 (예: `{"id": "cover", "version": 2}`). 같은 모듈의 템플릿에서 복사. |
+| `status` | 예 | 게시는 `published`, 작업 중에는 `draft`. |
+| `title`, `description` | 예 | `zh-CN`과 `en-US` 필수. 다른 언어는 선택. |
+| `cover` | 예 | 선택기 썸네일의 상대 경로. |
+| `preview` / `previewVideo` | 모듈에 따라 | 이미지와 커버는 `preview`, 비디오는 `previewVideo`. |
+| `defaults` | 예 | 사용자가 시작하는 기준 설정 (프롬프트, 비율, 길이, 품질 등). |
+| `defaultsByLocale` | 강력 권장 | 로케일별 프롬프트와 스타일 재정의. 실제 조정이 여기에 있습니다. 아래 참조. |
+| `tags` | 권장 | 검색 가능한 라벨. 사실적으로 유지. |
+| `author` | 해당 시 | 외부 출처를 표시하는 `name`, `url`, `avatar`. |
+| `featured`, `sortOrder` | 아니오 | `featured: false` 유지. 추천 여부는 메인테이너가 결정. |
+
+## 프롬프트가 곧 제품
+
+리뷰어는 대부분의 시간을 `defaults`와 `defaultsByLocale`에 씁니다:
+
+- **두 언어 모두 실제 프롬프트여야 합니다.** 조정이 손실된 번역은 안 됩니다. `zh-CN`과 `en-US` 프롬프트는 각 언어의 장점을 살리면서 동등한 결과를 생성해야 합니다.
+- **변경되어야 할 부분을 매개변수화하세요.** 헤드라인 텍스트나 주제가 사용자 편집 가능하다면 프롬프트에서 명시하세요(기존 템플릿은 "Customizable text: …" 같은 마커 사용).
+- **제약을 명시하세요.** "워터마크 없음, 추가 텍스트 없음, 추가 인물 없음" — 재현 가능한 출력에는 부정적 제약이 설명만큼 중요합니다.
+- **모듈의 defaults 구조에 맞추세요.** 이미지 템플릿은 ratio/candidateCount/quality, 비디오는 size/duration, 커버는 헤드라인, 텍스트 언어, 스타일 필드를 가집니다. 같은 모듈의 기존 템플릿에서 구조를 복사하세요.
+
+## 에셋
+
+- `cover.jpg`와 미리보기는 **템플릿 자체로 생성**하세요. 스톡 이미지나 무관한 아트워크는 반려됩니다.
+- 파일 크기를 적절히 유지하세요. 이 파일들은 앱과 함께 배포되고 선택기에서 로드됩니다.
+- 미리보기는 50번 중 최고가 아니라 *일반적인* 결과를 보여주세요.
+
+## 저작자 표시와 권리
+
+템플릿이 타인의 공개된 프롬프트나 스타일을 각색한 경우:
+
+- 재배포할 권리가 있어야 합니다.
+- 기존 템플릿처럼 `author` 필드에 `name`과 `url`(가능하면 `author-avatar.jpg`)을 채우세요.
+- 확실하지 않으면 작업 전에 이슈를 열어 문의하세요.
+
+## 머지 기준
+
+- [ ] 폴터 경로가 `id`/`version`/`module`과 일치. ID가 모듈 내에서 고유.
+- [ ] `pnpm templates:validate` 통과.
+- [ ] `title`과 `description`이 `zh-CN`과 `en-US`로 제공됨.
+- [ ] `defaultsByLocale`에 두 언어로 조정된 프롬프트 포함.
+- [ ] 커버와 미리보기 에셋이 템플릿 자체로 생성됨.
+- [ ] 외부 작업 각색 시 `author` 표시 포함.
+- [ ] `featured: false`, `status: "published"` (또는 `draft`와 PR에 메모).
+
+## 일반적인 반려 패턴
+
+- **일반적인 프롬프트** — 빈 프롬프트 대비 부가 가치가 없음. 선택기에 불필요.
+- **언어 누락** — 한 언어만 조정되었거나 기계 번역으로 스타일 제약이 손실됨.
+- **에셋 불일치** — 커버가 프롬프트의 실제 생성 결과와 맞지 않음.
+- **불분명한 권리** — 저작자 표시나 허가 없이 타인의 작업을 각색.
+- **이전 버전 덮어쓰기** — `<id>/1/`의 이력을 다시 쓰는 대신 새 버전 폴터를 생성하세요.
+
+---
+
+질문이 있으신가요? 템플릿 아이디어와 샘플 출력을 첨부해 [이슈를 열어](https://github.com/krillinai/OpenCreator/issues/new) 주시면 범위 조정을 도와드리겠습니다.
diff --git a/docs/pt/CONTRIBUTING.md b/docs/pt/CONTRIBUTING.md
new file mode 100644
index 00000000..1e557341
--- /dev/null
+++ b/docs/pt/CONTRIBUTING.md
@@ -0,0 +1,67 @@
+# Guia de contribuição (Português)
+
+> [English](../../CONTRIBUTING.md) | [简体中文](../zh/CONTRIBUTING.md) | [日本語](../ja/CONTRIBUTING.md) | [한국어](../ko/CONTRIBUTING.md) | [Bahasa Indonesia](../id/CONTRIBUTING.md) | [Español](../es/CONTRIBUTING.md) | [Français](../fr/CONTRIBUTING.md) | [Deutsch](../de/CONTRIBUTING.md) | **Português** | [Русский](../ru/CONTRIBUTING.md) | [العربية](../ar/CONTRIBUTING.md)
+
+Obrigado por pensar em contribuir. O OpenCreator é um workspace local-first para criadores construído sobre o loop do agente Codex, e a maior parte do seu valor vem de adições pequenas e focadas: uma pasta de Skill, um template de criação, uma correção bem delimitada. Este guia indica onde cada tipo de contribuição deve ficar e quais critérios um PR precisa cumprir antes de ser mesclado.
+
+---
+
+## Mapa de contribuições
+
+| Se você quer… | Você está na verdade adicionando | Onde fica | Tamanho da entrega |
+|---|---|---|---|
+| Corrigir um bug ou melhorar um fluxo de trabalho | código | `apps/web/`, `apps/daemon/` | um PR focado com testes |
+| Adicionar um fluxo de trabalho reutilizável para o agente | um **Skill** | [`skills/<seu-skill>/`](../../skills/) | uma pasta com `SKILL.md` e referências opcionais → [guia](./contributing/skills-contributing.md) |
+| Adicionar um preset reutilizável de imagem, vídeo ou capa | um **template de criação** | [`template/<módulo>/<id>/<versão>/`](../../template/) | uma pasta com `template.json` e seus recursos → [guia](./contributing/templates-contributing.md) |
+| Contribuir ilustrações, ícones ou designs de UI | recursos de design | local de recursos combinado | um PR com prévias, arquivos-fonte e licença |
+| Integrar um serviço de IA ou mídia | uma **integração de serviço** | módulo Web ou Daemon relevante | um PR com tratamento de erros, segurança de credenciais e testes |
+| Melhorar documentação ou traduções | docs | `README.md`, `docs/`, `docs/<locale>/README.md` | um PR |
+
+Se você não tem certeza em qual categoria sua ideia se encaixa, [abra uma issue primeiro](https://github.com/krillinai/OpenCreator/issues/new) e nós indicaremos o lugar certo.
+
+---
+
+## Configuração local
+
+A configuração completa está no [início rápido do README](../../README.md#quick-start). Resumo para contribuidores:
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable # seleciona o pnpm fixado em packageManager
+pnpm install
+pnpm web:dev # web + daemon local sob demanda
+pnpm typecheck # verificações de TypeScript em todo o repositório
+pnpm test # testes unitários e de integração do workspace
+```
+
+Node.js 22+ e um executável do Codex CLI são necessários. Abra `http://127.0.0.1:19861/` após `pnpm web:dev`; o Runtime prepara um projeto padrão na primeira execução e o editor fica pronto assim que a conexão é concluída.
+
+---
+
+## Como contribuir
+
+1. Descreva o problema, o caso de uso e o comportamento esperado em uma [issue](https://github.com/krillinai/OpenCreator/issues).
+2. Crie uma branch focada de funcionalidade ou correção a partir da branch de desenvolvimento mais recente.
+3. Siga a arquitetura existente: capacidades gerais do produto são implementadas **uma única vez** em Web e Daemon, e as diferenças nativas do Desktop são isoladas atrás de capabilities explícitas (por exemplo `canSelectDirectory`).
+4. Adicione cobertura de testes unitários, de integração ou E2E apropriada para mudanças de comportamento, e liste no PR tanto as verificações realizadas quanto as omitidas.
+5. Nunca faça commit de `.runtime/`, credenciais locais, sessões do Codex, caches de build ou outros dados de usuário.
+
+## O que os revisores verificam
+
+- **Uma única implementação para comportamento compartilhado.** A mesma funcionalidade não deve ser implementada separadamente para Browser Bridge e Desktop Bridge.
+- **Controle por capabilities, não stubs silenciosos.** Uma entrada específica de plataforma deve ser ocultada quando a capability não está disponível — nunca exibir um botão que silenciosamente não faz nada.
+- **Testes proporcionais ao risco da mudança.** Pequenos ajustes de texto ou estilo precisam apenas de verificações direcionadas; mudanças em estado compartilhado, persistência ou contratos do Runtime exigem no mínimo testes de módulo e typecheck.
+- **Documentação atualizada junto com o comportamento.** Se sua mudança altera um fluxo visível ao usuário, atualize o README ou o documento relevante em `docs/` no mesmo PR.
+
+## Motivos comuns de devolução de PRs
+
+- A mesma lógica foi adicionada separadamente nos caminhos Web e Desktop em vez da camada de serviço compartilhada.
+- Um botão não suportado pela plataforma está visível, mas seu handler retorna silenciosamente.
+- Comportamento alterado sem testes ou nota de verificação.
+- O PR mistura uma refatoração ou correção não relacionada à mudança principal.
+- Arquivos gerados, dados de `.runtime/` ou credenciais foram commitados.
+
+---
+
+OpenCreator · Create locally, work continuously.
diff --git a/docs/pt/contributing/skills-contributing.md b/docs/pt/contributing/skills-contributing.md
new file mode 100644
index 00000000..aa7bbfca
--- /dev/null
+++ b/docs/pt/contributing/skills-contributing.md
@@ -0,0 +1,96 @@
+# Contribuindo um Skill (Português)
+
+> [English](../../contributing/skills-contributing.md) | [简体中文](../../zh/contributing/skills-contributing.md) | [日本語](../../ja/contributing/skills-contributing.md) | [한국어](../../ko/contributing/skills-contributing.md) | [Bahasa Indonesia](../../id/contributing/skills-contributing.md) | [Español](../../es/contributing/skills-contributing.md) | [Français](../../fr/contributing/skills-contributing.md) | [Deutsch](../../de/contributing/skills-contributing.md) | **Português** | [Русский](../../ru/contributing/skills-contributing.md) | [العربية](../../ar/contributing/skills-contributing.md)
+
+Um Skill é uma pasta dentro de [`skills/`](../../../skills/) com um `SKILL.md` na raiz, seguindo a [convenção `SKILL.md`](https://agentskills.io). Ele empacota um fluxo de trabalho reutilizável para o agente: quando usá-lo, quais comandos ou ferramentas chamar e como interpretar as saídas. Este guia mostra como adicionar um.
+
+---
+
+## O que um Skill É / NÃO É
+
+**Um Skill É:**
+- Um fluxo de trabalho repetível que o agente pode seguir, descrito em linguagem natural mais comandos.
+- Conhecimento de domínio que não pertence ao código central: como invocar uma etapa de CLI, como estruturar um prompt para um provedor de mídia, como validar um plano.
+- Pequeno. Uma pasta, um `SKILL.md`, `references/` opcional para material mais longo que o agente lê sob demanda.
+
+**Um Skill NÃO É:**
+- Uma funcionalidade de produto. Mudanças de UI, novos endpoints do Runtime e novos comportamentos do workspace são contribuições de código (`apps/web/`, `apps/daemon/`).
+- Uma cópia de um Skill existente com redação levemente alterada. Se sua mudança melhora um fluxo existente, edite esse Skill diretamente.
+- Um invólucro em torno de credenciais ou caminhos locais de um usuário específico. Skills devem funcionar a partir de um checkout limpo.
+
+## Início rápido
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable && pnpm install
+cp -r skills/krillinai-tts skills/<seu-skill> # comece pelo Skill existente mais próximo
+# edite skills/<seu-skill>/SKILL.md
+pnpm web:dev # verifique se o agente o reconhece em uma conversa
+```
+
+O caminho mais rápido é copiar o Skill mais próximo da sua ideia e reescrevê-lo — os Skills `krillinai-*` existentes mostram a estrutura e o tom esperados.
+
+## Anatomia de um Skill
+
+```
+skills/<seu-skill>/
+├── SKILL.md # obrigatório: frontmatter + instruções
+└── references/ # opcional: docs longos apontados pelo SKILL.md
+ └── cli-contract.md
+```
+
+O `SKILL.md` começa com frontmatter YAML:
+
+```yaml
+---
+name: seu-skill
+description: Use when <condição de ativação>, including <capacidades principais>.
+---
+```
+
+Duas regras que os revisores aplicam:
+
+- **`name` deve corresponder ao nome da pasta.** Minúsculas, com hífens.
+- **`description` é a superfície de descoberta.** É o que o agente lê para decidir se este Skill se aplica. Escreva como "Use when …", nomeie o gatilho e o resultado, e mantenha em uma ou duas frases. Descrições vagas ("ajuda com vídeo") são devolvidas.
+
+O corpo deve cobrir, nesta ordem:
+
+1. **Quando usar** — um parágrafo.
+2. **Comandos** — blocos de código com a invocação exata, incluindo variáveis de ambiente ou diretórios de trabalho necessários.
+3. **Entradas e flags** — uma tabela para o que não é óbvio; marque obrigatório vs. opcional.
+4. **Saídas** — onde os resultados ficam e como lê-los (por exemplo, "leia os caminhos do manifest").
+5. **Modos de falha** — erros conhecidos e o que fazer sobre eles.
+
+Mantenha o `SKILL.md` escaneável. Mova contratos longos, listas completas de flags ou material de contexto para `references/` e vincule com caminhos relativos — o agente lê as referências apenas quando necessário.
+
+## Testes locais
+
+Após `pnpm web:dev`, inicie uma conversa e descreva uma tarefa que deveria acionar seu Skill. Verifique:
+
+- O agente seleciona o Skill para as solicitações certas — e não o seleciona para solicitações não relacionadas.
+- Os comandos do Skill rodam a partir de um checkout limpo sem correções manuais.
+- Os caminhos de saída e o tratamento de erros correspondem ao documentado.
+
+## Critérios de merge
+
+Um revisor verificará cada item abaixo — cole no seu PR e marque:
+
+- [ ] O nome da pasta e o frontmatter `name` correspondem; minúsculas com hífens.
+- [ ] `description` nomeia a condição de ativação e o resultado ("Use when …").
+- [ ] Os comandos rodam a partir de um checkout limpo; sem caminhos locais absolutos ou credenciais.
+- [ ] Entradas, saídas e modos de falha documentados.
+- [ ] Material de referência longo está em `references/`, não inline.
+- [ ] Verificado em uma conversa real: o Skill dispara quando deve — e somente então.
+- [ ] Se o Skill se sobrepõe a um existente, o PR explica por que um Skill separado é justificado.
+
+## Padrões comuns de rejeição
+
+- **Duplicata de um Skill existente** com apenas mudanças cosméticas de redação — melhore o existente em vez disso.
+- **Uma funcionalidade disfarçada** — o Skill só funciona se acompanhado de mudanças de código no Runtime ou na UI; envie a mudança de código como PR próprio.
+- **Comandos não testados** — flags que não existem, ou saídas que não correspondem aos caminhos documentados.
+- **Pré-requisitos não documentados** — o Skill assume silenciosamente uma configuração de provedor, um binário ou um serviço de rede.
+
+---
+
+Dúvidas? [Abra uma issue](https://github.com/krillinai/OpenCreator/issues/new) com o tópico `skill` e ajudaremos a delimitar o escopo.
diff --git a/docs/pt/contributing/templates-contributing.md b/docs/pt/contributing/templates-contributing.md
new file mode 100644
index 00000000..3234c3db
--- /dev/null
+++ b/docs/pt/contributing/templates-contributing.md
@@ -0,0 +1,102 @@
+# Contribuindo um template de criação (Português)
+
+> [English](../../contributing/templates-contributing.md) | [简体中文](../../zh/contributing/templates-contributing.md) | [日本語](../../ja/contributing/templates-contributing.md) | [한국어](../../ko/contributing/templates-contributing.md) | [Bahasa Indonesia](../../id/contributing/templates-contributing.md) | [Español](../../es/contributing/templates-contributing.md) | [Français](../../fr/contributing/templates-contributing.md) | [Deutsch](../../de/contributing/templates-contributing.md) | **Português** | [Русский](../../ru/contributing/templates-contributing.md) | [العربية](../../ar/contributing/templates-contributing.md)
+
+Um template de criação é uma pasta dentro de [`template/<módulo>/<id>/<versão>/`](../../../template/) com um `template.json` e seus recursos locais. Os templates alimentam os seletores visuais de geração de imagem, vídeo e capa — os usuários começam a partir do seu preset em vez de um prompt em branco. Este guia mostra como adicionar um.
+
+---
+
+## O que um template de criação É / NÃO É
+
+**Um template É:**
+- Um preset ajustado: prompts padrão, dicas de estilo, configurações de proporção/duração/qualidade, mais capa e prévia que mostram o resultado.
+- Autossuficiente. Tudo o que o seletor exibe vive na pasta do template.
+
+**Um template NÃO É:**
+- Um novo *tipo* de template. Os módulos atuais são `image-generation`, `video-generation` e `cover-generator`. Se você precisa de um módulo novo, abra uma issue para discutir primeiro — isso é uma mudança de produto, não um template.
+- Um amontoado de prompts. Templates com prompt vazio ou genérico e sem padrões localizados serão devolvidos; o valor está no ajuste fino.
+- Trabalho de outras pessoas sem direitos. Veja [Atribuição e direitos](#atribuição-e-direitos).
+
+## Início rápido
+
+```bash
+corepack enable && pnpm install
+cp -r template/cover-generator/images-go-hard-thumbnail template/<módulo>/<seu-id-de-template>
+# edite template.json, substitua os recursos de capa/prévia
+pnpm templates:validate # deve passar antes de abrir um PR
+```
+
+IDs de template usam letras minúsculas com hífens e são únicos dentro do módulo. A versão começa em `1` — uma pasta por versão, então atualizações criam `<id>/2/` em vez de editar `<id>/1/`.
+
+## Anatomia da pasta
+
+```
+template/<módulo>/<id>/1/
+├── template.json # obrigatório: metadados, padrões, conteúdo localizado
+├── cover.jpg # obrigatório: exibido no seletor de templates
+├── preview.jpg # módulos de imagem/capa: prévia ampliada do resultado
+├── previewVideo # módulo de vídeo: clipe de exemplo, ex. example.mp4
+└── author-avatar.jpg # opcional: avatar do autor creditado
+```
+
+## Campos do template.json
+
+| Campo | Obrigatório | Notas |
+|---|---|---|
+| `schemaVersion` | sim | Atualmente `1`. |
+| `id`, `version`, `module` | sim | Devem corresponder ao caminho `<módulo>/<id>/<versão>/`. |
+| `runtimeTemplate` | sim | Mapeia para o executor do Runtime, ex. `{"id": "cover", "version": 2}`. Copie de um template do mesmo módulo. |
+| `status` | sim | `published` para publicar; use `draft` enquanto itera. |
+| `title`, `description` | sim | `zh-CN` e `en-US` são obrigatórios. Outros idiomas são opcionais. |
+| `cover` | sim | Caminho relativo para a miniatura do seletor. |
+| `preview` / `previewVideo` | depende do módulo | `preview` para imagem e capa, `previewVideo` para vídeo. |
+| `defaults` | sim | Configurações base de onde o usuário parte (prompt, proporção, duração, qualidade…). |
+| `defaultsByLocale` | fortemente recomendado | Overrides localizados de prompt e estilo por idioma. É aqui que mora o ajuste fino — veja abaixo. |
+| `tags` | recomendado | Rótulos pesquisáveis; mantenha-os factuais. |
+| `author` | se aplicável | `name`, `url`, `avatar` para fontes externas creditadas. |
+| `featured`, `sortOrder` | não | Deixe `featured: false`; os mantenedores decidem o destaque. |
+
+## O prompt é o produto
+
+Os revisores passam a maior parte do tempo em `defaults` e `defaultsByLocale`:
+
+- **Ambos os idiomas devem ser prompts reais**, não traduções que perderam o ajuste. Os prompts `zh-CN` e `en-US` devem produzir resultados equivalentes aproveitando os pontos fortes de cada idioma.
+- **Parametrize o que deve mudar.** Se o título ou o assunto é editável pelo usuário, diga isso explicitamente no prompt (templates existentes usam marcadores como "Customizable text: …").
+- **Declare restrições.** "Sem marca d'água, sem texto extra, sem pessoas extras" — restrições negativas importam tanto quanto a descrição para resultados reproduzíveis.
+- **Siga a forma de `defaults` do módulo.** Templates de imagem trazem ratio/candidateCount/quality; de vídeo trazem size/duration; de capa trazem título, idioma do texto e campos de estilo. Copie a forma de um template existente do seu módulo.
+
+## Recursos
+
+- Gere o `cover.jpg` e a prévia **com o próprio template** — imagem de banco ou arte não relacionada será rejeitada.
+- Mantenha os tamanhos de arquivo razoáveis; esses arquivos são distribuídos com o app e carregados no seletor.
+- A prévia deve representar um resultado *típico*, não o melhor de cinquenta tentativas.
+
+## Atribuição e direitos
+
+Se o seu template adapta um prompt ou estilo publicado por outra pessoa:
+
+- Você precisa ter o direito de redistribuí-lo.
+- Preencha o campo `author` com `name` e `url` (e `author-avatar.jpg` se disponível), como fazem os templates existentes.
+- Em caso de dúvida, abra uma issue e pergunte antes de fazer o trabalho.
+
+## Critérios de merge
+
+- [ ] O caminho da pasta corresponde a `id`/`version`/`module`; o ID é único no módulo.
+- [ ] `pnpm templates:validate` passa.
+- [ ] `title` e `description` fornecidos em `zh-CN` e `en-US`.
+- [ ] `defaultsByLocale` contém prompts ajustados para ambos os idiomas.
+- [ ] Recursos de capa e prévia foram gerados pelo próprio template.
+- [ ] Atribuição `author` incluída ao adaptar trabalho externo.
+- [ ] `featured: false`, `status: "published"` (ou `draft` com nota no PR).
+
+## Padrões comuns de rejeição
+
+- **Prompt genérico** — o template não adiciona nada sobre um prompt em branco; o seletor não precisa dele.
+- **Idioma faltando** — apenas um idioma ajustado, ou tradução automática que perdeu as restrições de estilo.
+- **Recursos incompatíveis** — a capa não corresponde ao que o prompt realmente gera.
+- **Direitos incertos** — adaptado do trabalho de alguém sem atribuição ou permissão.
+- **Versão antiga editada no lugar** — crie uma pasta de versão nova em vez de reescrever o histórico de `<id>/1/`.
+
+---
+
+Dúvidas? [Abra uma issue](https://github.com/krillinai/OpenCreator/issues/new) com sua ideia de template e um exemplo de saída, e ajudaremos a delimitar o escopo.
diff --git a/docs/ru/CONTRIBUTING.md b/docs/ru/CONTRIBUTING.md
new file mode 100644
index 00000000..a21baaed
--- /dev/null
+++ b/docs/ru/CONTRIBUTING.md
@@ -0,0 +1,67 @@
+# Руководство для контрибьюторов (Русский)
+
+> [English](../../CONTRIBUTING.md) | [简体中文](../zh/CONTRIBUTING.md) | [日本語](../ja/CONTRIBUTING.md) | [한국어](../ko/CONTRIBUTING.md) | [Bahasa Indonesia](../id/CONTRIBUTING.md) | [Español](../es/CONTRIBUTING.md) | [Français](../fr/CONTRIBUTING.md) | [Deutsch](../de/CONTRIBUTING.md) | [Português](../pt/CONTRIBUTING.md) | **Русский** | [العربية](../ar/CONTRIBUTING.md)
+
+Спасибо, что хотите внести вклад в OpenCreator. OpenCreator — это локальное рабочее пространство для авторов, построенное на агентном цикле Codex, и бо́льшая часть его ценности рождается из небольших сфокусированных дополнений: одна папка Skill, один шаблон создания, одно чётко ограниченное исправление. Это руководство объясняет, где должен находиться каждый тип вклада и каким требованиям должен соответствовать PR перед слиянием.
+
+---
+
+## Карта вкладов
+
+| Если вы хотите… | Вы фактически добавляете | Где это находится | Размер поставки |
+|---|---|---|---|
+| Исправить баг или улучшить рабочий процесс | код | `apps/web/`, `apps/daemon/` | один сфокусированный PR с тестами |
+| Добавить переиспользуемый рабочий процесс агента | **Skill** | [`skills/<ваш-skill>/`](../../skills/) | одна папка с `SKILL.md` и необязательными references → [руководство](./contributing/skills-contributing.md) |
+| Добавить переиспользуемый пресет изображения, видео или обложки | **шаблон создания** | [`template/<модуль>/<id>/<версия>/`](../../template/) | одна папка с `template.json` и ресурсами → [руководство](./contributing/templates-contributing.md) |
+| Внести иллюстрации, иконки или дизайн UI | дизайн-ресурсы | согласованное место для ресурсов | один PR с превью, исходниками и лицензией |
+| Подключить ИИ- или медиасервис | **сервисную интеграцию** | соответствующий модуль Web или Daemon | один PR с обработкой ошибок, безопасностью учётных данных и тестами |
+| Улучшить документацию или переводы | документы | `README.md`, `docs/`, `docs/<locale>/README.md` | один PR |
+
+Если вы не уверены, к какой категории относится ваша идея, [сначала откройте issue](https://github.com/krillinai/OpenCreator/issues/new) — мы подскажем нужное место.
+
+---
+
+## Локальная установка
+
+Полная установка описана в [быстром старте README](../../README.md#quick-start). Краткая версия для контрибьюторов:
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable # выбирает закреплённый pnpm из packageManager
+pnpm install
+pnpm web:dev # web + локальный daemon по требованию
+pnpm typecheck # проверки TypeScript по всему репозиторию
+pnpm test # модульные и интеграционные тесты workspace
+```
+
+Требуются Node.js 22+ и исполняемый файл Codex CLI. Откройте `http://127.0.0.1:19861/` после `pnpm web:dev`; при первом запуске Runtime автоматически подготовит проект по умолчанию, и поле ввода будет готово сразу после установки соединения.
+
+---
+
+## Как внести вклад
+
+1. Опишите проблему, сценарий использования и ожидаемое поведение в [issue](https://github.com/krillinai/OpenCreator/issues).
+2. Создайте сфокусированную ветку функции или исправления от последней ветки разработки.
+3. Следуйте существующей архитектуре: общие возможности продукта реализуются **один раз** в Web и Daemon, а нативные различия Desktop изолируются за явными capability (например, `canSelectDirectory`).
+4. Добавьте соответствующее покрытие модульными, интеграционными или E2E-тестами для изменений поведения и перечислите в PR как выполненные, так и пропущенные проверки.
+5. Никогда не коммитьте `.runtime/`, локальные учётные данные, сессии Codex, кэши сборки или другие пользовательские данные.
+
+## Что проверяют ревьюеры
+
+- **Единая реализация общего поведения.** Одна и та же функция не должна реализовываться отдельно для Browser Bridge и Desktop Bridge.
+- **Capability gating вместо тихих заглушек.** Платформенно-специфичный вход должен скрываться, когда capability недоступна — никогда не показывайте кнопку, которая молча ничего не делает.
+- **Тесты соответствуют риску изменения.** Небольшие правки текста или стилей требуют только точечных проверок; изменения общего состояния, персистентности или контрактов Runtime требуют как минимум модульных тестов и typecheck.
+- **Документация обновляется вместе с поведением.** Если ваше изменение меняет видимый пользователю рабочий процесс, обновите README или соответствующий документ в `docs/` в том же PR.
+
+## Частые причины возврата PR
+
+- Одна и та же логика добавлена отдельно в путях Web и Desktop вместо общего сервисного слоя.
+- Неподдерживаемая платформой кнопка видима, но её обработчик молча возвращается.
+- Поведение изменено без тестов или заметки о проверке.
+- PR смешивает несвязанный рефакторинг или исправление с основным изменением.
+- Закоммичены сгенерированные файлы, данные `.runtime/` или учётные данные.
+
+---
+
+OpenCreator · Create locally, work continuously.
diff --git a/docs/ru/contributing/skills-contributing.md b/docs/ru/contributing/skills-contributing.md
new file mode 100644
index 00000000..0a7c956d
--- /dev/null
+++ b/docs/ru/contributing/skills-contributing.md
@@ -0,0 +1,96 @@
+# Вклад в Skill (Русский)
+
+> [English](../../contributing/skills-contributing.md) | [简体中文](../../zh/contributing/skills-contributing.md) | [日本語](../../ja/contributing/skills-contributing.md) | [한국어](../../ko/contributing/skills-contributing.md) | [Bahasa Indonesia](../../id/contributing/skills-contributing.md) | [Español](../../es/contributing/skills-contributing.md) | [Français](../../fr/contributing/skills-contributing.md) | [Deutsch](../../de/contributing/skills-contributing.md) | [Português](../../pt/contributing/skills-contributing.md) | **Русский** | [العربية](../../ar/contributing/skills-contributing.md)
+
+Skill — это папка внутри [`skills/`](../../../skills/) с файлом `SKILL.md` в корне, следующая [соглашению `SKILL.md`](https://agentskills.io). Она упаковывает переиспользуемый рабочий процесс агента: когда его использовать, какие команды или инструменты вызывать и как интерпретировать результаты. Это руководство объясняет, как добавить Skill.
+
+---
+
+## Что Skill ЕСТЬ / чем НЕ является
+
+**Skill ЕСТЬ:**
+- Повторяемый рабочий процесс, которому может следовать агент, описанный на естественном языке плюс команды.
+- Предметные знания, которым не место в основном коде: как вызвать этап CLI, как структурировать промпт для медиапровайдера, как валидировать план.
+- Небольшой объём. Одна папка, один `SKILL.md`, необязательная `references/` для длинных материалов, которые агент читает по требованию.
+
+**Skill НЕ является:**
+- Продуктовой функцией. Изменения UI, новые эндпоинты Runtime и новое поведение рабочего пространства — это вклад в код (`apps/web/`, `apps/daemon/`).
+- Копией существующего Skill с немного изменённой формулировкой. Если ваше изменение улучшает существующий процесс, отредактируйте тот Skill напрямую.
+- Обёрткой вокруг учётных данных или локальных путей конкретного пользователя. Skill должен работать из чистого чекаута.
+
+## Быстрый старт
+
+```bash
+git clone https://github.com/krillinai/OpenCreator.git
+cd OpenCreator
+corepack enable && pnpm install
+cp -r skills/krillinai-tts skills/<ваш-skill> # начните с ближайшего существующего Skill
+# отредактируйте skills/<ваш-skill>/SKILL.md
+pnpm web:dev # проверьте, что агент распознаёт его в диалоге
+```
+
+Самый быстрый путь — скопировать Skill, наиболее близкий к вашей идее, и переписать его: существующие Skill `krillinai-*` показывают ожидаемую структуру и тон.
+
+## Анатомия Skill
+
+```
+skills/<ваш-skill>/
+├── SKILL.md # обязательно: frontmatter + инструкции
+└── references/ # необязательно: длинные документы, на которые ссылается SKILL.md
+ └── cli-contract.md
+```
+
+`SKILL.md` начинается с YAML frontmatter:
+
+```yaml
+---
+name: ваш-skill
+description: Use when <условие срабатывания>, including <основные возможности>.
+---
+```
+
+Два правила, которые применяют ревьюеры:
+
+- **`name` должен совпадать с именем папки.** Строчные буквы, через дефис.
+- **`description` — это поверхность обнаружения.** Именно её агент читает, чтобы решить, применим ли этот Skill. Пишите в формате "Use when …", называйте триггер и результат, уложитесь в одно-два предложения. Расплывчатые описания («помогает с видео») возвращаются на доработку.
+
+Тело должно охватывать, по порядку:
+
+1. **Когда использовать** — один абзац.
+2. **Команды** — блоки кода с точным вызовом, включая необходимые переменные окружения или рабочие каталоги.
+3. **Входы и флаги** — таблица для всего неочевидного; отметьте обязательное и необязательное.
+4. **Выходы** — куда попадают результаты и как их читать (например, «читайте пути из манифеста»).
+5. **Режимы отказа** — известные ошибки и что с ними делать.
+
+Держите `SKILL.md` удобным для беглого просмотра. Длинные контракты, полные списки флагов или справочные материалы выносите в `references/` и ссылайтесь относительными путями — агент читает references только при необходимости.
+
+## Локальная проверка
+
+После `pnpm web:dev` начните диалог и опишите задачу, которая должна активировать ваш Skill. Проверьте:
+
+- Агент выбирает Skill для правильных запросов — и не выбирает для несвязанных.
+- Команды Skill выполняются из чистого чекаута без ручных правок.
+- Пути вывода и обработка ошибок соответствуют документации.
+
+## Критерии слияния
+
+Ревьюер проверит каждый пункт — вставьте список в PR и отметьте:
+
+- [ ] Имя папки и frontmatter `name` совпадают; строчные буквы через дефис.
+- [ ] `description` называет условие срабатывания и результат ("Use when …").
+- [ ] Команды работают из чистого чекаута; без абсолютных локальных путей и учётных данных.
+- [ ] Входы, выходы и режимы отказа задокументированы.
+- [ ] Длинные справочные материалы находятся в `references/`, а не в основном тексте.
+- [ ] Проверено в реальном диалоге: Skill срабатывает, когда должен, и только тогда.
+- [ ] Если Skill пересекается с существующим, PR объясняет, почему нужен отдельный.
+
+## Частые причины отклонения
+
+- **Дубликат существующего Skill** с косметическими правками формулировок — вместо этого улучшите существующий.
+- **Замаскированная функция** — Skill работает только вместе с изменениями кода Runtime или UI; отправьте изменение кода отдельным PR.
+- **Непроверенные команды** — несуществующие флаги или выходы, не совпадающие с задокументированными путями.
+- **Незадокументированные предпосылки** — Skill молча предполагает конфигурацию провайдера, бинарный файл или сетевой сервис.
+
+---
+
+Вопросы? [Откройте issue](https://github.com/krillinai/OpenCreator/issues/new) с темой `skill` — мы поможем определить рамки.
diff --git a/docs/ru/contributing/templates-contributing.md b/docs/ru/contributing/templates-contributing.md
new file mode 100644
index 00000000..a0100010
--- /dev/null
+++ b/docs/ru/contributing/templates-contributing.md
@@ -0,0 +1,102 @@
+# Вклад в шаблон создания (Русский)
+
+> [English](../../contributing/templates-contributing.md) | [简体中文](../../zh/contributing/templates-contributing.md) | [日本語](../../ja/contributing/templates-contributing.md) | [한국어](../../ko/contributing/templates-contributing.md) | [Bahasa Indonesia](../../id/contributing/templates-contributing.md) | [Español](../../es/contributing/templates-contributing.md) | [Français](../../fr/contributing/templates-contributing.md) | [Deutsch](../../de/contributing/templates-contributing.md) | [Português](../../pt/contributing/templates-contributing.md) | **Русский** | [العربية](../../ar/contributing/templates-contributing.md)
+
+Шаблон создания — это папка внутри [`template/<модуль>/<id>/<версия>/`](../../../template/) с файлом `template.json` и локальными ресурсами. Шаблоны питают визуальные селекторы генерации изображений, видео и обложек — пользователи начинают с вашего пресета, а не с пустого промпта. Это руководство объясняет, как добавить шаблон.
+
+---
+
+## Что шаблон создания ЕСТЬ / чем НЕ является
+
+**Шаблон ЕСТЬ:**
+- Настроенный пресет: промпты по умолчанию, стилевые подсказки, настройки соотношения/длительности/качества, плюс обложка и превью, показывающие результат.
+- Самодостаточный. Всё, что показывает селектор, находится в папке шаблона.
+
+**Шаблон НЕ является:**
+- Новым *типом* шаблона. Текущие модули — `image-generation`, `video-generation` и `cover-generator`. Если вам нужен новый модуль, сначала откройте issue для обсуждения — это изменение продукта, а не шаблон.
+- Свалкой промптов. Шаблоны с пустым или общим промптом и без локализованных значений по умолчанию будут возвращены; ценность — в настройке.
+- Чужой работой без прав. См. [Атрибуция и права](#атрибуция-и-права).
+
+## Быстрый старт
+
+```bash
+corepack enable && pnpm install
+cp -r template/cover-generator/images-go-hard-thumbnail template/<модуль>/<id-вашего-шаблона>
+# отредактируйте template.json, замените ресурсы обложки/превью
+pnpm templates:validate # должен пройти до открытия PR
+```
+
+ID шаблонов — строчные буквы через дефис, уникальны внутри модуля. Версия начинается с `1` — одна папка на версию, поэтому обновления создают `<id>/2/`, а не редактируют `<id>/1/`.
+
+## Анатомия папки
+
+```
+template/<модуль>/<id>/1/
+├── template.json # обязательно: метаданные, значения по умолчанию, локализованный контент
+├── cover.jpg # обязательно: показывается в селекторе шаблонов
+├── preview.jpg # модули изображений/обложек: увеличенное превью результата
+├── previewVideo # модуль видео: пример клипа, напр. example.mp4
+└── author-avatar.jpg # необязательно: аватар указанного автора
+```
+
+## Поля template.json
+
+| Поле | Обязательно | Примечания |
+|---|---|---|
+| `schemaVersion` | да | Сейчас `1`. |
+| `id`, `version`, `module` | да | Должны соответствовать пути папки `<модуль>/<id>/<версия>/`. |
+| `runtimeTemplate` | да | Соответствие исполнителю Runtime, напр. `{"id": "cover", "version": 2}`. Скопируйте из шаблона того же модуля. |
+| `status` | да | `published` для публикации; используйте `draft` во время доработки. |
+| `title`, `description` | да | `zh-CN` и `en-US` обязательны. Другие языки необязательны. |
+| `cover` | да | Относительный путь к миниатюре селектора. |
+| `preview` / `previewVideo` | зависит от модуля | `preview` для изображений и обложек, `previewVideo` для видео. |
+| `defaults` | да | Базовые настройки, с которых начинает пользователь (промпт, соотношение, длительность, качество…). |
+| `defaultsByLocale` | настоятельно рекомендуется | Локализованные переопределения промпта и стиля по языкам. Именно здесь живёт настоящая настройка — см. ниже. |
+| `tags` | рекомендуется | Метки для поиска; держите их фактическими. |
+| `author` | если применимо | `name`, `url`, `avatar` для указанных внешних источников. |
+| `featured`, `sortOrder` | нет | Оставьте `featured: false`; решение о продвижении принимают мейнтейнеры. |
+
+## Промпт — это и есть продукт
+
+Ревьюеры проводят бо́льшую часть времени с `defaults` и `defaultsByLocale`:
+
+- **Оба языка должны быть настоящими промптами**, а не переводами, потерявшими настройку. Промпты `zh-CN` и `en-US` должны давать эквивалентные результаты, используя сильные стороны каждого языка.
+- **Параметризуйте то, что должно меняться.** Если заголовок или объект редактируются пользователем, скажите об этом явно в промпте (существующие шаблоны используют маркеры вроде "Customizable text: …").
+- **Формулируйте ограничения.** «Без водяных знаков, без лишнего текста, без лишних людей» — негативные ограничения так же важны, как описание, для воспроизводимых результатов.
+- **Соответствуйте структуре `defaults` модуля.** Шаблоны изображений несут ratio/candidateCount/quality; видео — size/duration; обложки — заголовок, язык текста и поля стиля. Скопируйте структуру из существующего шаблона вашего модуля.
+
+## Ресурсы
+
+- Сгенерируйте `cover.jpg` и превью **самим шаблоном** — стоковое изображение или несвязанная графика будет отклонена.
+- Держите размеры файлов умеренными; эти файлы поставляются с приложением и загружаются в селекторе.
+- Превью должно показывать *типичный* результат, а не лучший из пятидесяти вариантов.
+
+## Атрибуция и права
+
+Если ваш шаблон адаптирует чужой опубликованный промпт или стиль:
+
+- У вас должно быть право на его распространение.
+- Заполните поле `author` значениями `name` и `url` (и `author-avatar.jpg`, если доступно), как это делают существующие шаблоны.
+- Если сомневаетесь, откройте issue и спросите до начала работы.
+
+## Критерии слияния
+
+- [ ] Путь папки соответствует `id`/`version`/`module`; ID уникален в модуле.
+- [ ] `pnpm templates:validate` проходит.
+- [ ] `title` и `description` предоставлены на `zh-CN` и `en-US`.
+- [ ] `defaultsByLocale` содержит настроенные промпты для обоих языков.
+- [ ] Ресурсы обложки и превью сгенерированы самим шаблоном.
+- [ ] Атрибуция `author` включена при адаптации внешней работы.
+- [ ] `featured: false`, `status: "published"` (или `draft` с пометкой в PR).
+
+## Частые причины отклонения
+
+- **Общий промпт** — шаблон ничего не добавляет к пустому промпту; селектор в нём не нуждается.
+- **Отсутствующий язык** — настроен только один язык, или машинный перевод потерял стилевые ограничения.
+- **Несоответствие ресурсов** — обложка не соответствует тому, что промпт реально генерирует.
+- **Непонятные права** — адаптация чужой работы без атрибуции или разрешения.
+- **Старая версия отредактирована на месте** — создайте новую папку версии вместо перезаписи истории `<id>/1/`.
+
+---
+
+Вопросы? [Откройте issue](https://github.com/krillinai/OpenCreator/issues/new) с вашей идеей шаблона и примером результата — мы поможем определить рамки.
diff --git a/docs/zh/CONTRIBUTING.md b/docs/zh/CONTRIBUTING.md
index 90893c3f..375aabc0 100644
--- a/docs/zh/CONTRIBUTING.md
+++ b/docs/zh/CONTRIBUTING.md
@@ -1,6 +1,6 @@
# 贡献指南(简体中文)
-> [English](../../CONTRIBUTING.md) | 简体中文
+> [English](../../CONTRIBUTING.md) | **简体中文** | [日本語](../ja/CONTRIBUTING.md) | [한국어](../ko/CONTRIBUTING.md) | [Bahasa Indonesia](../id/CONTRIBUTING.md) | [Español](../es/CONTRIBUTING.md) | [Français](../fr/CONTRIBUTING.md) | [Deutsch](../de/CONTRIBUTING.md) | [Português](../pt/CONTRIBUTING.md) | [Русский](../ru/CONTRIBUTING.md) | [العربية](../ar/CONTRIBUTING.md)
感谢你愿意为 OpenCreator 做贡献。OpenCreator 是一个基于 Codex Agent 循环的本地优先创作工作区,项目的大部分价值来自小而聚焦的补充:一个 Skill 文件夹、一个创作模板、一个边界清晰的修复。本指南说明每类贡献应该放在哪里,以及 PR 需要达到什么标准才能合并。
diff --git a/docs/zh/contributing/skills-contributing.md b/docs/zh/contributing/skills-contributing.md
index 7621b939..b1680fb8 100644
--- a/docs/zh/contributing/skills-contributing.md
+++ b/docs/zh/contributing/skills-contributing.md
@@ -1,6 +1,6 @@
# 贡献一个 Skill(简体中文)
-> [English](../../contributing/skills-contributing.md) | 简体中文
+> [English](../../contributing/skills-contributing.md) | **简体中文** | [日本語](../../ja/contributing/skills-contributing.md) | [한국어](../../ko/contributing/skills-contributing.md) | [Bahasa Indonesia](../../id/contributing/skills-contributing.md) | [Español](../../es/contributing/skills-contributing.md) | [Français](../../fr/contributing/skills-contributing.md) | [Deutsch](../../de/contributing/skills-contributing.md) | [Português](../../pt/contributing/skills-contributing.md) | [Русский](../../ru/contributing/skills-contributing.md) | [العربية](../../ar/contributing/skills-contributing.md)
Skill 是 [`skills/`](../../../skills/) 下的一个文件夹,根目录包含一个 `SKILL.md`,遵循 [`SKILL.md` 约定](https://agentskills.io)。它封装一个可复用的 Agent 工作流:何时使用、调用什么命令或工具、如何解读输出。本指南说明如何新增一个 Skill。
diff --git a/docs/zh/contributing/templates-contributing.md b/docs/zh/contributing/templates-contributing.md
index 167fc169..21b3aab2 100644
--- a/docs/zh/contributing/templates-contributing.md
+++ b/docs/zh/contributing/templates-contributing.md
@@ -1,6 +1,6 @@
# 贡献一个创作模板(简体中文)
-> [English](../../contributing/templates-contributing.md) | 简体中文
+> [English](../../contributing/templates-contributing.md) | **简体中文** | [日本語](../../ja/contributing/templates-contributing.md) | [한국어](../../ko/contributing/templates-contributing.md) | [Bahasa Indonesia](../../id/contributing/templates-contributing.md) | [Español](../../es/contributing/templates-contributing.md) | [Français](../../fr/contributing/templates-contributing.md) | [Deutsch](../../de/contributing/templates-contributing.md) | [Português](../../pt/contributing/templates-contributing.md) | [Русский](../../ru/contributing/templates-contributing.md) | [العربية](../../ar/contributing/templates-contributing.md)
创作模板是 [`template/<module>/<id>/<version>/`](../../../template/) 下的一个文件夹,包含 `template.json` 和本地素材。模板为图像生成、视频生成和封面生成的可视化选择器提供预设——用户从你的预设开始创作,而不是面对空白 prompt。本指南说明如何新增一个模板。