@agent-native/core 0.76.5 → 0.76.6

package/docs/content/locales/ar-SA/template-analytics.md

@@ -0,0 +1,259 @@
+---
+title: "التحليلات"
+description: "اطرح أسئلة تحليلية باللغة الإنجليزية البسيطة، واحصل على المخططات ولوحات المعلومات مرة أخرى. بديل مفتوح المصدر لـ Amplitude وMixpanel وLooker."
+---
+
+# التحليلات
+
+اطرح أسئلة تحليلية باللغة الإنجليزية البسيطة، واحصل على المخططات ولوحات المعلومات مرة أخرى. يتصل الوكيل بـ BigQuery، وGA4، وAmplitude، ومجمع أحداث الطرف الأول المدمج، وHubSpot، وJira، وعشرات المصادر الأخرى، ويكتب الاستعلام نيابةً عنك، ويتحقق من صحته، ويعرض الإجابة كمخطط أو جدول أو لوحة معلومات محفوظة.
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:500px;box-sizing:border-box'><h1 style='margin:0'>Agent-Native Templates</h1><p class='wf-muted' style='margin:0'>Adoption and engagement across the last 12 weeks.</p><div style='display:grid;grid-template-columns:repeat(3,1fr);gap:12px'><div class='wf-card'><small class='wf-muted'>Weekly active users</small><br/><strong>24,318</strong><br/><span class='wf-pill accent'>+12.4%</span></div><div class='wf-card'><small class='wf-muted'>New signups</small><br/><strong>1,842</strong><br/><span class='wf-pill accent'>+8.7%</span></div><div class='wf-card'><small class='wf-muted'>Revenue MRR</small><br/><strong>$48,210</strong><br/><span class='wf-pill accent'>+21.3%</span></div></div><div style='display:grid;grid-template-columns:1fr 1fr;gap:12px;flex:1'><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Weekly active users</strong><div style='flex:1;display:flex;align-items:end;gap:8px'><div style='height:38%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:44%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:58%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:74%;flex:1;background:var(--wf-accent-soft)'></div></div></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Revenue over time</strong><div style='flex:1;display:flex;align-items:end;gap:8px'><div style='height:32%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:48%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:63%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:80%;flex:1;background:var(--wf-accent-soft)'></div></div></div></div><div class='wf-card'><strong>Signups by source</strong><br/><small class='wf-muted'>Lower chart begins below the main charts.</small></div></div>"
+}
+```
+
+إنه بديل مفتوح المصدر لـ Amplitude وMixpanel وLooker - للفرق التي ترغب في امتلاك التعليمات البرمجية والاستعلامات والبيانات.
+
+```an-diagram title="Question to chart" summary="The agent consults the data dictionary, writes SQL, validates it against the warehouse, then renders a chart or saves a panel."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-node\">Plain-English<br>question</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Agent</span><small class=\"diagram-muted\">reads data dictionary</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Writes SQL</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-pill ok\">Dry-run validate</div><small class=\"diagram-muted\">BigQuery / source</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Chart, table, or<br>saved panel</div></div>",
+  "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:6px;align-items:center}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}"
+}
+```
+
+## ما يمكنك فعله به
+
+- **اطرح الأسئلة المتعلقة بالبيانات باللغة الإنجليزية البسيطة.** "ما النسبة المئوية لعمليات الاشتراك التي تم تحويلها الشهر الماضي إلى مدفوعة؟" أو "اعرض لي المستخدمين النشطين أسبوعيًا خلال الأشهر الستة الماضية." يختار الوكيل المصدر الصحيح، ويكتب SQL، ويعرض المخطط.
+- **إنشاء لوحات معلومات SQL قابلة لإعادة الاستخدام** باستخدام عوامل التصفية وطرق العرض المحفوظة والاستعلامات المعلمية.
+- **تشغيل التحليلات المخصصة** التي تشير إلى مصادر بيانات متعددة - ويتم حفظها كتحقيقات قابلة لإعادة التشغيل مع السؤال الأصلي والتعليمات والنتائج.
+- **احتفظ بقاموس بيانات حي** يضم المقاييس والجداول ووصفات SQL بحيث يستخدم الوكيل أسماء الأعمدة الصحيحة في كل مرة (لم تعد هناك حاجة إلى تخمين `is_closed` عندما يكون `hs_is_closed` فعليًا).
+- **مشاركة لوحات التحكم** مع فريقك - خاصة بشكل افتراضي، وقابلة للمشاركة لكل مستخدم أو لكل مؤسسة مع أدوار المشاهد/المحرر/المشرف.
+- **الاتصال بالعديد من المصادر** خارج الصندوق: BigQuery، وGA4، وMixpanel، وAmplitude، وPostHog، وHubSpot، وJira، وApollo، وPylon، وGong، وCommon Room، وTwitter، بالإضافة إلى مصادر SEO الخاصة بالتطبيق.
+- **إعادة استخدام عمليات تكامل مساحة العمل** عندما تكون مساحة العمل متصلة بالفعل و
+  منح موفرًا لبرنامج Analytics. موفر مخازن التكامل المشترك
+  مراجع الهوية وبيانات الاعتماد؛ يحتفظ Analytics باختيار المصدر الخاص بالتطبيق،
+  إدخالات قاموس البيانات، ولوحة المعلومات SQL، وسجل التحليل.
+
+## البدء
+
+عرض توضيحي مباشر: [analytics.agent-native.com](https://analytics.agent-native.com).
+
+عند فتح التطبيق لأول مرة:
+
+1. سجل الدخول باستخدام Google.
+2. افتح صفحة **مصادر البيانات** من الشريط الجانبي.
+3. يحتوي كل مصدر على إرشادات تفصيلية — قم بتوصيل المصادر التي تحتاج إليها (ابدأ بمصدر، مثل BigQuery، أو GA4، أو Amplitude، أو تتبع الطرف الأول).
+4. افتح محادثة جديدة مع الوكيل واطرح سؤالاً: "كم عدد الاشتراكات التي حصلنا عليها الأسبوع الماضي؟"
+
+السؤال الأول كافي لتأكيد عمل الاتصال. ومن هناك، اطلب من الوكيل "حفظ هذا كلوحة تحكم" أو "إنشاء لوحة تحكم نظرة عامة مكونة من 4 لوحات لمقاييسنا الرئيسية."
+
+### مطالبات مفيدة
+
+- "أنشئ لوحة تحكم تعرض المستخدمين النشطين أسبوعيًا خلال الأشهر الستة الماضية."
+- "ما النسبة المئوية لعمليات الاشتراك الشهر الماضي التي تم تحويلها إلى اشتراكات مدفوعة؟"
+- "أضف مخططًا يقارن الإيرادات حسب الخطة إلى لوحة المعلومات هذه."
+- "أعد ترتيب اللوحات في لوحة المعلومات هذه بحيث يأتي مقياس MRR أولاً."
+- "تحليل صفقاتنا المغلقة الخاسرة من الربع الأول وحفظ التحليل."
+- "أعد تشغيل تحليل التراجع باستخدام بيانات هذا الشهر."
+- "قم بتوثيق هذا المقياس في قاموس البيانات."
+
+يعرف الوكيل دائمًا ما تنظر إليه - لوحة التحكم الحالية، والمرشحات، والعرض - لذا يمكنك أن تقول "لوحة التحكم هذه" أو "تلك اللوحة" دون أن تكون صريحًا.
+
+## ثلاثة أشياء يجب معرفتها
+
+يحتوي التطبيق على ثلاثة أسطح أساسية ستقضي وقتًا فيها:
+
+- **لوحات المعلومات SQL** — لوحات قابلة لإعادة الاستخدام مع عوامل التصفية وطرق العرض المحفوظة. الأفضل للمقاييس التي تتحقق منها بانتظام.
+- **التحليلات المخصصة** — تحقيقات طويلة يتم سحبها من مصادر متعددة، مع حفظ تعليمات إعادة التشغيل بجانبها. من الأفضل طرح الأسئلة لمرة واحدة والتي قد ترغب في إعادة النظر فيها.
+- **قاموس البيانات** — الكتالوج الأساسي للمقاييس والجداول والأعمدة ووصفات SQL. يستشيره الوكيل قبل كتابة أي SQL، لذلك فهو يستخدم أسماء أعمدة المستودعات الحقيقية ويعرف التحذيرات مثل "يستبعد رسائل البريد الإلكتروني الداخلية".
+
+يتم تصنيف القاموس عن طريق مطالبة الوكيل بما يلي: "استيراد تعريفات dbt الخاصة بنا" أو "سحب المقاييس من دليل Notion الخاص بنا" وسيقوم هو بالمهمة.
+
+## للمطورين
+
+باقي هذا المستند مخصص لأي شخص يقوم بتعديل نموذج Analytics أو توسيعه.
+
+### بداية سريعة
+
+إنشاء تطبيق Analytics جديد من CLI:
+
+```bash
+npx @agent-native/core@latest create my-analytics --standalone --template analytics
+```
+
+التطوير المحلي:
+
+```bash
+cd my-analytics
+pnpm install
+pnpm dev
+```
+
+يطبع CLI جهاز التطوير المحلي URL. سجل الدخول باستخدام Google، ثم افتح صفحة **مصادر البيانات** لربط BigQuery وGA4 وتتبع الطرف الأول وHubSpot وJira والباقي.
+
+### الميزات الرئيسية
+
+**اطرح الأسئلة واحصل على الرسوم البيانية.** يختار الوكيل مصدر البيانات، ويكتب SQL ويتحقق من صحته، ثم يعرض مخططًا أو جدولًا أو مقياسًا أو لوحة محفوظة.
+
+**لوحات المعلومات والتحقيقات.** تحتفظ لوحات المعلومات القابلة لإعادة الاستخدام بلوحات SQL والمرشحات وطرق العرض المحفوظة والمشاركة؛ تعمل التحليلات المخصصة على حفظ النتائج الأطول مع تعليمات إعادة التشغيل.
+
+**قاموس البيانات الحية.** تمنح تعريفات المقاييس والمالكين وجداول المصدر والتحذيرات المعروفة الوكيل مفردات المستودع الحقيقية قبل أن يكتب الاستعلامات.
+
+**سطح موصل واسع.** تأتي أحداث BigQuery وGA4 وتحليلات المنتج وCRM والدعم والمجتمع وGitHub/Jira وSEO وأحداث `/track` للطرف الأول من خلال actions التي يمكن للوكيل الاتصال بها.
+
+### العمل مع الوكيل
+
+يعرف الوكيل دائمًا ما تنظر إليه. يتم إدخال حالة الشاشة الحالية في كل رسالة ككتلة `<current-screen>` - فهي تحتوي على العرض النشط، ولوحة المعلومات المفتوحة أو التحليل، وأي عوامل تصفية محددة.
+
+يحصل موجه نظام الوكيل على كتلة `<data-dictionary>` المحقونة بإدخالات القياس المعتمدة للمؤسسة النشطة. عندما تطلب لوحة معلومات، يراجع الوكيل القاموس أولاً ويستخدم `table` / `columns` / `queryTemplate` حرفيًا — ولا يخمن أسماء الأعمدة.
+
+**السياق الذي يحتوي عليه تلقائيًا:**
+
+- **العرض الحالي** — `overview`، أو `adhoc` (مع `dashboardId`)، أو `analyses` (مع `analysisId`)، أو `data-dictionary`، أو `data-sources`، أو `settings`.
+- **المؤسسة النشطة** — تحدد نطاق جميع الاستعلامات وعمليات الكتابة.
+- **إدخالات القاموس المعتمدة** — لمساحة العمل النشطة.
+
+**تحريرات لوحة المعلومات.** يستخدم الوكيل الإجراء `update-dashboard` لتحرير لوحات المعلومات. وهو يدعم وضعين:
+
+- `ops` — تصحيحات مؤشر JSON للتعديلات الجراحية (حرك لوحة، واستبدل سلسلة SQL، وأزل مرشحًا).
+- `config` — الاستبدال الكامل لتكوين لوحة المعلومات.
+
+يتم تشغيل SQL لكل لوحة BigQuery في المستودع قبل حفظ لوحة المعلومات. إذا كان العمود خاطئًا، فسيتم رفض الحفظ مع خطأ BigQuery — يقوم الوكيل بإصلاح SQL وإعادة المحاولة بدلاً من استمرار اللوحات المعطلة.
+
+### توصيل مصادر البيانات
+
+افتح صفحة **مصادر البيانات** (`/data-sources`) للاتصال بموفري الخدمة. كل
+يكشف المصدر عن قائمة مفاتيح البيئة، وإرشادات تفصيلية، وزر **اختبار الاتصال**.
+عند تشغيل Analytics في مساحة عمل، يقدم `data-source-status` أيضًا تقارير
+تم منح اتصالات مساحة عمل قابلة لإعادة الاستخدام لـ `appId=analytics` حتى يتمكن الوكيل من ذلك
+اطلب منح التطبيق بدلاً من الحصول على نسخة أخرى من نفس مفتاح الموفر.
+بالنسبة للموفرين القابلين لإعادة الاستخدام مثل Slack، وHubSpot، وNotion، وGitHub، فإن البيانات
+تعرض المصادر UI حالة التكامل المشترك مباشرةً: جاهزة عبر مساحة العمل،
+يحتاج إلى منحة، أو يحتاج إلى بيانات اعتماد، أو بيانات اعتماد محلية.
+
+عمليات تكامل مساحة العمل القابلة لإعادة الاستخدام هي اتجاه وقت التشغيل للموفرين المشتركين:
+يخزن إطار العمل هوية الموفر، وبيانات تعريف الحساب، ومراجع بيانات الاعتماد، و
+المنح لكل تطبيق مرة واحدة؛ يقوم Analytics بتخزين تفسير مصدر البيانات، مصدر
+اختيارات الحقيقة وتعريفات المقاييس ولوحات المعلومات والتحليلات.
+
+يتم تخزين بيانات الاعتماد عبر إعدادات إطار العمل/طبقة البيئة - لا توجد أسرار في git. يتطلب الإنتاج:
+
+| متغير                                    | الغرض                                                          |
+| ---------------------------------------- | -------------------------------------------------------------- |
+| `DATABASE_URL`                           | اتصال SQL الدائم URL                                           |
+| `BETTER_AUTH_SECRET` / `BETTER_AUTH_URL` | المصادقة                                                       |
+| `GOOGLE_SIGN_IN_CLIENT_ID` / `_SECRET`   | العميل المفضل لتسجيل الدخول إلى Google (OAuth 2.0)             |
+| `GOOGLE_CLIENT_ID` / `_SECRET`           | الإجراء الاحتياطي القديم لتسجيل الدخول / عميل تكامل Google API |
+| `BIGQUERY_PROJECT_ID`                    | مشروع BigQuery                                                 |
+| `GOOGLE_APPLICATION_CREDENTIALS_JSON`    | حساب خدمة BigQuery JSON                                        |
+| `ANTHROPIC_API_KEY`                      | دردشة الوكيل                                                   |
+
+يتم توثيق المفاتيح الخاصة بالموفر (HubSpot، وJira، وGong، وPylon، وما إلى ذلك) في الإرشادات التفصيلية لكل مصدر في صفحة مصادر البيانات. إذا قمت بإضافة إجراء جديد يحتاج إلى مفتاح API، فسيظهر كمصدر جديد على تلك الصفحة عبر تسجيل تأهيل القالب.
+
+ملاحظة: بيانات اعتماد BigQuery OAuth لتسجيل الدخول إلى Google هي **منفصلة**
+بيانات الاعتماد من حساب خدمة BigQuery JSON. أنشئ عميل تسجيل الدخول على
+وحدة التحكم GCP → APIs والخدمات → بيانات الاعتماد → معرف العميل OAuth، ويفضل
+أسماء البيئة `GOOGLE_SIGN_IN_CLIENT_ID` / `GOOGLE_SIGN_IN_CLIENT_SECRET` لذلك
+يظل عميل تسجيل الدخول منخفض النطاق منفصلاً عن عملاء تكامل Google API.
+
+### نموذج البيانات
+
+الجداول الأساسية (راجع `templates/analytics/server/db/schema.ts`):
+
+```an-schema title="Analytics data model" summary="Dashboards and analyses are the resources; views, shares, and a query cache hang off them. Org tables come from @agent-native/core/org."
+{
+  "entities": [
+    {
+      "id": "dashboards",
+      "name": "dashboards",
+      "note": "Explorer and SQL dashboards",
+      "fields": [
+        { "name": "id", "type": "text", "pk": true },
+        { "name": "kind", "type": "text", "note": "\"explorer\" or \"sql\"" },
+        { "name": "config", "type": "text", "note": "JSON matching SqlDashboardConfig" }
+      ]
+    },
+    {
+      "id": "dashboard_views",
+      "name": "dashboard_views",
+      "note": "Saved filter presets per dashboard",
+      "fields": [
+        { "name": "id", "type": "text", "pk": true },
+        { "name": "dashboard_id", "type": "text", "fk": "dashboards.id" }
+      ]
+    },
+    {
+      "id": "analyses",
+      "name": "analyses",
+      "note": "Re-runnable ad-hoc investigations",
+      "fields": [
+        { "name": "id", "type": "text", "pk": true },
+        { "name": "question", "type": "text" },
+        { "name": "instructions", "type": "text", "note": "Re-run steps" },
+        { "name": "dataSources", "type": "text", "note": "Sources touched" },
+        { "name": "resultMarkdown", "type": "text" },
+        { "name": "resultData", "type": "text", "nullable": true }
+      ]
+    },
+    {
+      "id": "bigquery_cache",
+      "name": "bigquery_cache",
+      "note": "Result cache keyed by SQL hash",
+      "fields": [
+        { "name": "sql_hash", "type": "text", "pk": true },
+        { "name": "bytes_processed", "type": "integer" }
+      ]
+    }
+  ],
+  "relations": [
+    { "from": "dashboards", "to": "dashboard_views", "kind": "1-n", "label": "saved views" }
+  ]
+}
+```
+
+بالإضافة إلى جداول المشاركة لكل مورد (`dashboard_shares`، `analysis_shares`) والجداول التنظيمية (`organizations`، `org_members`، `org_invitations`) المقدمة من `@agent-native/core/org`. يوجد قاموس البيانات في جدول `settings` الخاص بإطار العمل ضمن المفاتيح المحددة النطاق.
+
+- **`dashboards`** — لوحتا معلومات Explorer وSQL. `kind` هو `"explorer"` أو `"sql"`؛ `config` عبارة عن كائن ثنائي كبير الحجم JSON يطابق `SqlDashboardConfig`.
+- **`dashboard_shares`** — منح المشاركة لكل مورد (الرئيسي، الدور).
+- **`dashboard_views`** — إعدادات التصفية المحفوظة مسبقًا لكل لوحة معلومات.
+- **`analyses`** — تحقيقات مخصصة باستخدام `question`، و`instructions`، و`dataSources`، و`resultMarkdown`، و`resultData` الاختيارية.
+- **`analysis_shares`** — منح المشاركة لكل مورد لإجراء التحليلات.
+- **`bigquery_cache`** — ذاكرة التخزين المؤقت لنتائج الاستعلام التي يتم إدخالها بواسطة تجزئة SQL مع المحاسبة التي تتم معالجتها بالبايت.
+
+بالإضافة إلى الجداول التنظيمية (`organizations`، `org_members`، `org_invitations`) المقدمة من `@agent-native/core/org`.
+
+يعيش قاموس البيانات في جدول `settings` الخاص بإطار العمل ضمن المفاتيح المحددة النطاق؛ راجع `list-data-dictionary` و`save-data-dictionary-entry` actions لمعرفة الشكل الكامل.
+
+### تخصيصه
+
+من المفترض أن يكون قالب Analytics متشعبًا وموسعًا. كل شيء يعيش في `templates/analytics/`:
+
+- **`AGENTS.md`** — دليل المستوى الأعلى للوكيل. طرق عرض المستندات وactions وسير العمل.
+- **`actions/`** — كل عملية يمكن استدعاءها من قبل الوكيل. أضف ملفًا جديدًا لإضافة إجراء جديد. أبرزها:
+  - `update-dashboard.ts` — تعديلات لوحة التحكم (عمليات + استبدال كامل)
+  - `save-analysis.ts` / `list-analyses.ts` — التحليلات المخصصة
+  - `save-data-dictionary-entry.ts` / `list-data-dictionary.ts` — القاموس
+  - `bigquery.ts` — تنفيذ BigQuery الأولي
+  - `view-screen.ts` / `navigate.ts` — الوعي بالسياق
+- **`app/routes/`** — المسارات المستندة إلى الملف. كل مسار عبارة عن غلاف رفيع حول صفحة في `app/pages/`.
+- **`app/pages/adhoc/sql-dashboard/`** — عارض لوحة المعلومات SQL، ومحرر اللوحة، وشريط التصفية، وطرق العرض المحفوظة.
+- **`app/pages/analyses/`** — قائمة التحليلات وعرض التفاصيل.
+- **`app/pages/DataSources.tsx`** — إعداد مصدر البيانات UI.
+- **`app/pages/DataDictionary.tsx`** — متصفح القاموس ومحرره.
+- **`.agents/skills/`** — نمط يرشد الوكيل إلى القراءة عند الطلب:
+  - `dashboard-management` - التخزين، ودقة النطاق، وشكل تكوين لوحة المعلومات
+  - `data-querying` — البرنامج النصي الذي يجب الوصول إليه، وأنماط التصفية
+  - `adhoc-analysis` — سير العمل للتحقيقات عبر المصادر
+  - `data-querying`, `real-time-sync`, `frontend-design`, `storing-data`, `self-modifying-code`
+- **`.builder/skills/<provider>/SKILL.md`** — الأخطاء الخاصة بموفر الخدمة (BigQuery، HubSpot، Jira، GA4، وما إلى ذلك). اقرأ قبل الاستعلام؛ قم بالتحديث عندما تتعلم شيئًا جديدًا.
+- **`server/db/schema.ts`** — مخطط Drizzle للوحات المعلومات، والمشاركات، وطرق العرض، والتحليلات، وذاكرة التخزين المؤقت BigQuery.
+- **`server/lib/dashboards-store.ts`** — قراءة/كتابة لوحة المعلومات مع دقة النطاق وترحيل KV القديم.
+- **`server/lib/bigquery.ts`** — عميل BigQuery، ومدقق التشغيل الجاف، ومنطق ذاكرة التخزين المؤقت.
+
+لإضافة مصدر بيانات جديد، قم بإسقاط برنامج نصي في `actions/` يستدعي الموفر ويعيد النتائج عبر مساعد `output()`. ويصبح متاحًا للوكيل على الفور ويمكن استخدامه داخل لوحات المعلومات (إذا قمت بكشف النتيجة عبر معالج الخادم).
+
+لإضافة نوع مخطط جديد، قم بتوسيع اتحاد `ChartType` في `app/pages/adhoc/sql-dashboard/types.ts`، وتعامل معه في `SqlChartCard.tsx`، ويمكن للوكيل استخدامه في أي لوحة.
+
+للحصول على النمط الأوسع حول توسيع القوالب، راجع [Skills guide](/docs/skills-guide) و[Actions](/docs/actions).

package/docs/content/locales/ar-SA/template-assets.md

@@ -0,0 +1,303 @@
+---
+title: "الأصول"
+description: "مدير أصول رقمية أصلي للوكيل وخدمة إنشاء مشتركة بين الوكلاء للوسائط المتوافقة مع العلامة التجارية."
+---
+
+# الأصول
+
+الأصول عبارة عن مساحة عمل أصلية للوكيل لإنشاء الوسائط المتوافقة مع العلامة التجارية وإدارتها. فهو ينظم التحميلات والنتائج التي تم إنشاؤها في المكتبات والمجلدات، ويتيح للفرق جمع الأمثلة لأبطال المدونات والرسوم البيانية والصفحات المقصودة ولقطات المنتج ومقاطع الفيديو والشعارات، ثم توجيه عملية الإنشاء عبر دردشة الوكيل حتى يمكن مراجعة كل أصل وتحسينه.
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Launch brand</h1><span class='wf-pill accent'>Blog heroes</span><span class='wf-pill'>Product shots</span><span class='wf-pill'>Logos</span><div style='flex:1'></div><button>Upload</button><button class='primary'>Generate</button></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Create brand media</strong><div class='wf-box'>Three homepage hero options using the approved logo and product references.</div><div style='display:flex;gap:8px;flex-wrap:wrap'><span class='wf-pill accent'>4 references</span><span class='wf-pill'>16:9</span><span class='wf-pill'>Web export</span></div></div><div style='display:grid;grid-template-columns:repeat(3,1fr);gap:12px;flex:1'><div class='wf-card' style='display:flex;align-items:end;min-height:130px'><span class='wf-pill accent'>Hero A</span></div><div class='wf-card' style='display:flex;align-items:end;min-height:130px'><span class='wf-pill'>Reference set</span></div><div class='wf-card' style='display:flex;align-items:end;min-height:130px'><span class='wf-pill'>Logo safe</span></div></div><div class='wf-card' style='display:grid;grid-template-columns:repeat(4,1fr);gap:8px'><div class='wf-box'>Use</div><div class='wf-box'>Refine</div><div class='wf-box'>Compare</div><div class='wf-box'>Export</div></div></div>"
+}
+```
+
+عند فتح التطبيق، تظل المكتبة المحددة والموجه والمراجع والمرشحون الذين تم إنشاؤهم في مساحة عمل واحدة. يمكن للوكيل تصفح كل الأصول والبحث فيها وإنشاءها وتحسينها وتصديرها من خلال نفس actions الذي يستخدمه UI.
+
+```an-diagram title="Generate, review, reuse" summary="References and prompts feed a generate-and-choose session; chosen assets land in a library and flow out to other apps via the picker or A2A."
+{
+  "html": "<div class=\"diagram-assets\"><div class=\"diagram-col\"><div class=\"diagram-node\">References<br><small class=\"diagram-muted\">logos, product shots, style</small></div><div class=\"diagram-node\">Prompt<br><small class=\"diagram-muted\">chat or Generate controls</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><span class=\"diagram-pill accent\">Generation session</span><small class=\"diagram-muted\">image &amp; video candidates · audit log</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><span class=\"diagram-pill ok\">Library</span><small class=\"diagram-muted\">chosen, brand-consistent assets</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-node\">Picker<br><small class=\"diagram-muted\">iframe / MCP App</small></div><div class=\"diagram-node\">A2A<br><small class=\"diagram-muted\">Slides · Design · Content</small></div></div></div>",
+  "css": ".diagram-assets{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-assets .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-assets .diagram-box{display:flex;flex-direction:column;gap:4px}.diagram-assets .diagram-arrow{font-size:20px;line-height:1}"
+}
+```
+
+## متى يتم اختياره
+
+- **يحتاج فريقك إلى توجيه مرئي قابل لإعادة الاستخدام**، وليس مطالبات إعلامية عامة لمرة واحدة — اجمع الشعارات المعتمدة ولقطات المنتجات وأمثلة الأنماط حتى تظل الأجيال متمسكة بالعلامة التجارية.
+- **تريد مراجعة الوسائط التي تم إنشاؤها وتحسينها**، مع سجل تدقيق كامل للمطالبات والنماذج والمراجع والنسب لكل عملية تشغيل.
+- **تحتاج التطبيقات الأخرى إلى منتقي الأصول أو المنشئ** — يمكن للشرائح أو التصميم أو المحتوى أو محرر المدونات أو أداة إنشاء المواقع تضمين المنتقي أو استدعاء الأصول عبر A2A.
+- **تريد أن تكون وسائط العلامة التجارية متاحة من وكيل الترميز** — يمكن لـ Codex أو Claude Code أو Claude أو ChatGPT إنشاء الأصول واختيارها دون مغادرة الدردشة.
+
+## البدء
+
+عرض توضيحي مباشر: [assets.agent-native.com](https://assets.agent-native.com).
+
+1. **إنشاء مكتبة.** أضف العلامة التجارية أو الحملة أو المنتج أو مصدر المحتوى الذي تستخدمه
+   تريد الإدارة.
+2. **تحميل المراجع.** أضف الشعارات المعتمدة، أو لقطات المنتج، أو أمثلة الأنماط، أو
+   مقاطع الفيديو الموجودة بحيث يكون لدى الوكيل مادة ملموسة للعمل منها.
+3. **إنشاء من الدردشة أو المكتبة.** اطلب صورة رئيسية أو رسم تخطيطي أو منتج
+   لقطة، أو متغير فيديو. تقوم الأصول بتخزين الموجه والمراجع والنموذج والحالة
+   والنسب للمراجعة.
+4. **استخدم الأصل في مكان آخر.** انسخ التصدير وقم بتضمين المنتقي في مكان آخر
+   التطبيق، أو اسمح لوكيل آخر بالاتصال بالأصول عبر A2A.
+
+## مطالبات مفيدة
+
+- "أنشئ ثلاثة خيارات رئيسية للمدونة باستخدام مراجع منتج Acme."
+- "إنشاء صورة اجتماعية مربعة بأسلوب حملة الإطلاق."
+- "ابحث عن جميع الأصول المعتمدة لإعادة تصميم الإعداد."
+- "تحويل هذا المخطط الذي تم تحميله إلى صورة توضيحية واضحة للمنتج."
+- "قم بإنشاء لوحة عمل للفيديو واحفظ أفضل إطار تم تعيينه لهذه المكتبة."
+
+## ما يمكنك فعله به
+
+- **إنشاء مكتبات الأصول.** تجميع الصور المرجعية ومقاطع الفيديو والشعارات الأساسية وملاحظات الأنماط واللوحات والمجلدات والمخرجات التي تم إنشاؤها حسب العلامة التجارية أو الحملة أو المنتج أو الفئة.
+- **الإنشاء من خلال الدردشة.** يقوم المؤلف الرئيسي والمكتبة بعناصر التحكم في الإنشاء بإرسال المطالبة إلى الوكيل باستخدام `sendToAgentChat()`، حتى يتمكن المستخدمون من فحص المتغيرات وتقديم التعليقات والتكرار.
+- **إنشاء صور ومقاطع فيديو.** يتوفر إنشاء الصور المُدارة بواسطة Builder عند تمكينه، ويعمل Gemini على تشغيل إنشاء الفيديو بالإضافة إلى إمكانية الرجوع اليدوي للصور.
+- **تحميل ووصف المراجع.** أضف صورًا أو مقاطع فيديو من المكتبة UI أو زر إرفاق المؤلف الفوري، ثم ابحث حسب العنوان أو الوصف أو النص البديل أو المطالبة أو النموذج أو نوع الوسائط أو الحالة أو الدور أو المجلد أو المجموعة.
+- **احتفظ بسجل تدقيق الإنشاء.** تسجل كل عملية تشغيل المطالبات والنموذج ونسبة العرض إلى الارتفاع والمراجع وأصول المصدر والنسب والأصول التي تم إنشاؤها والحالة والأخطاء والطوابع الزمنية لمراجعة التصميم لاحقًا.
+- **الحفاظ على دقة الشعار.** يمكن للوكيل إنشاء منطقة نائب ويقوم الخادم بتركيب الشعار الأساسي الذي تم تحميله على الصورة النهائية بدلاً من الاعتماد على نموذج الصورة لإعادة رسمه.
+- **التضمين كمنتقي.** يمكن للتطبيقات الأخرى وضع إطار iframe لـ `/picker` والاستماع إلى حدث `chooseAsset` من `@agent-native/embedding`، وتحويل الأصول إلى منتقي/مولد أصول لمحرري المدونات، ومنشئي المواقع، ومجموعات الشرائح، والتطبيقات المخصصة. يقوم المنتقي أيضًا بإصدار الاسم المستعار `chooseImage` القديم لمضيفي الصور فقط الحاليين.
+- **التثبيت كمهارة مدعومة بالتطبيق.** يصدر بيان `agent-native.app-skill.json` مهارة الأصول بالإضافة إلى البيانات التعريفية لموصل MCP حتى تتمكن الأسواق من تثبيت التطبيق وتعليماته ومنتقيه معًا.
+- **خدمة وكلاء آخرين.** يمكن للشرائح والتصميم والمحتوى والبريد والإرسال استدعاء الأصول من خلال A2A لسرد المكتبات وإنشاء الدفعات وإنشاء مقاطع الفيديو وتحسين الأصل وجلب الصادرات وتقديم المعاينات المضمنة حيث يُسمح بالتضمين.
+
+## استخدامه من وكيل الترميز الخاص بك
+
+قم بإنشاء وسائط العلامة التجارية واختيارها دون مغادرة Codex أو Claude Code أو Claude أو ChatGPT.
+
+1. **التثبيت مرة واحدة.** يؤدي ذلك إلى إضافة تعليمات المهارة وتسجيل موصل MCP المستضاف معًا:
+
+   ```باش
+   npx @agent-native/core@latest skills إضافة الأصول # الاسم المستعار: إنشاء الصور
+   ```
+
+   العميل الافتراضي هو `codex`؛ أضف `--client claude-code` أو `--client all` للآخرين.
+   إذا كنت تريد فقط تعليمات المهارات المحمولة من خلال Vercel/open
+   Skills CLI، استخدم:
+
+   ```باش
+   npx skills@latest أضف BuilderIO/agent-native --أصول المهارة
+   ```
+
+   يقوم Vercel/open Skills CLI بتثبيت ملف التعليمات فقط؛ لا
+   قم بتشغيل إعداد موصل MCP. استخدم مسار Agent Native CLI أعلاه عندما تريد
+   إعداد الأمر الواحد.
+
+2. **اطلب الصور.** في دردشة وكيلك: "أنشئ ثلاثة خيارات رئيسية للمدونة من لقطات منتج Acme." يفتح الوكيل المنتقي بالصور المرشحة التي يمكنك تجديدها وإعادة ضبطها (المطالبة، العرض الجانبي، العدد)، والاختيار من بينها.
+3. **اختيار.** في المضيفات المضمنة (ChatGPT، Claude.ai، Claude الدردشة الرئيسية لسطح المكتب) يتم عرض المنتقي مباشرة في الدردشة - انقر فوق مرشح وسيتدفق الاختيار مرة أخرى تلقائيًا. على مضيفات CLI/الارتباط فقط (Codex، Claude Code، علامة التبويب "Code" لسطح المكتب Claude) تحصل على رابط **"فتح في الأصول →"**؛ افتحها، واختر المتصفح، ثم الصق ملخص التسليم المنسوخ مرة أخرى في الدردشة - أو قل فقط "استخدم الصورة أ".
+
+   ```نص
+   ألصق هذا التحديد مرة أخرى في الدردشة الخاصة بك حتى يتمكن الوكيل من استخدامه.
+
+   صورة الأصول المحددة للخطوة التالية: <label>
+   الوسائط URL: <url>
+   استخدم هذا الأصل المحدد في القطعة الأثرية أو التصميم الحالي.
+
+   سياق الأصول المحدد:
+   { "selectedAsset": { "assetId": "..."، "url": "..."، "mediaType": "image"، ... }
+   ```
+
+4. **تطبيق على التعليمات البرمجية.** تعود الوسائط المختارة URL و`assetId` إلى الوكيل، الذي يستخدم URL مباشرة في الكود الذي يكتبه (`<img>` src، تنزيل) أو يستدعي `export-asset`.
+
+## للمطورين
+
+باقي هذا المستند مخصص لأي شخص يقوم بتعديل قالب الأصول أو توسيعه.
+
+### السقالات
+
+```bash
+npx @agent-native/core@latest create my-assets --standalone --template assets
+```
+
+### نموذج البيانات
+
+تعيش جميع البيانات في SQL عبر Drizzle ORM (تعيش الوسائط الثنائية في تخزين الكائنات، أو احتياطي تحميل الملفات المحلي أثناء التطوير). المخطط: `templates/assets/server/db/schema.ts`. تحمل المكتبات معيار `ownableColumns` وجدول مشاركات إطار العمل المطابق، بحيث يتم إدراجها في نموذج المشاركة لكل مستخدم/لكل مؤسسة.
+
+ملاحظة: تحتفظ أسماء الجداول SQL ببادئة `image_*` القديمة منذ أن كان التطبيق يسمى الصور. وهي تغطي مقاطع الفيديو والوسائط الأخرى أيضًا.
+
+| الجدول                           | ما يحمله                                                                                                                                                                                |
+| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `image_libraries`                | المكتبة — حاوية المستوى الأعلى المُجمَّعة حسب العلامة التجارية أو الحملة أو المنتج أو الفئة. يحمل `custom_instructions` و`style_brief` والشعار الأساسي ومراجع أصول الغلاف وحالة الأرشيف |
+| `image_library_shares`           | يشارك إطار العمل مبادئ تعيين الجدول (المستخدمين أو المؤسسات) إلى الأدوار (العارض، المحرر، المسؤول) لكل مكتبة                                                                            |
+| `image_collections`              | مجموعات الأنماط/الفئة داخل المكتبة - `style_brief`، `prompt_template`، نسبة العرض إلى الارتفاع الافتراضية وحجم الصورة                                                                   |
+| `asset_folders`                  | المجلدات القابلة للتداخل داخل المكتبة (`parent_id` للتسلسل الهرمي)                                                                                                                      |
+| `image_generation_presets`       | وصفات الجيل المحفوظ - نوع الوسائط، ونموذج المطالبة، ونسبة العرض إلى الارتفاع، والنموذج، وسياسة النص/المرجع                                                                              |
+| `image_generation_sessions`      | جلسة إنشاء واختيار متكررة تتضمن ملخصًا موجزًا عن الحالة والأصل النشط وملخصًا للتعليقات                                                                                                  |
+| `image_generation_session_items` | مرشح الأصول داخل الجلسة، لكل منها دور وملاحظة                                                                                                                                           |
+| `image_assets`                   | سجل الأصول - نوع الوسائط، والدور، والحالة، والعنوان/الوصف/النص البديل، والموجه، والنموذج، والأبعاد، ونوع MIME، ومفاتيح الكائن/الصور المصغرة، والنسب                                     |
+| `image_generation_runs`          | سجل تدقيق الإنشاء - المطالبة، والموجهات المجمعة، والنموذج، والمراجع، والحالة، والأخطاء، و`source` (`chat` / `ui` / `a2a`) التي أدت إلى تشغيله                                           |
+
+```an-schema title="Assets data model" summary="Libraries are the ownable container; collections, folders, and presets organize them. Sessions drive generate-and-choose; assets and runs hold output and the audit log. Table names keep the legacy image_* prefix but cover all media."
+{
+  "entities": [
+    { "id": "library", "name": "image_libraries", "note": "Top-level ownable container", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "custom_instructions", "type": "text", "nullable": true },
+      { "name": "style_brief", "type": "text", "nullable": true },
+      { "name": "logo_asset_id", "type": "id", "fk": "image_assets.id", "nullable": true },
+      { "name": "archived", "type": "boolean" }
+    ] },
+    { "id": "library_shares", "name": "image_library_shares", "note": "Framework shares table", "fields": [
+      { "name": "library_id", "type": "id", "fk": "image_libraries.id" },
+      { "name": "role", "type": "text", "note": "viewer / editor / admin" }
+    ] },
+    { "id": "collections", "name": "image_collections", "note": "Style/category groupings", "fields": [
+      { "name": "library_id", "type": "id", "fk": "image_libraries.id" },
+      { "name": "style_brief", "type": "text", "nullable": true },
+      { "name": "prompt_template", "type": "text", "nullable": true }
+    ] },
+    { "id": "folders", "name": "asset_folders", "note": "Nestable folders", "fields": [
+      { "name": "library_id", "type": "id", "fk": "image_libraries.id" },
+      { "name": "parent_id", "type": "id", "fk": "asset_folders.id", "nullable": true }
+    ] },
+    { "id": "presets", "name": "image_generation_presets", "note": "Saved generation recipes", "fields": [
+      { "name": "media_type", "type": "text" },
+      { "name": "prompt_template", "type": "text" },
+      { "name": "model", "type": "text" }
+    ] },
+    { "id": "sessions", "name": "image_generation_sessions", "note": "Iterative generate-and-choose", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "status", "type": "text" },
+      { "name": "active_asset_id", "type": "id", "fk": "image_assets.id", "nullable": true }
+    ] },
+    { "id": "session_items", "name": "image_generation_session_items", "note": "Candidate assets in a session", "fields": [
+      { "name": "session_id", "type": "id", "fk": "image_generation_sessions.id" },
+      { "name": "asset_id", "type": "id", "fk": "image_assets.id" },
+      { "name": "role", "type": "text" }
+    ] },
+    { "id": "assets", "name": "image_assets", "note": "The asset record", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "media_type", "type": "text", "note": "image / video" },
+      { "name": "status", "type": "text" },
+      { "name": "prompt", "type": "text", "nullable": true },
+      { "name": "object_key", "type": "text", "nullable": true }
+    ] },
+    { "id": "runs", "name": "image_generation_runs", "note": "Generation audit log", "fields": [
+      { "name": "model", "type": "text" },
+      { "name": "status", "type": "text" },
+      { "name": "source", "type": "text", "note": "chat / ui / a2a" }
+    ] }
+  ],
+  "relations": [
+    { "from": "library", "to": "collections", "kind": "1-n" },
+    { "from": "library", "to": "folders", "kind": "1-n" },
+    { "from": "library", "to": "assets", "kind": "1-n" },
+    { "from": "sessions", "to": "session_items", "kind": "1-n" },
+    { "from": "library", "to": "library_shares", "kind": "1-n" }
+  ]
+}
+```
+
+### تخصيصه
+
+الأصول عبارة عن قالب كامل وقابل للاستنساخ. بعض الأفكار الإضافية العملية:
+
+- "أضف موصل كتالوج المنتج بحيث يمكن تحديد اللقطات المرجعية للمنتج بواسطة SKU."
+- "أضف قائمة انتظار موافقة صارمة قبل أن يتم وضع علامة على الأصول التي تم إنشاؤها بأنها قابلة للاستخدام في التسويق."
+- "أضف لوحة تحكم لمراجعة العلامة التجارية تعمل على تصفية الأجيال الفاشلة أو ذات التصنيف المنخفض حسب الطراز."
+- "إنشاء مكتبة أصول افتراضية على مستوى مساحة العمل وتوجيه إنشاء صور الشرائح من خلالها."
+- "أضف موفرًا جديدًا خلف واجهة إنشاء الصور بعد التحقق من أحدث مستندات الموفر."
+
+يقوم الوكيل بتحرير المسارات والمكونات والنماذج المدعومة actions وskills وSQL حسب الحاجة. راجع [Templates](/docs/cloneable-saas) للاطلاع على الاستنساخ الكامل والتخصيص والنشر و[A2A Protocol](/docs/a2a-protocol) للإنشاء عبر التطبيقات.
+
+### تضمين المنتقي
+
+استخدم مسار الانتقاء عندما يقوم أحد الأشخاص باختيار أو إنشاء أصل بالداخل
+منتج آخر. الصورة هي نوع الوسائط الافتراضي؛ قم بتمرير `mediaType=video` عندما
+تريد تصفح/تحديد الفيديو:
+
+```tsx
+import { EmbeddedApp } from "@agent-native/embedding";
+
+<EmbeddedApp
+  url="https://assets.agent-native.com/picker?mediaType=image"
+  onMessage={(name, payload) => {
+    if (name === "chooseAsset") {
+      insertAsset((payload as { url: string }).url);
+    }
+  }}
+/>;
+```
+
+يجب على مضيفي MCP الخارجيين استدعاء `open-asset-picker` بدلاً من إنشاء هذا
+إطار iframe يدويًا. يُرجع الإجراء رابطًا احتياطيًا للمتصفح وبيانات تعريف تطبيق MCP
+للمضيفين المضمنين. عندما يقوم المستخدم بتحديد أحد الأصول، يقوم المنتقي بإصدار `chooseAsset`،
+الاسم المستعار `chooseImage` القديم لأصول الصور، وتحديث نموذج تطبيق MCP
+السياق الذي يدعمه المضيف. عندما يفتح المضيف الرابط الاحتياطي في
+علامة تبويب المتصفح العادية بدلاً من عرض تطبيق MCP بشكل مضمن، وتحديد أحد الأصول
+ينسخ ملخص التسليم ويعرض كتلة سياق قابلة للنسخ؛ الصق هذا الملخص
+الرجوع إلى الدردشة حتى يتمكن الوكيل الخارجي من استخدام الوسائط المحددة URL و
+البيانات الوصفية للأصول.
+
+يجب التعامل مع Codex وClaude Code وClaude Desktop Code كمضيفين للارتباط
+لهذا التدفق. لا يجوز لهم عرض تطبيقات MCP مضمنة، وتخفيض CDN عن بعد
+قد لا يتم عرض الصور بشكل موثوق في نص الدردشة. يجب على الوكلاء الاحتفاظ بـ
+رابط الأصول كمصدر للحقيقة؛ عندما تكون هناك حاجة إلى معاينة مضمنة مرئية في
+دردشة محرر التعليمات البرمجية، قم بتنزيل `previewUrl`/`downloadUrl` المحدد على موقع محلي
+ملف صورة وقم بتضمين هذا المسار المحلي المطلق.
+
+لإنشاء التدفقات واختيارها، اتصل بـ `open-asset-picker` مع `prompt`،
+`autoGenerate: true` و`count: 3` (قابل للتخصيص من 1-6). يتم فتح المنتقي
+مع الصور المرشحة ويتيح للمستخدم ضبط العدد أو نسبة العرض إلى الارتفاع أو
+تم الإنشاء مسبقًا قبل اختيار الأصل النهائي URL.
+
+استخدم A2A عندما يحتاج وكيل آخر إلى إنشاء الأصول أو البحث عنها أو تصديرها بدون
+المنتقي البشري UI.
+
+### المطور: توزيع مهارة التطبيق
+
+تحتوي مهارة تطبيق الأصول على معرف التطبيق `assets` وتستضيف MCP URL
+`https://assets.agent-native.com/_agent-native/mcp`.
+
+```bash
+# Easiest hosted install: exported skill instructions plus MCP connector.
+npx @agent-native/core@latest skills add assets
+
+# Vercel/open Skills CLI install: exported instructions only, no MCP config.
+npx skills@latest add BuilderIO/agent-native --skill assets
+
+# Hosted install: URL-only MCP connector, no shared secrets in skill files.
+npx @agent-native/core@latest app-skill ensure --manifest templates/assets/agent-native.app-skill.json
+
+# Local editable launch.
+npx @agent-native/core@latest app-skill launch --manifest templates/assets/agent-native.app-skill.json --local --into ./assets-local
+
+# Marketplace package, including Claude Code marketplace and Vercel Labs skills adapters.
+npx @agent-native/core@latest app-skill pack --manifest templates/assets/agent-native.app-skill.json --out ./dist/assets-skill
+
+# Install a local exported Assets bundle with the open skills CLI.
+npx skills@latest add ./dist/assets-skill --skill assets -a codex -y
+
+# Install from the generated Claude Code marketplace adapter.
+claude plugin marketplace add ./dist/assets-skill/adapters/claude-marketplace
+claude plugin install agent-native-assets@agent-native-apps
+```
+
+تُعلم المهارة المُصدَّرة الوكلاء كيفية استخدام المنتقي للتفاعل البشري في الحلقة
+التحديد، actions المباشر لإنشاء صور/فيديو غير مراقب، والمتصفح
+الروابط عندما تكون تطبيقات MCP المضمنة غير متاحة.
+
+يحتوي محول السوق Claude على `.claude-plugin/marketplace.json`
+الكتالوج والمكون الإضافي `agent-native-assets` مع `skills/assets/SKILL.md` plus
+`.mcp.json` المستضاف. في كود Claude التفاعلي، يتوفر نفس التدفق
+مثل `/plugin marketplace add ./dist/assets-skill/adapters/claude-marketplace`،
+`/plugin install agent-native-assets@agent-native-apps`، `/reload-plugins`، و
+`/mcp` للمصادقة MCP.
+
+إذا قمت بالتثبيت من حزمة سوق أولية باستخدام `npx skills@latest`، فقم بتسجيل
+موصل MCP مستضاف حتى تتمكن هذه التعليمات من استدعاء تطبيق الأصول المباشرة:
+
+```bash
+npx @agent-native/core@latest app-skill ensure --manifest ./dist/assets-skill/agent-native.app-skill.json --yes
+```
+
+## ما هي الخطوة التالية
+
+- [**Templates**](/docs/cloneable-saas) — نموذج الاستنساخ والامتلاك
+- [**Embedding SDK**](/docs/embedding-sdk) — منتقي iframe وأنماط السيارة الجانبية
+- [**A2A Protocol**](/docs/a2a-protocol) — كيف تستدعي التطبيقات الأخرى الأصول
+- [**File Uploads**](/docs/file-uploads) — التخزين وخدمة الأصول الموثقة
+- [**Sharing & Privacy**](/docs/sharing) — التحكم في الوصول على مستوى المكتبة