تثبيت potato-skill في وكيل البرمجة الخاص بك
ثبّت potato-skill في Claude Code أو Codex أو Cursor أو وكيل برمجة آخر، مع أمر التثبيت ومجلد المهارات لكل وكيل.
potato-skill مهارة وكيل، أي مجلد من التعليمات والسكربتات المساعدة يستطيع أي وكيل برمجة يدعم هذه الصيغة أن يحمّله. يثبّت Claude Code المهارة potato-skill بوصفها إضافة، ويحصل كل وكيل آخر على المجلد من npx skills add davidjurgens/potato-skill مع اسم الوكيل بعد --agent. لكل من Claude Code وCodex وCursor صفحة إعداد خاصة به. ويشرح البدء السريع مع وكيل برمجة ما تفعله المهارة بالدراسة.
أوامر التثبيت حسب الوكيل
| الوكيل | التثبيت | المجلد الذي يقرؤه الوكيل | صفحة الإعداد |
|---|---|---|---|
| Claude Code | /plugin marketplace add davidjurgens/potato-skill، ثم /plugin install potato-skill@potato | ذاكرة الإضافات المؤقتة في Claude Code | Claude Code |
| Codex | npx skills add davidjurgens/potato-skill --agent codex | .agents/skills/ | Codex |
| Cursor | npx skills add davidjurgens/potato-skill --agent cursor | .agents/skills/ | Cursor |
| GitHub Copilot في VS Code | npx skills add davidjurgens/potato-skill --agent github-copilot | .agents/skills/ | أدناه |
| Gemini CLI | npx skills add davidjurgens/potato-skill --agent gemini-cli | .agents/skills/ | أدناه |
| OpenCode | npx skills add davidjurgens/potato-skill --agent opencode | .agents/skills/ | أدناه |
كُتبت potato-skill من أجل Claude Code، ويذكر ملف SKILL.md فيها مجلدات التثبيت لـ Codex وCursor أيضاً. ويحمّل GitHub Copilot وGemini CLI وOpenCode الملفات نفسها. افتح في متصفحك أول مهمة يبنيها الوكيل، وصنّف بضعة عناصر بنفسك قبل أن تدعو المعلّقين.
قبل التثبيت
ثبّت Potato في بيئة Python التي يستخدمها شل الوكيل. تستورد السكربتات المساعدة في المهارة سجلات Potato وتستدعي الأمر potato، وتتحقق الخطوة الأولى في المهارة من أن Potato يُستورد. وتتيح إضافة المتصفح وChromium للأمر potato preview --screenshot ولسكربت الجولة الاختبارية في المهارة فتح المهمة في متصفح بلا واجهة:
pip install 'potato-annotation[preview]'
playwright install chromiumتعمل أداة skills الطرفية عبر npx. ويتطلب الإصدار 1.7.6 من الأداة Node.js 22.20 أو أحدث.
ما تكتبه أداة skills
ينسخ npx skills add الملف SKILL.md وملفات المرجع الثلاثين والسكربتات المساعدة التسعة إلى .agents/skills/potato-skill/، ويسجّل المصدر في skills-lock.json في جذر المشروع. أضف -g للتثبيت في ~/.agents/skills/potato-skill/ لكل مشروع على الجهاز. ويقرأ .agents/skills/ كل من Codex وCursor وGitHub Copilot في VS Code وGemini CLI وOpenCode. ويمكن لأمر واحد أن يذكر عدة وكلاء من هؤلاء، فيتشاركون عندئذ نسخة واحدة:
npx skills add davidjurgens/potato-skill --agent codex cursor github-copilot gemini-cli opencodeيعطي جدول الوكلاء في الأداة اسم --agent والمجلد للوكلاء الآخرين الذين تدعمهم الأداة. ويحمّل كل وكيل في هذه الصفحة المهارة أيضاً دون أمر حين يطابق الطلب وصف المهارة، مثل طلب بناء مهمة تعليق توضيحي.
GitHub Copilot في VS Code
يقرأ VS Code المجلدين .agents/skills/ و.claude/skills/ في الجلسات المحلية، إلى جانب مجلد Copilot الخاص .github/skills/. وتعمل المهارات في المحادثة وفي وضع الوكيل. وكتابة /potato-skill في المحادثة تبدأ المهارة.
Gemini CLI
يقرأ Gemini CLI المجلد .agents/skills/ في مساحة العمل والمجلد ~/.agents/skills/ للمستخدم. ويعرض /skills list المهارات التي وجدها Gemini. ويبدأ Gemini المهارة المطابقة دون أمر، ويطلب منك التأكيد قبل تحميل المهارة في المحادثة.
OpenCode
يقرأ OpenCode المجلد .agents/skills/ في كل مجلد من المجلد الحالي حتى شجرة عمل git، ويقرأ ~/.agents/skills/ للتثبيت العام. ويحمّل الوكيل المهارة المطابقة عبر أداة skill في OpenCode.
دون أداة skills
في جذر مستودع potato-skill ملف AGENTS.md، وهو ملخص قصير لقواعد المهارة يقرؤه Codex وCursor باسم الملف. ونسخ هذا الملف إلى جذر مشروعك يعطي الوكيل القواعد دون خطوة تثبيت. ويشير الملف إلى ملفات مرجع وسكربتات لا تصل إلى القرص إلا بالتثبيت الكامل. وتقارن صفحة البدء السريع مع وكيل برمجة بين التثبيت الكامل ونسخة AGENTS.md. وملفات المرجع منشورة أيضاً على davidjurgens.github.io/potato-skill. ويستطيع الوكيل الذي يقرأ صفحات الويب استخدام النسخة المنشورة، ويمكنك قراءة الملفات هناك قبل التثبيت.
تحديث المهارة وإزالتها
تحدّث أداة skills المهارة وتزيلها بالاسم. أضف -g إلى أي من الأمرين للتثبيت العام:
npx skills update potato-skill
npx skills remove potato-skillيقارن update النسخة المثبّتة بمستودع GitHub ويستبدلها حين يتغير المستودع. ويحذف remove المجلد .agents/skills/potato-skill/ وإدخال المهارة في skills-lock.json. وتعطي صفحة Claude Code أوامر تحديث الإضافة وإزالتها.