Venice Skills

مهارات وكلاء Venice الرسمية (Agent Skills) تُحمّل معرفة نقاط النهاية إلى Claude Code وCursor وCodex وOpenCode وHermes وCline لبناء وكلاء برمجة موثوقين.

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-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:

---
name: venice-chat
description: When the agent should load this skill and what's in it
---

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

Claude Code

محلي للمشروع:

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

Cursor

محلي للمشروع:

git clone https://github.com/veniceai/skills.git .cursor/skills-venice

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

cp -r skills/venice-chat .cursor/skills/

Codex

git clone https://github.com/veniceai/skills.git ~/src/venice-skills
ln -s ~/src/venice-skills/skills ~/.codex/skills/venice

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

OpenCode

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/ من جذر المشروع.

Hermes Agent

يحتوي Hermes على مُثبِّت مدمج لمهارات Venice:

hermes skills install veniceai/skills

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

git clone https://github.com/veniceai/skills.git ~/src/venice-skills
ln -s ~/src/venice-skills/skills ~/.hermes/skills/venice

Cline

git clone https://github.com/veniceai/skills.git .clinerules/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 الذي تُشتق منه هذه المهارات