/ الدليل / الملعب / skill-doctor
← كل الخوادم ↗ GitHub
● مجتمع marian2js ⚡ فوري

skill-doctor

بواسطة marian2js · marian2js/skill-doctor

اختبر مهارات Claude الخاصة بك قبل الشحن - المادة الأمامية، ومراجع الموارد، ووضوح الزناد، وتقييم النظافة، وسجل 0-100 مع درجة الخطورة.

Skill-doctor عبارة عن واجهة سطر أوامر (CLI) تقوم بمسح حزمة المهارات المحلية وتضع علامة على المشكلات التي تؤثر على التنشيط أو الموثوقية أو الجودة. فهو يتحقق من المادة الأمامية والبيانات التعريفية لـ YAML، ويتحقق من عدم انقطاع مراجع الموارد، ويقيم أوصاف المشغلات من أجل الوضوح، ويتحقق من صحة evals/evals.json. النتيجة هي درجة 0-100 مع نتائج مصنفة حسب الخطورة؛ يدعم أوضاع النص وJSON والنتيجة فقط - مثالية للالتزام المسبق أو التوجيه المسبق أو بوابة CI.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

skill-doctor-skill.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "skill-doctor-skill",
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "skill-doctor-skill": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "skill-doctor@latest",
          "."
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add skill-doctor-skill -- npx -y skill-doctor@latest .

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: skill-doctor

اختبر مهارتك قبل النشر في السوق

👤 مؤلفو المهارات على وشك مشاركة SKILL.md ⏱ ~15 min beginner

متى تستخدمه: لقد انتهيت من إحدى المهارات وتريد الحصول على تصريح سلامة عقلية قبل أن يقوم أي شخص آخر بتثبيتها.

المتطلبات الأساسية
  • العقدة 18+ — تثبيت nvm 18
الخطوات
  1. تشغيل الطبيب
    قم بتشغيل طبيب المهارة في جذر المهارة.✓ تم النسخ
    → النتيجة + قائمة النتائج حسب الخطورة
  2. إصلاح العناصر عالية الخطورة
    قم بإصلاح المشكلات عالية الخطورة أولاً؛ إعادة التشغيل حتى النتيجة ≥ 85.✓ تم النسخ
    → يتسلق النتيجة. يختفي النقاد

النتيجة: مهارة يتم تفعيلها عندما تتوقعها ولا تحتوي على مراجع مقطوعة.

المزالق
  • مطاردة الكمال 100 — العناصر منخفضة الخطورة (نمط القمل) غالبًا ما تكون جيدة؛ التركيز على المحفزات والموارد
اجمعها مع: oaustegard-claude-skills

احصل على مستودع المهارات بحد أدنى من نقاط الجودة في CI

👤 تحافظ الفرق على مهارات متعددة في ريبو واحد ⏱ ~30 min intermediate

متى تستخدمه: أنت تقوم بشحن المهارات في كثير من الأحيان وتريد منع الانجراف.

المتطلبات الأساسية
  • إجراءات GitHub (أو ما يعادلها) — الريبو مع .github/workflows/
الخطوات
  1. أضف سير العمل
    أضف وظيفة GH Actions التي تدير برنامج Skill-doctor وتفشل إذا كانت النتيجة أقل من 80.✓ تم النسخ
    → تمت إضافة ملف سير العمل؛ يعمل على العلاقات العامة
  2. تعيين الصرامة لكل مسار
    مهارات الإنتاج تفشل <90؛ تسمح المسودات <70.✓ تم النسخ
    → المصفوفة أو الحدود الشرطية في سير العمل

النتيجة: يتم القبض على العلاقات العامة التي تقلل من جودة المهارات قبل الدمج.

المزالق
  • قفل الشريط عاليًا جدًا في وقت مبكر جدًا — ابدأ بالتسامح، ثم شدد على مدى 2-3 أشهر حتى يتم إصلاح النتائج
اجمعها مع: agent-skills-cli-skill

تشخيص سبب عدم تفعيل المهارة

👤 مهارة المستخدمين الذين يعانون من مشاكل التنشيط ⏱ ~15 min beginner

متى تستخدمه: لقد قمت بتثبيت مهارة ولكن كلود لم يطلقها أبدًا.

الخطوات
  1. قم بتشغيل الطبيب في دليل المهارات
    قم بتشغيل Skill-doctor على ~/.claude/skills/<skill>.✓ تم النسخ
    → تستدعي النتائج مشكلات الزناد الضعيفة أو المسائل الأمامية
  2. تحرير الوصف
    أعد كتابة الوصف بحيث تظهر فيه الكلمات الأساسية المحددة لمهمة المستخدم.✓ تم النسخ
    → تنخفض شدة وضوح الزناد

النتيجة: تفعيل أكثر وضوحا؛ يختار كلود المهارة المناسبة للمهام.

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

skill-doctor-skill + oaustegard-claude-skills

لينت قبل النشر في السوق

قم بتشغيل Skill-doctor محليًا؛ ثم افتح العلاقات العامة لمهارات oaustegard/clude.✓ تم النسخ
skill-doctor-skill + agent-skills-cli-skill

سلسلة مهارات الطبيب مع أدوات تأليف المهارات الأخرى

استخدم Agent-skills-cli للسقالة؛ مهارة الطبيب للتحقق من صحة قبل الالتزام.✓ تم النسخ
skill-doctor-skill + claude-skill

اتبع دليل التأليف، ثم الوبر

اكتب وفقًا لدليل كلود للمهارات؛ تحقق مع طبيب المهارة.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
skill-doctor <path> skill directory path قبل النشر، في CI، أو لتشخيص مشكلات التنشيط 0

التكلفة والحدود

تكلفة التشغيل

حصة API
لا شيء - تحليل ثابت محلي
الرموز لكل استدعاء
لا شيء (CLI، وليس واجهة برمجة التطبيقات)
التكلفة المالية
حر
نصيحة
تشغيل فقط على الدلائل التي تغيرت؛ في CI، استخدم مرشحات المسار لتجنب مسح الريبو بالكامل في كل PR.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: لا أوراق اعتماد
نقل البيانات الخارجي: لا شيء - التحليل المحلي فقط

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

يقول الطبيب أن SKILL.md غير موجود

قم بالتشغيل من جذر المهارة (الدليل الذي يحتوي على SKILL.md)، وليس من جذر الريبو.

تحقق: ls SKILL.md in CWD
فشل مخطط "evals/evals.json".

تأكد من أن كل تقييم يحتوي على الحقول المطلوبة؛ كعب قليل خير من مكسور.

تحقق: jq . evals/evals.json
لا تتحسن النتيجة بعد التعديلات

إعادة التشغيل؛ إذا استمرت النتيجة، فاقرأ مدى الخطورة والتفاصيل - في بعض الأحيان تؤدي الإصلاحات إلى ظهور مشكلات جديدة منخفضة الخطورة.

تحقق: Diff the JSON reports between runs

البدائل

skill-doctor مقابل البدائل

البديلمتى تستخدمهاالمقايضة
agent-skills-cli-skillتريد أدوات CLI عامة لمهارات السقالات/الإدارةمجموعة ميزات مختلفة؛ ليس لينتر
claude-skillتريد أن يفهم دليل التأليف كيف تبدو كلمة "جيد".المستندات، وليس linter

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills