التوثيق

إنشاء مهارة

المهارة مجرد ملف Markdown بخاصية YAML الأمامية. إذا كنت تمتلك معرفة متخصصة تستحق المشاركة، فاكتبها في ملف SKILL.md.

هيكل الملف

SKILL.md
---
name: my-skill
description: One sentence shown in lazy-load preview.
version: 1.0.0
author: your-github-username
tags:
  - laravel
  - php
  - testing
---

# My Skill

## Overview

What this skill teaches Claude and when to apply it.

## Conventions

- Always use X instead of Y
- Prefer Z pattern for ABC scenarios

## Examples

```php
// Your code examples here
```

حقول الخاصية الأمامية

الحقل مطلوب الوصف
name مطلوب معرف متوافق مع عناوين URL.
description مطلوب جملة واحدة — تظهر في معاينة التحميل الكسول وقائمة الكتالوج.
version اختياري إصدار دلالي، مثال: 1.0.0.
author اختياري اسم مستخدم GitHub الخاص بك.
tags اختياري مصفوفة من الوسوم للبحث والتصفية.

إرشادات المحتوى

  • كن محددًا. "استخدم دائمًا $query->whereNull('deleted_at')" أفضل من "استخدم الحذف الناعم".
  • أدرج أمثلة. كتل الكود تجعل التعليمات لا لبس فيها.
  • وضّح السياق. ما نوع المشروع أو الإطار أو الموقف الذي تنطبق عليه هذه المهارة؟
  • حافظ على التركيز. مهارة واحدة = مجال واحد. لا تجمع Laravel + الأمان + الاختبار في ملف واحد.

التقديم في الكتالوج

  1. 1 ادفع مهارتك إلى مستودع GitHub عام.
  2. 2 اذهب إلى صفحة التقديم وأدخل عنوان URL للمستودع.
  3. 3 تقوم واجهة برمجة تطبيقات Claude بتحليل مهارتك للأمان والجودة.
  4. 4 عند الموافقة، تظهر في الكتالوج خلال دقائق.

تحليل الأمان

يتم تحليل كل مهارة مقدَّمة بواسطة Claude للكشف عن حقن الأوامر، والوصول غير المصرح به للملفات، وأنماط تسريب البيانات. المهارات المصنّفة خطرة تخضع لمراجعة المشرف. إبقاء مهارتك مركّزة على المعرفة — دون تنفيذ كود أو طلبات خارجية — يضمن الموافقة بسلاسة.