Skip to content

BuilderIO/agent-native / packages/core/docs

agent-native-docs

Unverified

How to look up version-matched Agent-Native framework docs and source in node_modules. Use before coding against @agent-native/core APIs or advanced features.

FileKindSize
AGENTS.mdmarkdown6.0 KB
SKILL.mdskill md2.2 KB
content/a2a-protocol.mdxmarkdown37.6 KB
content/actions-access-control.mdxmarkdown28.9 KB
content/actions-advanced.mdxmarkdown13.1 KB
content/actions-agent-tools.mdxmarkdown5.6 KB
content/actions-defining.mdxmarkdown31.2 KB
content/actions-other-surfaces.mdxmarkdown10.3 KB
content/actions-overview.mdxmarkdown8.3 KB
content/actions-run-context.mdxmarkdown9.1 KB
content/add-ui-to-your-agent.mdxmarkdown5.0 KB
content/administered-deployments.mdxmarkdown7.7 KB
content/agent-mentions.mdxmarkdown10.2 KB
content/agent-native-config.mdxmarkdown34.9 KB
content/agent-native-toolkit.mdxmarkdown17.3 KB
content/agent-resources.mdxmarkdown27.0 KB
content/agent-surfaces.mdxmarkdown33.8 KB
content/agent-teams.mdxmarkdown13.4 KB
content/agent-web-surfaces.mdxmarkdown10.7 KB
content/agentkit.mdxmarkdown14.0 KB
content/audit-log.mdxmarkdown14.3 KB
content/authentication.mdxmarkdown30.7 KB
content/automation-connectors.mdxmarkdown7.8 KB
content/automations.mdxmarkdown26.7 KB
content/aws-amplify.mdxmarkdown10.7 KB
content/aws-lambda.mdxmarkdown13.9 KB
content/aws-rds.mdxmarkdown1.7 KB
content/azure-postgresql.mdxmarkdown1.8 KB
content/azure-static-web-apps.mdxmarkdown9.1 KB
content/blueprint-installer.mdxmarkdown6.3 KB
content/cli-adapters.mdxmarkdown5.7 KB
content/client-advanced.mdxmarkdown13.1 KB
content/client-agent-chat.mdxmarkdown17.7 KB
content/client-data.mdxmarkdown19.3 KB
content/client-entry-points.mdxmarkdown1.2 KB
content/client-overview.mdxmarkdown10.6 KB
content/client-routing.mdxmarkdown5.7 KB
content/client-sync-internals.mdxmarkdown5.2 KB
content/cloneable-saas.mdxmarkdown16.6 KB
content/cloud-sql.mdxmarkdown2.3 KB
content/cloudflare.mdxmarkdown8.3 KB
content/code-agents-ui.mdxmarkdown26.6 KB
content/components.mdxmarkdown42.9 KB
content/context-awareness.mdxmarkdown24.9 KB
content/create-with-an-agent.mdxmarkdown8.8 KB
content/creating-templates.mdxmarkdown21.6 KB
content/cross-app-connect-design.mdxmarkdown8.4 KB
content/cross-app-sso.mdxmarkdown8.7 KB
content/custom-design-system.mdxmarkdown17.3 KB
content/data-programs.mdxmarkdown25.0 KB
content/decisions.mdxmarkdown7.9 KB
content/deno-deploy.mdxmarkdown7.2 KB
content/deploy-an-app.mdxmarkdown5.0 KB
content/deployment-environment-variables.mdxmarkdown16.3 KB
content/deployment.mdxmarkdown11.3 KB
content/dispatch.mdxmarkdown18.6 KB
content/docker.mdxmarkdown8.1 KB
content/docs-components.mdxmarkdown28.9 KB
content/doctor.mdxmarkdown21.3 KB
content/drafts/clips-experimental-features.mdmarkdown5.4 KB
content/drop-in-agent.mdxmarkdown16.0 KB
content/durable-background-runs.mdxmarkdown13.8 KB
content/durable-resume.mdxmarkdown10.0 KB
content/embedding-sdk.mdxmarkdown31.3 KB
content/environment-variables.mdxmarkdown29.9 KB
content/evals.mdxmarkdown12.4 KB
content/extensions.mdxmarkdown34.8 KB
content/external-agents-catalog.mdxmarkdown40.5 KB
content/external-agents.mdxmarkdown29.3 KB
content/file-uploads.mdxmarkdown10.7 KB
content/generative-ui.mdxmarkdown10.8 KB
content/getting-started-actions.mdxmarkdown2.7 KB
content/getting-started-pages.mdxmarkdown2.6 KB
content/getting-started.mdxmarkdown7.2 KB
content/harness-agents.mdxmarkdown16.9 KB
content/http-api.mdxmarkdown20.9 KB
content/integrations.mdxmarkdown33.8 KB
content/internationalization.mdxmarkdown6.2 KB
content/key-concepts.mdxmarkdown30.6 KB
content/koyeb.mdxmarkdown7.3 KB
content/locales/ar-SA/a2a-protocol.mdxmarkdown48.5 KB
content/locales/ar-SA/actions-access-control.mdxmarkdown40.8 KB
content/locales/ar-SA/actions-advanced.mdxmarkdown16.3 KB
content/locales/ar-SA/actions-agent-tools.mdxmarkdown8.1 KB
content/locales/ar-SA/actions-defining.mdxmarkdown42.2 KB
content/locales/ar-SA/actions-other-surfaces.mdxmarkdown14.5 KB
content/locales/ar-SA/actions-overview.mdxmarkdown11.3 KB
content/locales/ar-SA/actions-run-context.mdxmarkdown11.1 KB
content/locales/ar-SA/add-ui-to-your-agent.mdxmarkdown3.7 KB
content/locales/ar-SA/administered-deployments.mdxmarkdown6.4 KB
content/locales/ar-SA/agent-mentions.mdxmarkdown11.8 KB
content/locales/ar-SA/agent-native-toolkit.mdxmarkdown17.3 KB
content/locales/ar-SA/agent-resources.mdxmarkdown36.8 KB
content/locales/ar-SA/agent-surfaces.mdxmarkdown48.4 KB
content/locales/ar-SA/agent-teams.mdxmarkdown18.5 KB
content/locales/ar-SA/agent-web-surfaces.mdxmarkdown14.3 KB
content/locales/ar-SA/audit-log.mdxmarkdown15.9 KB
content/locales/ar-SA/authentication.mdxmarkdown39.8 KB
content/locales/ar-SA/automations.mdxmarkdown31.3 KB
content/locales/ar-SA/aws-amplify.mdxmarkdown14.9 KB
content/locales/ar-SA/aws-lambda.mdxmarkdown18.9 KB
content/locales/ar-SA/aws-rds.mdxmarkdown319 B
content/locales/ar-SA/azure-postgresql.mdxmarkdown344 B
content/locales/ar-SA/azure-static-web-apps.mdxmarkdown12.4 KB
content/locales/ar-SA/blueprint-installer.mdxmarkdown8.4 KB
content/locales/ar-SA/cli-adapters.mdxmarkdown6.7 KB
content/locales/ar-SA/client-advanced.mdxmarkdown17.8 KB
content/locales/ar-SA/client-agent-chat.mdxmarkdown23.0 KB
content/locales/ar-SA/client-data.mdxmarkdown23.8 KB
content/locales/ar-SA/client-entry-points.mdxmarkdown1.6 KB
content/locales/ar-SA/client-overview.mdxmarkdown13.9 KB
content/locales/ar-SA/client-routing.mdxmarkdown7.2 KB
content/locales/ar-SA/client-sync-internals.mdxmarkdown7.3 KB
content/locales/ar-SA/cloneable-saas.mdxmarkdown23.2 KB
content/locales/ar-SA/cloud-sql.mdxmarkdown317 B
content/locales/ar-SA/cloudflare.mdxmarkdown11.9 KB
content/locales/ar-SA/code-agents-ui.mdxmarkdown34.2 KB
content/locales/ar-SA/components.mdxmarkdown51.5 KB
content/locales/ar-SA/context-awareness.mdxmarkdown33.1 KB
content/locales/ar-SA/create-with-an-agent.mdxmarkdown12.2 KB
content/locales/ar-SA/creating-templates.mdxmarkdown26.8 KB
content/locales/ar-SA/cross-app-connect-design.mdxmarkdown1.5 KB
content/locales/ar-SA/cross-app-sso.mdxmarkdown9.7 KB
content/locales/ar-SA/custom-design-system.mdxmarkdown21.6 KB
content/locales/ar-SA/data-programs.mdxmarkdown33.3 KB
content/locales/ar-SA/decisions.mdxmarkdown9.1 KB
content/locales/ar-SA/deno-deploy.mdxmarkdown10.1 KB
content/locales/ar-SA/deploy-an-app.mdxmarkdown7.1 KB
content/locales/ar-SA/deployment-environment-variables.mdxmarkdown21.3 KB
content/locales/ar-SA/deployment.mdxmarkdown13.9 KB
content/locales/ar-SA/dispatch.mdxmarkdown27.3 KB
content/locales/ar-SA/docker.mdxmarkdown11.3 KB
content/locales/ar-SA/doctor.mdxmarkdown3.4 KB
content/locales/ar-SA/drop-in-agent.mdxmarkdown20.8 KB
content/locales/ar-SA/durable-resume.mdxmarkdown15.4 KB
content/locales/ar-SA/embedding-sdk.mdxmarkdown41.3 KB
content/locales/ar-SA/evals.mdxmarkdown13.3 KB
content/locales/ar-SA/extensions.mdxmarkdown34.0 KB
content/locales/ar-SA/external-agents.mdxmarkdown89.3 KB
content/locales/ar-SA/file-uploads.mdxmarkdown13.4 KB
content/locales/ar-SA/getting-started-actions.mdxmarkdown3.2 KB
content/locales/ar-SA/getting-started-pages.mdxmarkdown3.2 KB
content/locales/ar-SA/getting-started.mdxmarkdown9.7 KB
content/locales/ar-SA/harness-agents.mdxmarkdown22.3 KB
content/locales/ar-SA/internationalization.mdxmarkdown8.2 KB
content/locales/ar-SA/key-concepts.mdxmarkdown42.0 KB
content/locales/ar-SA/koyeb.mdxmarkdown10.2 KB
content/locales/ar-SA/mcp-apps.mdxmarkdown33.7 KB
content/locales/ar-SA/mcp-clients.mdxmarkdown35.0 KB
content/locales/ar-SA/mcp-protocol.mdxmarkdown27.6 KB
content/locales/ar-SA/messaging.mdxmarkdown59.2 KB
content/locales/ar-SA/multi-app-workspace.mdxmarkdown36.2 KB
content/locales/ar-SA/multi-tenancy.mdxmarkdown7.5 KB
content/locales/ar-SA/native-chat-ui.mdxmarkdown21.3 KB
content/locales/ar-SA/neon.mdxmarkdown244 B
content/locales/ar-SA/netlify.mdxmarkdown15.2 KB
content/locales/ar-SA/node-docker.mdxmarkdown878 B
content/locales/ar-SA/node-js.mdxmarkdown8.4 KB
content/locales/ar-SA/notifications.mdxmarkdown16.2 KB
content/locales/ar-SA/observability.mdxmarkdown45.2 KB
content/locales/ar-SA/observational-memory.mdxmarkdown10.9 KB
content/locales/ar-SA/onboarding.mdxmarkdown16.9 KB
content/locales/ar-SA/organizations-teams-permissions.mdxmarkdown5.9 KB
content/locales/ar-SA/package-lifecycle.mdxmarkdown3.0 KB
content/locales/ar-SA/plan-plugin.mdxmarkdown23.0 KB
content/locales/ar-SA/portal.mdxmarkdown636 B
content/locales/ar-SA/postgres.mdxmarkdown487 B
content/locales/ar-SA/pr-visual-recap.mdxmarkdown53.9 KB
content/locales/ar-SA/privacy-and-data-rights.mdxmarkdown6.2 KB
content/locales/ar-SA/processors.mdxmarkdown8.7 KB
content/locales/ar-SA/progress.mdxmarkdown10.7 KB
content/locales/ar-SA/pure-agent-apps.mdxmarkdown5.0 KB
content/locales/ar-SA/real-time-collaboration.mdxmarkdown55.6 KB
content/locales/ar-SA/recorder.mdxmarkdown16.7 KB
content/locales/ar-SA/recurring-jobs.mdxmarkdown23.8 KB
content/locales/ar-SA/render.mdxmarkdown11.2 KB
content/locales/ar-SA/sandbox-adapters.mdxmarkdown18.0 KB
content/locales/ar-SA/security.mdxmarkdown31.5 KB
content/locales/ar-SA/server-database.mdxmarkdown27.6 KB
content/locales/ar-SA/server-middleware.mdxmarkdown7.9 KB
content/locales/ar-SA/server-overview.mdxmarkdown12.2 KB
content/locales/ar-SA/server-plugins.mdxmarkdown9.1 KB
content/locales/ar-SA/server-routes.mdxmarkdown14.3 KB
content/locales/ar-SA/sharing.mdxmarkdown28.6 KB
content/locales/ar-SA/skills-guide.mdxmarkdown27.0 KB
content/locales/ar-SA/ssr-caching.mdxmarkdown7.4 KB
content/locales/ar-SA/supabase.mdxmarkdown264 B
content/locales/ar-SA/syncing-template-changes.mdxmarkdown11.7 KB
content/locales/ar-SA/telemetry.mdxmarkdown21.9 KB
content/locales/ar-SA/template-analytics.mdxmarkdown26.4 KB
content/locales/ar-SA/template-assets.mdxmarkdown31.9 KB
content/locales/ar-SA/template-brain.mdxmarkdown29.7 KB
content/locales/ar-SA/template-calendar-agent.mdxmarkdown10.2 KB
content/locales/ar-SA/template-calendar-developers.mdxmarkdown33.4 KB
content/locales/ar-SA/template-calendar-features.mdxmarkdown14.4 KB
content/locales/ar-SA/template-calendar-integrations.mdxmarkdown6.2 KB
content/locales/ar-SA/template-calendar.mdxmarkdown4.4 KB
content/locales/ar-SA/template-chat-agent.mdxmarkdown4.7 KB
content/locales/ar-SA/template-chat-developers.mdxmarkdown31.3 KB
content/locales/ar-SA/template-chat-features.mdxmarkdown9.9 KB

content/locales/ar-SA/skills-guide.mdx

View on GitHub
---
title: "دليل Skills"
description: "كيفية عمل skills في الوكيل الأصلي: إطار العمل skills والمجال skills وإنشاء skills مخصص."
---

# دليل Skills

المهارات هي ملفات Markdown تمنح الوكيل معرفة عميقة بأنماط وسير عمل محددين. وبدلاً من حشد كل قاعدة في مطالبة نظام واحدة، تقسّم المعرفة إلى ملفات مركّزة لا يحمّلها الوكيل إلا عندما تحتاج المهمة إليها فعلاً — فيظل السياق الافتراضي صغيراً مع تمكين الوكيل من التعمق عند الطلب.

## ما هي skills {#what-are-skills}

Skills موجود في `.agents/skills/<name>/SKILL.md` ويحتوي على إرشادات مفصلة للوكيل. تركز كل مهارة على اهتمام واحد - كيفية تخزين البيانات، وكيفية مزامنة الحالة، وكيفية تفويض العمل إلى دردشة الوكيل.

يتم دائمًا إدخال المادة الأمامية لكل مهارة `name` و`description` في كتلة skills الخاصة بموجه النظام حتى يعرف العميل ما هو skills الموجود. يتم تحميل جسم المهارة بالكامل عند الطلب عندما يقرر الوكيل أن المهارة ذات صلة بالمهمة (يتم عرضها أيضًا عبر `docs-search`). ولهذا السبب فإن إبقاء الأوصاف قصيرة ومحددة للمشغل أمر مهم: الوصف هو الشيء الوحيد الذي يقرأه الوكيل قبل أن يقرر تحميل الباقي أم لا.

<Diagram id="doc-block-dyws55" title={"الكشف التدريجي"} summary={"فقط الاسم + الوصف لكل مهارة يكون دائمًا في السياق. يتم تحميل الجسم بالكامل عند الطلب عندما تتطابق المهمة."}>

```html
<div class="sk-flow">
  <div class="diagram-card">
    <span class="diagram-pill accent">دائما في موجه النظام</span>
    <div class="sk-list">
      <span class="diagram-pill"
        >storing-data &mdash;
        <small class="diagram-muted">add data models&hellip;</small></span
      ><span class="diagram-pill"
        >real-time-sync &mdash;
        <small class="diagram-muted">wire polling&hellip;</small></span
      ><span class="diagram-pill"
        >create-skill &mdash;
        <small class="diagram-muted">add a skill&hellip;</small></span
      >
    </div>
    <small class="diagram-muted">just name + description (cheap)</small>
  </div>
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
  <div class="diagram-panel center">
    <small class="diagram-muted">task matches a description</small
    ><span class="diagram-pill accent">load on demand</span>
  </div>
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
  <div class="diagram-box">
    Full <code>SKILL.md</code> body<br /><small class="diagram-muted"
      >قواعد، كود، افعل ولا تفعل</small
    >
  </div>
</div>
```

```css
.sk-flow {
  display: flex;
  align-items: center;
  gap: 14px;
  flex-wrap: wrap;
}
.sk-flow .diagram-card {
  display: flex;
  flex-direction: column;
  gap: 8px;
  padding: 14px 16px;
  min-width: 240px;
}
.sk-flow .sk-list {
  display: flex;
  flex-direction: column;
  gap: 6px;
}
.sk-flow .center {
  display: flex;
  flex-direction: column;
  align-items: center;
  gap: 6px;
}
.sk-flow .diagram-arrow {
  font-size: 22px;
}
```

</Diagram>

## إطار العمل skills {#framework-skills}

هذه هي skills المجمعة مع **القالب الافتراضي**. تعتمد المجموعة المحددة المتوفرة في أي تطبيق معين على القالب الذي قمت بتركيبه منه — تحقق من دليل `.agents/skills/` الخاص بهذا القالب لمعرفة ما يتم شحنه بالفعل.

| المهارة                | متى يتم الاستخدام                                                     |
| ---------------------- | --------------------------------------------------------------------- |
| `storing-data`         | إضافة نماذج البيانات أو تكوين القراءة/الكتابة أو الحالة               |
| `real-time-sync`       | مزامنة استقصاء الأسلاك، عدم تحديث تصحيح أخطاء UI                      |
| `delegate-to-agent`    | تفويض عمل الذكاء الاصطناعي من UI أو actions إلى الوكيل                |
| `actions`              | إنشاء أو تشغيل الوكيل actions                                         |
| `self-modifying-code`  | تحرير مصدر التطبيق أو مكوناته أو أنماطه                               |
| `create-skill`         | إضافة skills جديد للوكيل                                              |
| `capture-learnings`    | تسجيل التصحيحات والأنماط                                              |
| `frontend-design`      | إنشاء أو تصميم أي صفحة ويب UI أو مكوناتها أو صفحاتها                  |
| `adding-a-feature`     | قائمة التحقق المكونة من أربع مناطق: UI، actions، skills، حالة التطبيق |
| `internationalization` | تحديث نسخة UI المترجمة وكتالوجات اللغات وأنماط RTL الآمنة             |
| `shadcn-ui`            | استخدام العناصر الأولية والمكونات shadcn/ui                           |
| `security`             | المصادقة والتحكم في الوصول والتعامل السري                             |
| `real-time-collab`     | التحرير التعاوني متعدد المستخدمين                                     |
| `agent-engines`        | تبديل محرك الوكيل الأساسي أو تكوينه                                   |
| `notifications`        | أنماط الإشعارات داخل التطبيق والإشعارات الفورية                       |
| `progress`             | تتبع وإظهار تقدم المهام في الخلفية                                    |
| `inline-embeds`        | تضمين التطبيقات أو إطارات iframe داخل دردشة الوكيل                    |

`context-awareness` و`a2a-protocol` هما skills على مستوى إطار العمل ومتوفران في دليل `.agents/skills/` في جذر الريبو - راجع `.agents/skills/` الخاص بكل قالب لمعرفة ما يرثه.

## المجال skills {#domain-skills}

تتضمن القوالب skills الخاصة بمجالها. توجد هذه العناصر في نفس دليل `.agents/skills/` ولكنها تغطي أنماطًا خاصة بالقالب. راجع دليل `.agents/skills/` الخاص بكل قالب للحصول على القائمة الكاملة؛ عينة تمثيلية:

- **قالب البريد** — `email-drafts`، `draft-queue`
- **قالب النماذج** — `form-building`، `form-publishing`، `form-responses`
- **نموذج التحليلات** — `adhoc-analysis`، `bigquery`، `cross-source-analysis`، `dashboard-management`، `data-querying`، `provider-api`، `gong`، `hubspot`، `prometheus`
- **نموذج الشرائح** — `create-deck`، `deck-management`، `design-systems`، `slide-editing`، `slide-images`

يتبع المجال skills نفس تنسيق إطار العمل skills. فهي تقوم بتشفير أنماط خاصة بالقالب الذي يجب على الوكيل اتباعه.

## skills المدعوم بالتطبيق {#app-backed-skills}

تشمل skills المدعومة بالتطبيق حاليًا `visual-plan` و`visual-recap` و`visualize-repo` من Plan، و`visual-edit` و`remix` من Design، و`assets` من Assets، و`content` لتحرير docs/blog/MDX المدعوم بالمستودع.

<Callout tone="info">

**التفاصيل الكاملة أدناه:** يتم تغطية آليات skills المدعومة بالتطبيق (تنسيق البيان، وأوامر CLI، ومحولات السوق، وتجزئة التحديث التلقائي) في [App-backed skills — full details](#app-backed-skills-full).

تُصدر حزم `app-skill` أيضًا ملفات Agent Plugin قياسية. استخدم `agent-native plugin import <path> --into <workspace> --yes` لاستيراد Skills وMCP البعيدة عبر Streamable HTTP؛ يتم تجاهل الرؤوس، بينما يتم الإبلاغ عن خوادم stdio وSSE وتخطيها.

</Callout>

## إنشاء skills مخصص {#creating-skills}

إنشاء مهارة عندما:

- هناك نمط يجب على الوكيل اتباعه بشكل متكرر
- يحتاج سير العمل إلى إرشادات خطوة بخطوة
- تريد دمج الملفات من قالب

لا تنشئ مهارة عندما:

- الإرشاد موجود بالفعل في مهارة أخرى - قم بتوسيعه بدلاً من ذلك
- التوجيه يتم لمرة واحدة - ضعه في `AGENTS.md` أو ذاكرة الوكيل بدلاً من ذلك

## تنسيق المهارة {#skill-format}

كل مهارة عبارة عن ملف Markdown مع المادة الأمامية YAML:

<AnnotatedCode
  id="doc-block-1cl3ufb"
  title={"تشريح SKILL.md"}
  filename=".agents/skills/project-imports/SKILL.md"
  language="markdown"
  code={
    "---\nname: project-imports\ndescription: >-\n  How to import projects from the legacy CSV export. Use when the user uploads\n  a project CSV or asks to migrate projects from the old system.\n---\n\n# Project Imports\n\n## Rule\n\nAlways validate the CSV header row before writing any rows. Reject unknown\ncolumns rather than silently dropping them.\n\n## How\n\n1. Call `get-import-schema` to fetch the expected columns.\n2. Parse the first CSV row and diff against the schema.\n3. If any required columns are missing, return an error — do not proceed.\n4. Stream remaining rows through `create-project-item` in batches of 50.\n\n## Don't\n\n- Don't hold all rows in memory — stream them.\n- Don't create duplicate projects; check for an existing name first.\n\n## Related Skills\n\n- **storing-data** — SQL schema and write patterns for new rows\n- **sharing** — exposing a project to other users after import"
  }
  annotations={[
    {
      lines: "2",
      label: "مفتاح الاكتشاف",
      note: "The `name` matches the folder; it is how the skill is invoked as `/project-imports`.",
    },
    {
      lines: "3-5",
      label: "المشغل",
      note: "هذا `description` هو النص **الوحيد** الموجود دائمًا في السياق. اجعلها تشير بدقة *متى* تنطبق المهارة.",
    },
    {
      lines: "9-14",
      label: "القواعد أولاً",
      note: "Lead with the hard rule and the why; the agent reads the body only once the task matches.",
    },
    {
      lines: "27-30",
      label: "الارتباط المتبادل",
      note: "أشر إلى المهارات ذات الصلة حتى يتمكن الوكيل من تسلسلها بدلاً من إعادة استخلاص التوجيه.",
    },
  ]}
/>

يتم استخدام المادة الأمامية `name` و`description` بواسطة نظام أدوات العميل لاكتشاف المهارات. يجب أن يشير الوصف إلى وقت تفعيل المهارة - كن محددًا بشأن المواقف.

احفظ الملف في `.agents/skills/my-skill/SKILL.md`. يجب أن يتطابق اسم الدليل مع `name` في المادة الأمامية.

<Callout tone="info">

**راجع أيضًا:** [Writing Agent Instructions](/docs/writing-agent-instructions) للتعرف على كيفية صياغة أوصاف المهارات، وتطبيق الكشف التدريجي، والحفاظ على `AGENTS.md`. تستخدم كلتا الصفحتين مهارة `project-imports` كمثال عملي.

</Callout>

## نطاق المهارة: وقت التشغيل مقابل التطوير {#skill-scope}

يتحكم حقل المادة الأمامية الاختياري `scope` في العميل الذي تستهدفه المهارة:

| `scope`   | هل تم التحميل بواسطة وكيل وقت التشغيل؟ | استخدام لـ                                                                 |
| --------- | -------------------------------------- | -------------------------------------------------------------------------- |
| `both`    | نعم (افتراضي)                          | Skills مفيد للوكيل داخل التطبيق. هذا هو الإعداد الافتراضي عند حذف `scope`. |
| `runtime` | نعم                                    | Skills مخصص لوكيل وقت التشغيل داخل التطبيق فقط.                            |
| `dev`     | لا                                     | Skills مخصص فقط لعامل التشفير البشري (مثل رمز Claude).                     |

```markdown
---
name: release-checklist
description: >-
  Steps for cutting a release. Use when preparing or publishing a new version.
scope: dev
---
```

عند غياب `scope` (أو تعيينه على قيمة غير معروفة)، يتم تعيينه افتراضيًا على `both`، لذلك يستمر تحميل كل مهارة موجودة في وقت التشغيل — هذا الحقل متوافق تمامًا مع الإصدارات السابقة. مهارة `scope: dev` غير مرئية لعامل وقت التشغيل في كل مكان: فهي مستبعدة من كتلة skills التي تم حقنها في موجه النظام ومن نتائج `docs-search`.

### إظهار مهارة خاصة بالمطورين فقط لوكيل البرمجة الخاص بك {#dev-only-skills}

يقرأ وقت التشغيل الأصلي للوكيل skills من `.agents/skills/`. يقرأ رمز Claude skills من `.claude/skills/` بشكل مستقل. لإتاحة مهارة لوكيل الترميز الخاص بك ولكنها مخفية عن وكيل وقت التشغيل:

- ضع علامة `scope: dev` في `.agents/skills/<name>/SKILL.md` حتى لا يقوم وكيل وقت التشغيل بتحميله أبدًا، و/أو
- ضع المهارة أو اعكسها ضمن `.claude/skills/<name>/SKILL.md` حتى يلتقطها كود Claude.

يحل هذا محل الاختراق القديم المتمثل في الاعتماد على كود Claude الذي يقرأ `.claude/skills` فقط - `scope: dev` يجعل تقسيم وقت التشغيل مقابل التطوير خيارًا صريحًا من الدرجة الأولى.

<Diagram id="doc-block-1cyxyfn" title={"أي وكيل يقوم بتحميل أي مهارة"} summary={"يحدد النطاق ما إذا كان وكيل وقت التشغيل داخل التطبيق يرى مهارة أم لا. تكون مهارات التطوير مرئية فقط لوكيل البرمجة الخاص بك."}>

```html
<div class="sc-grid">
  <div class="diagram-card">
    <span class="diagram-pill">.agents/skills/</span>
    <div class="sc-row">
      <span class="diagram-pill ok">scope: both</span
      ><small class="diagram-muted">default</small>
    </div>
    <div class="sc-row">
      <span class="diagram-pill ok">scope: runtime</span>
    </div>
    <div class="sc-row"><span class="diagram-pill warn">scope: dev</span></div>
  </div>
  <div class="sc-targets">
    <div class="diagram-box">
      Runtime agent<br /><small class="diagram-muted"
        >reads <code>both</code> + <code>runtime</code></small
      >
    </div>
    <div class="diagram-box">
      وكيل البرمجة<br /><small class="diagram-muted"
        >Claude Code reads <code>.claude/skills/</code> +
        <code>dev</code></small
      >
    </div>
  </div>
</div>
```

```css
.sc-grid {
  display: flex;
  gap: 24px;
  flex-wrap: wrap;
  align-items: flex-start;
}
.sc-grid .diagram-card {
  display: flex;
  flex-direction: column;
  gap: 8px;
  padding: 14px 16px;
}
.sc-grid .sc-row {
  display: flex;
  align-items: center;
  gap: 8px;
}
.sc-grid .sc-targets {
  display: flex;
  flex-direction: column;
  gap: 10px;
}
```

</Diagram>

## Skills مقابل AGENTS.md {#skills-vs-agents-md}

<Callout tone="info">

**AGENTS.md** — النظرة العامة. يسرد كافة البرامج النصية، ويصف نموذج البيانات، ويشرح بنية التطبيق. يقرأ الوكيل هذا أولاً لفهم التطبيق.

**Skills** — الغوص العميق. تركز كل مهارة على نمط واحد يحتوي على قواعد تفصيلية، وأمثلة للتعليمات البرمجية، وقوائم المهام/المحظورات. يقرأ الوكيل هذه العناصر عندما يحتاج إلى اتباع نمط معين.

</Callout>

يخبر `AGENTS.md` الوكيل _ما_ يفعله التطبيق. Skills أخبر الوكيل بكيفية القيام بأشياء محددة بشكل صحيح. كلاهما مطلوب — `AGENTS.md` للتوجيه، وskills للتنفيذ.

## Skills مقابل الذاكرة {#skills-vs-memory}

<Callout tone="info">

**Skills** — أدلة إرشادية مؤلفة وقابلة لإعادة الاستخدام. تنطبق على كل مستخدم، ويتم استدعاؤها عند الطلب عندما تتطابق المهمة.

**الذاكرة (`LEARNINGS.md` / `memory/MEMORY.md`)** — يتم تحميل الدروس المستفادة من المشروعات المشتركة والذاكرة المنظمة الشخصية في كل دورة.

</Callout>

إذا كانت المعرفة تنطبق على _جميع_ الأشخاص\_ الذين يعملون في التطبيق ("يفضلون دائمًا CTEs على الاستعلامات الفرعية")، فهي مهارة أو `LEARNINGS.md` مشتركة. إذا كان الأمر يتعلق بهذا المستخدم تحديدًا ("يحب ستيف الإجابات المختصرة")، فهو ينتمي إلى `memory/MEMORY.md`. راجع [موارد الوكيل — الذاكرة](/docs/agent-resources#memory) للحصول على العلاج الكامل.

## المهارات مقابل موارد SQL {#skills-vs-resources}

تعرض هذه الصفحة المهارة كملف في `.agents/skills/<name>/SKILL.md`. وتعرض [موارد الوكيل](/docs/agent-resources#skills) المهارة نفسها كمورد SQL في المسار `skills/<slug>/SKILL.md`، بنطاق مساحة العمل أو النطاق المشترك أو الشخصي. وهما المفهوم نفسه من زاويتين: يقرأ وضع Code الملف ويكتبه مباشرةً؛ بينما يخزّنه وضع App كسجل مورد ليعمل من دون نظام ملفات. اكتب المحتوى بتنسيق هذه الصفحة في الحالتين.

## skills المدعوم بالتطبيق - التفاصيل الكاملة {#app-backed-skills-full}

التفاصيل الكاملة لتنسيق البيان وأوامر CLI ومحولات السوق وتجزئة التحديث التلقائي وراء [المهارات المدعومة بالتطبيق](#app-backed-skills):

تبدأ كل مهارة مدعومة بالتطبيق بـ `agent-native.app-skill.json` في جذر التطبيق:

```json
{
  "schemaVersion": 1,
  "id": "assets",
  "hosted": {
    "url": "https://assets.agent-native.com",
    "mcpUrl": "https://assets.agent-native.com/mcp"
  },
  "mcp": { "serverName": "agent-native-assets" },
  "skills": [
    {
      "path": ".agents/skills/asset-generation",
      "visibility": "both",
      "exportAs": "assets"
    }
  ]
}
```

تتحكم رؤية المهارة في ما يتم شحنه:

| الرؤية     | المعنى                                                        |
| ---------- | ------------------------------------------------------------- |
| `internal` | يتم استخدامه بواسطة وكيل التطبيق، ولا يتم تصديره إلى الأسواق. |
| `exported` | يتم تصديره إلى الأسواق، ولكن لا يحتاجه التطبيق داخليًا.       |
| `both`     | يتم استخدامه داخليًا وتصديره.                                 |

المستضاف هو مسار التثبيت الافتراضي. الإطلاق المحلي واضح للتخصيص،
العمل دون اتصال بالإنترنت، أو الاستخدام الحساس للخصوصية.

يعمل `remix` أيضًا مباشرة داخل المستودع دون Design: `/remix add the stripe hero animation to ours but make it blue`. اطلب Design للاختيار بصريًا على اللوحة. يُعاد بناء السلوك من مواصفات باستخدام شيفرة أصلية.

```bash
# المسار السعيد: التعليمات المصدرة بالإضافة إلى موصل MCP المستضاف.
npx @agent-native/core@latest skills add visual-plan
npx @agent-native/core@latest skills add visualize-repo
npx @agent-native/core@latest skills add visual-edit
npx @agent-native/core@latest skills add remix
npx @agent-native/core@latest skills add assets

# تحرير Content docs/blog/MDX مع اعتبار الريبو مصدر الحقيقة.
npx @agent-native/core@latest skills add content --mode local-files --scope project

# Vercel/open Skills CLI: تعليمات مصدرة فقط، بلا تكوين MCP.
npx skills@latest add BuilderIO/agent-native --skill assets

# قم بتسجيل موصل MCP مستضاف لعملاء الوكيل المحلي.
npx @agent-native/core@latest app-skill ensure --manifest templates/assets/agent-native.app-skill.json

# تجسيد وتشغيل مصدر محلي قابل للتحرير.
npx @agent-native/core@latest app-skill launch --manifest templates/assets/agent-native.app-skill.json --local --into ./assets-local

# إنشاء محولات السوق: Codex البرنامج المساعد، Claude السوق، Vercel المهارات،
# مهارات plain/Claude وتكوينات MCP.
npx @agent-native/core@latest app-skill pack --manifest templates/assets/agent-native.app-skill.json --out ./dist/assets-skill

# ثبّت حزمة محلية مصدّرة باستخدام Vercel/open Skills CLI.
npx skills@latest add ./dist/assets-skill --skill assets -a codex -y

# قم بإضافة سوق الكود Claude الذي تم إنشاؤه، ثم قم بتثبيت البرنامج الإضافي للأصول الخاص به.
claude plugin marketplace add ./dist/assets-skill/adapters/claude-marketplace
claude plugin install agent-native-assets@agent-native-apps
```

احتفظ بالأسرار خارج ملفات المهارات. يجب أن يحتوي البيان على موصل URL فقط
بيانات التعريف؛ يتم إعداد OAuth/الجهاز في مضيف MCP أو من خلال التطبيق العادي
تدفق الإعدادات.

محول Vercel Labs `skills` عبارة عن حزمة `skills/<name>/SKILL.md` محمولة
بالنسبة إلى `npx skills@latest add ...`، إلا أن `skills` CLI الأولي يقوم بتثبيت الإرشادات فقط.
لا يقوم بتشغيل البرامج النصية لما بعد التثبيت المحددة بواسطة الريبو أو تسجيل موصلات MCP.
احتفظ بـ Agent-Native CLI كمسار المستندات الافتراضي للوكلاء المحليين لأنه
أيضًا بتسجيل موصل MCP. `BuilderIO/agent-native` هو GitHub حقيقي
مصدر مستودع Vercel/open Skills CLI؛ `skills.sh` هو اكتشاف و
دليل لوحة الصدارة، وليس مساحة اسم حزمة بنمط npm.

يكتب محول سوق Claude Code
`adapters/claude-marketplace/.claude-plugin/marketplace.json` بالإضافة إلى متداخل
دليل البرنامج المساعد الذي يحتوي على `skills/<name>/SKILL.md` و`.mcp.json`. في Claude
الرمز، إضافة السوق، تثبيت `agent-native-assets@agent-native-apps`،
أعد تحميل المكونات الإضافية، ثم قم بمصادقة موصل URL فقط MCP من `/mcp`.

تم إعداد بيانات المكونات الإضافية التي تم إنشاؤها للتحديث التلقائي: رمز Claude
مجموعات إدخال السوق `autoUpdate: true` (مع إصدار الالتزام SHA) و
يضمِّن المكون الإضافي Codex `version` تجزئة محتوى للحزمتين skills وMCP
نقطة النهاية، لذا تلتقط المكونات الإضافية المثبتة تغييرات المهارات دون إعادة التعبئة. ال
يتم نشر تطبيق الخطة بهذه الطريقة كسوق جاهز للإضافة في جذر الريبو —
راجع [Plan plugin & marketplace](/docs/plan-plugin) للتثبيت الشامل
وتدفق التحديث التلقائي.

بالنسبة للمستخدمين الذين قاموا بتثبيت skills المنسوخ من خلال CLI العالمي بدلاً من
سوق المكونات الإضافية، استخدم أوامر الحداثة CLI:

```bash
npx @agent-native/core@latest skills status visual-plan
npx @agent-native/core@latest skills update visual-plan
```

يقوم `skills update` بمسح مشروع Codex/Claude المعروف ومجلدات مهارات المستخدم، ويقارن
تجزئة المجلد المنسوخ إلى أحدث مهارة مجمعة، وإعادة كتابة المجلدات القديمة في
المكان. تتضمن Agent-Native skills المنسوخة حديثًا `agent-native-skill.json`
علامة حتى يتمكن إخراج الحالة المستقبلية من تحديد المصدر والتجزئة.

تتضمن تطبيقات ومساحات العمل Agent-Native التي تم إنشاؤها أيضًا إطار العمل المقدم
skills ضمن `.agents/skills` (أو `packages/shared/.agents/skills` في
مساحة العمل). قم بتحديث تلك السقالات skills من CLI الحالي/الأحدث باستخدام:

```bash
npm run skills:update
# أو دون الاعتماد على البرنامج النصي للحزمة المحلية:
npx @agent-native/core@latest skills update scaffold --project
```

يظل `AGENTS.md` و`.agents/skills` أساسيين. يقوم أمر التحديث أيضًا بإصلاح
روابط التوافق Claude (`CLAUDE.md` و`.claude/skills`) حتى يرى رمز Claude
نفس التعليمات دون الاحتفاظ بنسخة ثانية.

## الخطوة التالية {#whats-next}

- [**كتابة تعليمات الوكيل**](/docs/writing-agent-instructions) — صياغة أوصاف المهارات وتوزيع الإرشادات بين AGENTS.md والمهارات والذاكرة
- [**موارد الوكيل**](/docs/agent-resources#skills) — موضع المهارات كموارد SQL في وضع App
- [**إشارات الوكيل**](/docs/agent-mentions) — مشغّل أوامر `/` الذي يستدعي مهارة في الدردشة
- [**إضافة Plan والسوق**](/docs/plan-plugin) — تثبيت مهارة حقيقية مدعومة بالتطبيق وتحديثها التلقائي من البداية إلى النهاية
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 198kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 198kUpdated Claude CodeCodexVerifiedInstall