التوثيق
الصيغة، والبوّابات، والأسطح.
صيغة المهارة
المهارة مجلّد يحوي ملفّ SKILL.md — وهو ملفّ Markdown بترويسة YAML تحمل حقلَي name وdescription. الوصف هو ما يقرأه الوكيل ليقرّر تحميل المهارة من عدمه، فلا بدّ أن يذكر ما تفعله المهارة ومتى تُستخدم معًا. أمّا الملفّات المساندة فتوضع بجانبه ويُشار إليها من المتن، فلا يقرؤها الوكيل إلّا عند الحاجة.
بوّابات الجودة
البوّابة صفر تتحقّق من الترويسة والمخطّط. والبوّابة الأولى تفحص البنية فحصًا ساكنًا — الإفصاح التدريجيّ، وحدود الحجم، ومنع المسارات المطلقة، ومنع تسرّب الأسرار. وكلتاهما تعملان داخل الطلب في أقلّ من خُمس ثانية. أمّا البوّابة الثانية فتُجري تقييم تفعيل غير متزامن: نموذج حَكَم يفحص هل تُستدعى المهارة على المطالبات التي ينبغي أن تُستدعى عليها، وهل تصمت على ما لا ينبغي. والبوّابة الثالثة تنفّذ السكربتات المرفقة في بيئة معزولة.
تثبيت المهارة
كل صفحة مهارة تعرض أمر تثبيت من سطر واحد، يكتب مجلّد المهارة داخل مشروعك ليلتقطه وكيلك البرمجيّ في التشغيل التالي. لا يُثبَّت شيء على مستوى النظام، ولا يُنفَّذ شيء أثناء التثبيت.
الأسطح القابلة لقراءة الوكلاء
السجلّ ينشر نفسه بالصيغ التي تبحث عنها الوكلاء: /llms.txt كفهرس Markdown، و/index.json كفهرس مُصنَّف، وعرض Markdown نظيف لكل مهارة. وترويسة Content-Signal تُعلن كيفيّة استخدام المحتوى. وهي المنظومة نفسها التي تدور حولها المهارات.
Example SKILL.md
---
name: core-web-vitals-audit
description: Audits a web application for Core Web Vitals
regressions. Use when the user asks to check LCP, INP or
CLS, or investigate a Lighthouse score drop.
---
# Core Web Vitals audit
## When to use this
...
## Procedure
1. Measure first, guess never.
2. See [references/thresholds.md](references/thresholds.md).