> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venice.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Venice Skills

> مهارات وكلاء Venice الرسمية تُحمّل معرفة endpoints إلى Claude Code وCursor وCodex وOpenCode وHermes وCline حتى تستدعي وكلاء البرمجة Venice بشكل صحيح.

[Venice Skills](https://github.com/veniceai/skills) هي المجموعة الرسمية من [Agent Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) لـ Venice API. كل مهارة عبارة عن مجلد مستقل بذاته يحتوي على `SKILL.md` يقوم وكيل LLM بتحميله عند الطلب للعمل بشكل صحيح مع منطقة معينة من سطح API.

<Card title="GitHub: veniceai/skills" icon="github" href="https://github.com/veniceai/skills">
  19 مهارة تغطي Venice API بالكامل. مرخصة تحت MIT. تظل متزامنة مع [`swagger.yaml`](/api-reference/api-spec) العام.
</Card>

<CardGroup cols={3}>
  <Card title="19 مهارة" icon="layer-group">
    واحدة لكل منطقة من سطح Venice API
  </Card>

  <Card title="مستقلة عن وقت التشغيل" icon="plug">
    تعمل مع Claude Code و Cursor و Codex و OpenCode و Hermes و Cline وأي مضيف Agent Skills آخر
  </Card>

  <Card title="مزامنة مع المواصفات" icon="rotate">
    مشتقة من مواصفات OpenAPI الخاصة بـ Venice، مع فحوصات CI للكشف عن الانحراف
  </Card>
</CardGroup>

## لماذا المهارات؟

بدون المهارات، يتعين على وكيلك اكتشاف خصوصيات Venice بالطريقة الصعبة: `venice_parameters`، وقيم enum لنوع النموذج، وتدفقات 402 payment-required، ودورة حياة queue/retrieve للفيديو، و character slugs، وما إلى ذلك. تجمع المهارات تلك المعرفة في ملفات مركّزة عند الطلب بحيث لا يحمّل الوكيل سوى ما يحتاجه للمهمة الحالية.

يتضمن كل `SKILL.md`:

* نقطة (نقاط) النهاية التي يغطيها
* الترويسات والمعاملات وأشكال الاستجابة المطلوبة
* مثال curl بالإضافة إلى مثال SDK بسيط
* قسم "gotchas" بالأشياء التي يتعثر فيها المدمجون الفعليون

## كتالوج المهارات

| المهارة                      | تغطي                                                                                                |
| ---------------------------- | --------------------------------------------------------------------------------------------------- |
| `venice-api-overview`        | الـ Base URL، وأوضاع المصادقة، وترويسات الاستجابة، ونموذج التسعير، والإصدارات                       |
| `venice-auth`                | مفاتيح Bearer API + مصادقة Sign-In-With-X / x402 wallet                                             |
| `venice-chat`                | `/chat/completions` مع `venice_parameters`، multimodal، tools، reasoning، streaming                 |
| `venice-responses`           | `/responses`، واجهة Responses API المتوافقة مع OpenAI (Alpha)                                       |
| `venice-embeddings`          | نماذج `/embeddings`، وتنسيقات الترميز، والأبعاد                                                     |
| `venice-image-generate`      | `/image/generate`, `/images/generations`, `/image/styles`                                           |
| `venice-image-edit`          | `/image/edit`, `/image/multi-edit`, `/image/upscale`, `/image/background-remove`                    |
| `venice-audio-speech`        | نماذج TTS عبر `/audio/speech`، والأصوات، والتنسيقات، والبث                                          |
| `venice-audio-music`         | `/audio/quote`, `/audio/queue`, `/audio/retrieve`, `/audio/complete`                                |
| `venice-audio-transcription` | `/audio/transcriptions` مع Whisper و Parakeet و Scribe و Wizper و xAI STT                           |
| `venice-video`               | توليد `/video/*` + النسخ النصي                                                                      |
| `venice-models`              | `/models`, `/models/traits`, `/models/compatibility_mapping`                                        |
| `venice-characters`          | `/characters*` + `venice_parameters.character_slug`                                                 |
| `venice-api-keys`            | CRUD `/api_keys`، وحدود المعدل، توليد مفاتيح Web3                                                   |
| `venice-billing`             | `/billing/balance`, `/billing/usage`, `/billing/usage-analytics`                                    |
| `venice-x402`                | اعتمادات محفظة `/x402/*`، USDC على Base أو Solana                                                   |
| `venice-crypto-rpc`          | وكيل JSON-RPC عبر `/crypto/rpc/*` مع تسعير 1×/2×/4×                                                 |
| `venice-augment`             | `/augment/text-parser`, `/augment/scrape`, `/augment/search`                                        |
| `venice-errors`              | أشكال الأخطاء، 402 payment required، 422 content policy، 429 rate limits، استراتيجية إعادة المحاولة |

## التثبيت

كل مهارة هي مجرد مجلد يحتوي على `SKILL.md` يبدأ بـ YAML frontmatter:

```yaml theme={"system"}
---
name: venice-chat
description: When the agent should load this skill and what's in it
---
```

ضع مجلد `skills/` (أو أي مجموعة فرعية) في أي مسار يراقبه وقت التشغيل لديك.

<Tabs>
  <Tab title="Claude Code">
    محلي للمشروع:

    ```bash theme={"system"}
    git clone https://github.com/veniceai/skills.git
    cp -r skills/skills/* .claude/skills/
    ```

    أو عمومي، لكل مشروع على جهازك:

    ```bash theme={"system"}
    git clone https://github.com/veniceai/skills.git ~/src/venice-skills
    ln -s ~/src/venice-skills/skills ~/.claude/skills/venice
    ```
  </Tab>

  <Tab title="Cursor">
    محلي للمشروع:

    ```bash theme={"system"}
    git clone https://github.com/veniceai/skills.git .cursor/skills-venice
    ```

    أو انسخ مهارات فردية:

    ```bash theme={"system"}
    cp -r skills/venice-chat .cursor/skills/
    ```
  </Tab>

  <Tab title="Codex">
    ```bash theme={"system"}
    git clone https://github.com/veniceai/skills.git ~/src/venice-skills
    ln -s ~/src/venice-skills/skills ~/.codex/skills/venice
    ```

    للتثبيتات المحلية للمشروع، استهدف `.codex/skills/` بدلاً من ذلك.
  </Tab>

  <Tab title="OpenCode">
    ```bash theme={"system"}
    git clone https://github.com/veniceai/skills.git ~/src/venice-skills
    ln -s ~/src/venice-skills/skills ~/.config/opencode/skills/venice
    ```

    يقرأ OpenCode أيضًا `.opencode/skills/` و `.claude/skills/` و `.agents/skills/` من جذر المشروع.
  </Tab>

  <Tab title="Hermes Agent">
    يحتوي Hermes على مُثبِّت مدمج لمهارات Venice:

    ```bash theme={"system"}
    hermes skills install veniceai/skills
    ```

    أو رابط رمزي مباشرة:

    ```bash theme={"system"}
    git clone https://github.com/veniceai/skills.git ~/src/venice-skills
    ln -s ~/src/venice-skills/skills ~/.hermes/skills/venice
    ```
  </Tab>

  <Tab title="Cline">
    ```bash theme={"system"}
    git clone https://github.com/veniceai/skills.git .clinerules/skills-venice
    ```
  </Tab>
</Tabs>

### مرجع المسارات

| وقت التشغيل      | محلي للمشروع                                                      | عمومي                                         |
| ---------------- | ----------------------------------------------------------------- | --------------------------------------------- |
| Claude Code      | `.claude/skills/`                                                 | `~/.claude/skills/`                           |
| Codex            | `.codex/skills/`                                                  | `~/.codex/skills/` (أو `$CODEX_HOME/skills/`) |
| OpenCode         | `.opencode/skills/` (وأيضًا `.claude/skills/`, `.agents/skills/`) | `~/.config/opencode/skills/`                  |
| Hermes Agent     | `$HERMES_OPTIONAL_SKILLS_DIR`                                     | `~/.hermes/skills/`                           |
| Cursor           | `.cursor/skills/`                                                 | `~/.cursor/skills/`                           |
| Cline            | `.clinerules/skills/`                                             | غير متاح                                      |
| أوقات تشغيل أخرى | `.agents/skills/` (اصطلاح)                                        | `~/.agents/skills/`                           |

<Tip>
  أوقات التشغيل التي تحدد حقول frontmatter إضافية (`version`, `platforms`, `metadata.*`, `compatibility`, …) مطلوبة بحسب المواصفات لتجاهل الحقول غير المعروفة، لذا فإن نفس ملف المهارة يعمل في كل مكان دون forks.
</Tip>

### كـ git submodule

إذا كنت تريد إصدارات مثبتة في مستودعك الخاص:

```bash theme={"system"}
git submodule add https://github.com/veniceai/skills.git vendor/venice-skills
```

ثم اربط أو انسخ المجموعات الفرعية التي تريدها إلى مسار المهارات الخاص بوكيلك.

## كيف يحمّلها الوكلاء

يكتشف الوكيل كل `SKILL.md` عبر `name` و `description` في frontmatter. عندما يسأل المستخدم شيئًا يطابق غرض مهارة ما، يحمّل الوكيل ذلك الملف الواحد في السياق (وليس الكتالوج بأكمله)، بحيث تبقى المطالبة صغيرة وتبقى الإجابة دقيقة.

على سبيل المثال، الوكيل الذي يحتاج إلى توليد موسيقى سيحمّل `venice-audio-music` ويعرف فورًا:

* أن الموسيقى تمر عبر دورة حياة queue/retrieve/complete، وليس عبر نقطة نهاية متزامنة
* أي النماذج متاحة وتسعيرها لكل دقيقة
* كيفية استدعاء `/audio/quote` لتقدير التكلفة أولًا
* كيف ينبغي أن يبدو polling backoff

بدون المهارة، قد يحاول الوكيل استدعاء `/audio/speech` للموسيقى ويحصل على استجابة عديمة الفائدة.

## تأليف مهارة جديدة

1. انسخ `template/` إلى `skills/<your-skill>/`.
2. املأ frontmatter والمحتوى. اجعل `description` ملموسًا، لأنه ما يستخدمه الوكيل ليقرر متى يحمّل المهارة.
3. اربط المهارات ذات الصلة في الأسفل للتنقل المتبادل.
4. افتح PR مقابل [`veniceai/skills`](https://github.com/veniceai/skills).

راجع `CONTRIBUTING.md` في المستودع لاصطلاحات الأسلوب (فقرة أولى قصيرة، جداول نقاط نهاية صريحة، curl + مثال SDK واحد، قسم "gotchas"، ≤ 500 سطر).

## الموارد

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="https://github.com/veniceai/skills">
    شفرة المصدر، ودليل المساهمة، وقالب المهارة
  </Card>

  <Card title="خادم Venice MCP" icon="plug" href="/guides/integrations/venice-mcp">
    اقرن المهارات مع خادم MCP الرسمي للوصول إلى الأدوات وقت التشغيل
  </Card>

  <Card title="مواصفات Agent Skills" icon="arrow-up-right-from-square" href="https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview">
    تعلم التنسيق الأساسي
  </Card>

  <Card title="مواصفات Venice API" icon="book" href="/api-reference/api-spec">
    مصدر الحقيقة OpenAPI الذي تُشتق منه هذه المهارات
  </Card>
</CardGroup>