الجمعة السوداء تبدأ مبكرًا: وفّر 50% على Pro.استكشف الخطط

كيفية إضافة مهارات إلى Codex واستخدامها

يقرأ Codex المهارات من ~/.agents/skills/، ويظل يقرأ المجلد الأقدم ~/.codex/skills/، ويشغّل المهارة عندما تكتب $ واسمها. يشرح هذا الدليل كيفية تثبيت مهارة والتحقق من تحميلها وتحديد ما ينبغي وضعه في المهارة وما يناسب AGENTS.md.

لمن
مستخدمي Codex
الوقت
8 دقائق للإكمال

الإجابة المختصرة

  1. 1ضع مجلد المهارة في ~/.agents/skills/ لاستخدامها في جميع المستودعات، أو في .agents/skills/ داخل مستودع لحصرها فيه.
  2. 2يحتاج Codex إلى name (حتى 64 حرفاً) وdescription (حتى 1,024 حرفاً) في SKILL.md.
  3. 3اكتب $ مع اسم المهارة لتشغيلها، أو /skills للاختيار من قائمة.
  4. 4تريد مهارات جاهزة؟ تصفح مهارات Codex التي يمكنك تثبيتها بأمر واحد.

قبل أن تبدأ

تعمل المهارات في ثلاثة أماكن: Codex CLI وإضافة Codex لبيئة IDE وCodex في تطبيق ChatGPT لسطح المكتب. وللتثبيت من Skillry عبر CLI، تحتاج أيضاً إلى macOS أو Windows أو Linux وإلى Node.js 22 أو أحدث.

كيفية إضافة مهارات إلى Codex

يستخدم Codex وSkillry CLI المجلد الافتراضي نفسه، ~/.agents/skills/، لذا لا تحتاج إلى أي خيار إضافي. اختر الطريقة التي تناسبك.

الأسهل إذا كان Codex مفتوحاً بالفعل
  1. 1

    افتح المهارة على Skillry، واختر نسخ موجّه التثبيت، ثم اختر نسخ في مربع الحوار.

  2. 2

    الصقه في Codex وأرسله. يقرأ الوكيل تعليمات التثبيت من Skillry ويشغّل الأمر المناسب بنفسه.

    موجّه التثبيت
    Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill.
  3. 3

    عندما يطلب المتصفح الموافقة على رمز الجهاز، وافق عليه.

    يُفترض أن ترى: أن يذكر Codex الإصدار الذي ثبّته والمجلد الذي استخدمه ضمن ~/.agents/skills/.

لدى Codex أيضاً مثبّت خاص بكتالوج OpenAI، وهو $skill-installer. يضع المهارات في ~/.codex/skills/، وهو مجلد أقدم لا يزال Codex يقرأه، لذلك تظهر مهارات المثبّتين معاً.

تحقق من أن Codex وجد المهارة

في CLI أو إضافة IDE، اكتب /skills، أو اكتب $ ثم ابدأ كتابة الاسم. في تطبيق ChatGPT لسطح المكتب، افتح المهارات في الشريط الجانبي. يكتشف Codex المهارات الجديدة تلقائياً؛ وإذا لم تظهر إحداها، فأعد تشغيله.

كيفية تشغيل مهارة في Codex

اكتب $ ثم اسم المهارة ثم طلبك:

Codex CLI
$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
  • مناسبة للعمل المتكرر متعدد الخطوات
AGENTS.md

يُقرأ في بداية كل تشغيل

  • ~/.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.

المصادر

هل ساعدك هذا الدليل؟