الإجابة المختصرة
- 1ضع مجلد المهارة في
~/.agents/skills/لاستخدامها في جميع المستودعات، أو في.agents/skills/داخل مستودع لحصرها فيه. - 2يحتاج Codex إلى
name(حتى 64 حرفاً) وdescription(حتى 1,024 حرفاً) فيSKILL.md. - 3اكتب
$مع اسم المهارة لتشغيلها، أو/skillsللاختيار من قائمة. - 4تريد مهارات جاهزة؟ تصفح مهارات Codex التي يمكنك تثبيتها بأمر واحد.
قبل أن تبدأ
تعمل المهارات في ثلاثة أماكن: Codex CLI وإضافة Codex لبيئة IDE وCodex في تطبيق ChatGPT لسطح المكتب. وللتثبيت من Skillry عبر CLI، تحتاج أيضاً إلى macOS أو Windows أو Linux وإلى Node.js 22 أو أحدث.
كيفية إضافة مهارات إلى Codex
يستخدم Codex وSkillry CLI المجلد الافتراضي نفسه، ~/.agents/skills/، لذا لا تحتاج إلى أي خيار إضافي. اختر الطريقة التي تناسبك.
- 1
افتح المهارة على Skillry، واختر نسخ موجّه التثبيت، ثم اختر نسخ في مربع الحوار.
- 2
الصقه في Codex وأرسله. يقرأ الوكيل تعليمات التثبيت من Skillry ويشغّل الأمر المناسب بنفسه.
موجّه التثبيت Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
عندما يطلب المتصفح الموافقة على رمز الجهاز، وافق عليه.
يُفترض أن ترى: أن يذكر Codex الإصدار الذي ثبّته والمجلد الذي استخدمه ضمن
~/.agents/skills/.
- 1
سجّل الدخول مرة واحدة. ستفتح نافذة متصفح تعرض رمز جهاز لتوافق عليه.
الطرفية npx --yes skillry-cli@latest login - 2
ثبّت المهارة. لا تحتاج إلى خيار إضافي، لأن المجلد الافتراضي لواجهة CLI هو المجلد الذي يقرأه Codex.
الطرفية npx --yes skillry-cli@latest install <slug>يُفترض أن ترى:
Installed <slug> <version> to ~/.agents/skills/<slug>
اختر تنزيل ZIP في صفحة المهارة، أو استخدم مجلد مهارة حصلت عليه من مصدر آخر. اقرأ SKILL.md وما في scripts/ قبل التثبيت، لأن الوكيل يتبع هذه التعليمات ويمكنه تشغيل تلك السكربتات. ثم انقل المجلد كاملاً:
mkdir -p ~/.agents/skills
mv ~/Downloads/my-skill ~/.agents/skills/غالباً ما يُنشئ فك ZIP مستوى إضافياً، مثل my-skill/my-skill/SKILL.md. يجب أن يكون SKILL.md داخل مجلد المهارة مباشرة، وإلا فلن يجدها الوكيل.
لدى Codex أيضاً مثبّت خاص بكتالوج OpenAI، وهو $skill-installer. يضع المهارات في ~/.codex/skills/، وهو مجلد أقدم لا يزال Codex يقرأه، لذلك تظهر مهارات المثبّتين معاً.
تحقق من أن Codex وجد المهارة
في CLI أو إضافة IDE، اكتب /skills، أو اكتب $ ثم ابدأ كتابة الاسم. في تطبيق ChatGPT لسطح المكتب، افتح المهارات في الشريط الجانبي. يكتشف Codex المهارات الجديدة تلقائياً؛ وإذا لم تظهر إحداها، فأعد تشغيله.
كيفية تشغيل مهارة في Codex
اكتب $ ثم اسم المهارة ثم طلبك:
$launch-page Parcelo, a parcel-tracking dashboard for small online shopsبعد التأكد من عملها، يمكنك الطلب بلغة عادية، وسيختار Codex المهارة التي يطابق وصفها طلبك. عند تثبيت مهارات كثيرة، يختصر Codex الأوصاف لتشغل القائمة كلها نحو 2% من نافذة السياق. ضع الاستخدام الأساسي في أول جملة من الوصف حتى يبقى بعد الاختصار.
أين يبحث Codex عن المهارات؟
يجمع Codex المهارات من خمسة نطاقات. في الاستخدام اليومي ستستعمل اثنين منها: مجلدك الشخصي ومجلد المستودع.
| النطاق | الموقع |
|---|---|
| المستودع | .agents/skills/ في كل مجلد بدءاً من مكان تشغيل Codex وصولاً إلى جذر المستودع |
| شخصي | ~/.agents/skills/ |
| شخصي، أقدم | ~/.codex/skills/، لا يزال يُقرأ (غير مذكور في الوثائق، لكن تأكد ذلك من شيفرة Codex) |
| المسؤول | /etc/codex/skills/ |
| النظام | مضمنة مع Codex، مثل $skill-creator وplan |
لا يدمج Codex مهارتين لهما الاسم نفسه. يمكن أن تظهرا معاً في قائمة الاختيار، لذا احذف النسخة التي لا تريدها أو غيّر اسمها.
مهارات Codex مقارنة بـAGENTS.md
يقرأ Codex ملف AGENTS.md في بداية كل تشغيل، لذا يناسب القواعد القصيرة الدائمة. أما المهارة فلا تُحمّل إلا عندما تستدعيها مهمة، لذا تناسب الإجراءات الأطول التي تكررها.
تُحمّل عند الحاجة
- مجلد داخل
.agents/skills/ - تُحمّل عندما تطابق المهمة أو عندما تكتب
$name - مناسبة للعمل المتكرر متعدد الخطوات
يُقرأ في بداية كل تشغيل
~/.codex/AGENTS.mdأولاً، ثم ملف واحد لكل مجلد من جذر المستودع إلى مكان التشغيل- تتجاوز الملفات الأقرب إليك الملفات السابقة؛ الحد الإجمالي الافتراضي 32 KiB
- مناسب للقواعد القصيرة: أوامر الاختبار وأسلوب الشيفرة والحدود
تقسيم عملي: اجعل AGENTS.md في حدود شاشة واحدة من القواعد، وانقل الإجراءات المفصلة خطوة بخطوة إلى المهارات. يتوسع دليل المهارات مقارنة بالتعليمات في ذلك.
مهارة Codex لا تظهر؟ ابحث عن الحالة المطابقة
غالباً ما تكون المهارة المفقودة في المجلد الخطأ أو داخل مستوى إضافي بعد فك الضغط. ابحث عما تراه في العمود الأيسر.
| ما تراه | الحل |
|---|---|
غير موجودة في /skills | انقلها إلى ~/.agents/skills/<name>/ وتحقق من عدم وجود مستوى إضافي بعد فك ZIP |
| مدرجة دون وصف | أصلح الترويسة. يحتاج Codex إلى name وdescription معاً |
| مهارة المشروع غير موجودة | شغّل Codex من داخل المستودع |
لا يجد $ شيئاً في تطبيق ChatGPT لسطح المكتب | خلل مُبلّغ عنه (openai/codex#28505). افحص /skills، أو أعد التشغيل، أو جرّب وضع نسخة في ~/.codex/skills/ (لم نختبر هذا بعد) |
أسئلة شائعة
هل يدعم Codex المهارات؟
نعم. يقرأ Codex مهارات Agent Skills، وهي مجلدات SKILL.md نفسها التي يستخدمها Claude Code وCursor، في Codex CLI وإضافة IDE وتطبيق ChatGPT لسطح المكتب. تصفح مهارات Codex لتثبيت مهارة جاهزة.
أين تُخزن مهارات Codex؟
في ~/.agents/skills/ لمهاراتك الشخصية، وفي .agents/skills/ داخل المستودع، وفي /etc/codex/skills/ للمسؤولين. ويقرأ Codex أيضاً المجلد الأقدم ~/.codex/skills/ الذي يضع فيه $skill-installer المهارات.
ما الفرق بين مهارات Codex وAGENTS.md؟
يُقرأ AGENTS.md في بداية كل تشغيل. ولا تُحمّل المهارة إلا عندما تحتاج إليها مهمة.
هل تعمل مهارات Codex في ChatGPT؟
تعمل المهارات المستقلة في تطبيق ChatGPT لسطح المكتب وCodex CLI وإضافة IDE. لاستخدام مهارة في ChatGPT على الويب أو الهاتف، ضمّنها في إضافة.
كيف أصنع مهارة Codex خاصة بي؟
اطلب ذلك من $skill-creator. إنها إحدى مهارات النظام المضمنة مع Codex.
المصادر
هل ساعدك هذا الدليل؟
