تخطَّ إلى المحتوى
+ أضف منتج إنشاء حساب تسجيل الدخول

صانع أوصاف أدوات MCP

MCP وبروتوكولات الأدوات agent-skills filesystem mcp MIT
⬇ تنزيل vsha-3456f64e09eb

SHA-256: 3456f64e09ebb81353925952ea0d2809f214a89475fdc158022835f915b2b133 2 كيلوبايت

✦ جاهزة لبيئة عملك

ثبّت هذه المهارة مباشرة داخل وكيلك

اختر الوكيل، انسخ الأمر، وشغّله من مجلد مشروعك. يتولى CLI تنزيل الحزمة والتحقق من بصمة SHA-256 ووضع الملفات في المسار المناسب.

$npx @ai-dalil/skills add mcp-tool-description-craftsman --agent codex

@ai-dalil/skills على npm - Node.js 18.18 أو أحدث.

↓ تنزيل ZIP · الإصدار sha-3456f64e09eb بيانات API ↗ سجل الإصدارات ↗

الوصف

عربي

يكتب أوصاف أدوات MCP كوثائق مرجعية مختصرة: الغرض، متى تُستخدم، متى لا، ومثال نداء صحيح واحد.

English

Write MCP tool descriptions as compact reference docs: purpose, when to use, when not, and one correct call example.

بيانات المهارة التقنية

SKILL name
mcp-tool-description-craftsman
الوصف الأصلي
Write MCP tool descriptions as compact reference docs: purpose, when to use, when not, and one correct call example.
إصدار المهارة
1.1.0
التوافق
Node.js 18+ أو Python 3.10+ · عميل MCP متوافق
الأدوات المسموح بها
Read, Write
الكلمات المفتاحية
mcp, descriptions, tools, documentation
لغة المصدر
multilingual
الفرع / المرجع
main
دليل الترخيص
Original editorial content authored for the AiDalil catalog and released under MIT by the catalog owner. (high)

بيانات المصدر الأصلية (YAML)

عرض Frontmatter الأصلي
name: mcp-tool-description-craftsman
description: Write MCP tool descriptions as compact reference docs: purpose, when to use, when not, and one correct call example.
version: 1.1.0
metadata:
  author: AiDalil Editorial
  category: mcp-protocols
  compatibility: amp, crush, windsurf, claude-desktop, trae, api
  difficulty: beginner
  tags: [mcp, descriptions, tools, documentation]

تعليمات SKILL.md

المحتوى الأصلي للمهارة كما ورد من المصدر، مع الحفاظ على تنسيق Markdown.

عرض التعليمات الكاملة
# Mcp Tool Description Craftsman

**Goal:** Write MCP tool descriptions as compact reference docs: purpose, when to use, when not, and one correct call example.

> الهدف: يكتب أوصاف أدوات MCP كوثائق مرجعية مختصرة: الغرض، متى تُستخدم، متى لا، ومثال نداء صحيح واحد.

## When to use
- الحالة النموذجية: يكتب أوصاف أدوات MCP كوثائق مرجعية مختصرة: الغرض، متى تُستخدم، متى لا، ومثال نداء صحيح واحد.
- ربط عميل MCP بخادم وتشخيص المشكلات.
- بناء خادم أدوات ببروتوكول MCP من الصفر.
- اختيار طبقة النقل المناسبة للحالة.
- تصميم مخططات أدوات وموارد وقوالب أوامر.

## Workflow
1. اختبر بعميل حقيقي: اكتشاف الأدوات، النداء، الفشل، والاسترداد.
2. خطط للإصدارات: تغييرات متوافقة أولاً وإعلان مسبق للكاسرة.
3. وثّق الإعداد والتشغيل واستكشاف الأخطاء الشائعة.
4. اختر طبقة النقل: قياسي محلي أو خادم بعيد بحسب الأمان والاستخدام.
5. أضف الحدود: مهلة، حد حجم، وقائمة مسارات وموارد مسموحة.
6. صمّم الأدوات: اسم واضح، وصف دقيق، مخطط مدخلات صارم، ومخرجات متوقعة.
7. نفّذ أصغر خادم يعمل مع تسجيل أخطاء واضح.
8. حدّد نطاق الخادم: صانع أوصاف أدوات MCP. اذكر الأدوات المطلوبة ومستخدميها وصلاحياتهم.

## Rules
- التوافق الخلفي يُختبر بعميل قديم قبل النشر.
- الأسرار من البيئة الآمنة ولا تُعاد في المخرجات.
- المخططات صارمة: ارفض المدخلات غير المطابقة برسالة مفيدة.
- وصف الأداة هو عقد الاستخدام؛ اكتبه كوثيقة مرجعية.
- رسائل الخطأ تساعد الوكيل على التصحيح لا على التخمين.

## Output contract
- دليل إعداد وتشغيل واستكشاف أخطاء.
- قائمة حدود أمان مع مبرر كل حد.
- خادم أدوات بوصف ومخططات كاملة.
- سياسة إصدارات وتغييرات مستقبلية.

## Quality checks
- [ ] هل الحدود الزمنية وحجمية مفعّلة على كل أداة؟
- [ ] هل المخططات ترفض المدخلات السيئة برسائل قابلة للتصحيح؟
- [ ] هل اختُبر سلوك الاكتشاف والنداء والفشل فعلياً؟
- [ ] هل لا تسرب أسرار في السجلات أو المخرجات؟
- [ ] هل دليل التشغيل يغطي الخطوات الأولى حتى لغير المتخصص؟

## Skill identity
- Skill name: `mcp-tool-description-craftsman`
- Version: 1.1.0
- Domain: MCP and Tool Protocols (MCP وبروتوكولات الأدوات)
- Tags: mcp, descriptions, tools, documentation

التثبيت اليدوي

استخدم هذا المسار عند عدم استخدام CLI أو عند إدارة ملفات المهارات يدويًا.

  1. نزّل ملف ZIP للإصدار المطلوب من أعلى الصفحة، أو افتح المصدر الأصلي إذا لم تتوفر حزمة مستضافة.
  2. فك الضغط، ثم انقل مجلد المهارة الذي يحتوي مباشرة على SKILL.md إلى مجلد الوكيل.
  3. أعد تحميل الوكيل أو افتح جلسة جديدة، ثم تأكد من ظهور المهارة ضمن المهارات المتاحة.
Codex.agents/skills/mcp-tool-description-craftsman/
Claude Code.claude/skills/mcp-tool-description-craftsman/
Cursor.cursor/skills/mcp-tool-description-craftsman/

تعليمات خاصة بهذه المهارة

Extract the skill folder into your agent's skills directory (for example the project skills folder) or install the ZIP package from the skill page. No build step is required; everything is Markdown.

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

• بناء خادم أدوات ببروتوكول MCP من الصفر. • اختيار طبقة النقل المناسبة للحالة. • تحديث خادم قائم دون كسر العملاء.

المتطلبات

• Any Agent Skills compatible assistant (Claude Code, Claude Desktop, or API agents). • Basic file access to read the bundled reference playbook. • No external services required for the standard workflow.

الإصدارات

الإصدار الحجم الملفات تاريخ النشر تنزيل
vsha-3456f64e09eb 2 كيلوبايت 2 4 نوفمبر، 2026 تحميل

الأمان والفحص

فحص أساسي ✓ — 1 نوفمبر، 2026

مجتمع يبني قدرات أفضل

هل طوّرت مهارة تستحق أن يكتشفها الآخرون؟

ساهم في إثراء مكتبة المهارات، وعرّف المجتمع على عملك مع حفظ نسبه إلى مصدره الأصلي.

أرسل مهارة كيف تعمل المهارات؟
قسم المهارات — دليل AIالعودة إلى دليل AI ↗