إذا طلبت من Claude ملاحظة لخزنة Obsidian فقد يكتب Markdown عامًا بروابط عادية بدل الروابط الداخلية، وقد يخطئ في صيغة ملفات .base و.canvas. تشرح هذه المهارات الثلاث لـ Claude Code كل صيغة بجداولها وقواعدها وأمثلة كاملة، ليكتب الملف بالشكل الذي يفتحه Obsidian. وتعمل داخل Claude Code على مجلد الخزنة نفسه.
لكل صيغة ملف مهارة
- obsidian-markdown: تغطي صيغة Obsidian Flavored Markdown، من الروابط الداخلية [[ملاحظة#عنوان]] وروابط الفقرات عبر ^block-id، والتضمين ![[…]] للملاحظات والصور والصوت وصفحة محددة من ملف PDF، و13 نوعًا من الـ callouts مع إمكان طيّها، والخصائص في frontmatter بأنواعها من نص ورقم ومربع اختيار وتاريخ وقائمة ورابط، إلى الوسوم المتداخلة مثل #project/work.
- obsidian-bases: لملفات .base المكتوبة بـ YAML، وهي عروض أشبه بقاعدة بيانات فوق ملاحظاتك، بفلاتر and وor وnot، ومعادلات بدوال مثل if() وtoday() وfile.hasTag()، وأربعة أنواع عرض (table وcards وlist وmap)، و14 ملخصًا جاهزًا منها Sum وMedian وEarliest. وفي الملف أربعة أمثلة كاملة: متابعة مهام، وقائمة قراءة، وملاحظات المشروعات، وفهرس للملاحظات اليومية.
- json-canvas: لملفات .canvas وفق مواصفة JSON Canvas 1.0، بعقد من أربعة أنواع (نص وملف ورابط ومجموعة)، وأسهم تحدد جهة خروجها وجهة دخولها، وألوان جاهزة من 1 إلى 6 أو بصيغة hex، وثماني قواعد تحقق، منها ألا يتكرر معرّف وأن يشير كل سهم إلى عقدة موجودة.
يستدعي Claude المهارة المناسبة حين يطابق طلبك وصفها: ذكر callouts أو frontmatter للأولى، وملف .base أو formulas للثانية، وملف .canvas أو flowchart للثالثة.
مثال من ملف obsidian-bases: عرض للمهام
تكتب مثلًا: «أنشئ ملف tasks.base يعرض الملاحظات الموسومة task مع الأيام المتبقية على موعد التسليم». والمثال الكامل في ملف المهارة يبيّن شكل الناتج المنتظر: فلتر يلتقط الملاحظات ذات الوسم task، ومعادلة days_until_due تحسب الأيام حتى الخاصية due، ومعادلة is_overdue تميّز المتأخر، وعرضان: Active Tasks مجمّع حسب الحالة، وCompleted للمنجز. بعدها تضمّن العرض في أي ملاحظة بالسطر ![[tasks.base]].
التثبيت في Claude Code
- بعد فك الضغط تأكد من ظهور المجلد المخفي plugin/.claude-plugin، ففيه ملف plugin.json الذي يعرّف الإضافة باسم obsidian-skills.
- من داخل مجلد الخزنة شغّل
claude --plugin-dir "PATH/TO/EXTRACTED/plugin"واستبدل المسار بمكان المجلد عندك. تبقى المهارات محمّلة ما دامت هذه الجلسة مفتوحة. - لتبقى المهارات متاحة في كل جلسة، انسخ المجلدات الثلاثة من plugin/skills إلى ~/.claude/skills.
ما يلزمك وحدود الحزمة
- يلزمك Claude Code مثبتًا، واشتراك أو رصيد يغطي استخدام النموذج. تطبيق Obsidian غير مرفق وتحتاجه لمعاينة الملفات، وعرض map يحتاج بحسب ملف المهارة خصائص لخطوط الطول والعرض وإضافة Maps.
- المهارات تعرف الصيغة لا محتوى خزنتك: الفلتر status == “done” لا يعمل إلا إن كانت ملاحظاتك تستخدم الخاصية status، فراجع أسماء الملاحظات والخصائص في الناتج.
- لا سكربتات في الحزمة، فقواعد التحقق في json-canvas يطبقها النموذج بنفسه دون مدقق آلي. افتح اللوحة في Obsidian قبل الاعتماد عليها.
- لم أجهّز نسخة للرفع إلى claude.ai: وصف كل مهارة أطول من 200 حرف، وهو الحد الذي يقبله رافع المهارات هناك، فيلزم اختصاره أولًا.
- التعليمات والأمثلة بالإنجليزية، فاطلب العناوين والتسميات بالعربية صراحة إن أردتها.
أرفقتُ دليلًا عربيًا لتشغيل الإضافة، وفهرسًا بمسارات ملفات SKILL.md الثلاثة.
الترخيص: MIT، والمهارات من تأليف Steph Ango في مستودع kepano/obsidian-skills، ووصلت نسختها 1.0.0 عبر فهرس BuildWithClaude دون تعديل.
