الانتقال إلى المحتوى الرئيسي
Venice Skills هي المجموعة الرسمية من Agent Skills لـ Venice API. كل مهارة عبارة عن مجلد مستقل بذاته يحتوي على SKILL.md يقوم وكيل LLM بتحميله عند الطلب للعمل بشكل صحيح مع منطقة معينة من سطح API.

GitHub: veniceai/skills

19 مهارة تغطي Venice API بالكامل. مرخصة تحت MIT. تظل متزامنة مع swagger.yaml العام.

19 مهارة

واحدة لكل منطقة من سطح Venice API

مستقلة عن وقت التشغيل

تعمل مع Claude Code و Cursor و Codex و OpenCode و Hermes و Cline وأي مضيف Agent Skills آخر

مزامنة مع المواصفات

مشتقة من مواصفات OpenAPI الخاصة بـ Venice، مع فحوصات CI للكشف عن الانحراف

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

بدون المهارات، يتعين على وكيلك اكتشاف خصوصيات 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-keysCRUD /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: 
---
name: venice-chat
description: When the agent should load this skill and what's in it
---
ضع مجلد skills/ (أو أي مجموعة فرعية) في أي مسار يراقبه وقت التشغيل لديك.
محلي للمشروع:
git clone https://github.com/veniceai/skills.git
cp -r skills/skills/* .claude/skills/
أو عمومي، لكل مشروع على جهازك:
git clone https://github.com/veniceai/skills.git ~/src/venice-skills
ln -s ~/src/venice-skills/skills ~/.claude/skills/venice

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

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

​
كـ git submodule

إذا كنت تريد إصدارات مثبتة في مستودعك الخاص: 
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.
راجع CONTRIBUTING.md في المستودع لاصطلاحات الأسلوب (فقرة أولى قصيرة، جداول نقاط نهاية صريحة، curl + مثال SDK واحد، قسم “gotchas”، ≤ 500 سطر).

​
الموارد

GitHub

شفرة المصدر، ودليل المساهمة، وقالب المهارة

خادم Venice MCP

اقرن المهارات مع خادم MCP الرسمي للوصول إلى الأدوات وقت التشغيل

مواصفات Agent Skills

تعلم التنسيق الأساسي

مواصفات Venice API

مصدر الحقيقة OpenAPI الذي تُشتق منه هذه المهارات