Steph Ango's Official Obsidian Skills: How They Work + How I Use Them

TL;DR

Steph Ango is the CEO of Obsidian. In late 2025 he published an official set of Claude Skills built specifically for Obsidian users: small, composable workflows that give Claude vault-aware capabilities: capture a thought into the right note, retrieve context from across the vault, summarize across notes, link related ideas. They aren't magic and they aren't a replacement for a curated second brain. They're the missing tooling layer that sits between "I have a vault" and "the AI uses my vault effectively." This post covers what's in the official set, when each skill is actually useful, and the two-file pairing that makes them work for me daily.

Who Is Steph Ango (And Why That Matters)

Steph Ango is the CEO of Obsidian. He's been Obsidian's product voice for years and writes regularly about local-first software, file over app, and the long-term values that make Obsidian what it is. Anything he ships for Obsidian carries weight because he sets the direction of the product itself.

When he released a set of Claude Skills for Obsidian users in late 2025, two things were notable:

  • It's an official-feeling endorsement of Claude as the AI companion for Obsidian. Not Microsoft Copilot, not ChatGPT, not Gemini, but Claude. There are technical reasons (Claude Code reads files natively, Anthropic's privacy stance aligns with Obsidian's local-first philosophy), but the choice also signals direction.
  • It's a working example of how skills should be structured. The skills are short, focused, and composable: each one does a single thing well, and they layer on top of any second-brain setup you've already built.

    • If you've been Obsidian-curious and waiting for a clear signal on how Obsidian and AI should fit together, this is it.

    What's in the Official Skill Set

    The skill set is intentionally small. Each skill is a few hundred lines of carefully-written instructions plus optional supporting scripts. The headline skills (subject to updates: check the GitHub repo for current state):

  • Capture. Add a thought to the right note in your vault. The skill reasons about where the thought belongs (active project? decision? new note?) rather than dumping into an inbox.
  • Retrieve. Pull relevant context from across your vault for the current question. Smart enough to skip stale notes and prioritize files marked as canonical.
  • Summarize. Condense across multiple notes into a coherent paragraph. Useful for end-of-week reviews or "what did I decide about X" queries.
  • Link. Suggest connections between the current note and existing notes: a backlink-aware version of what Obsidian's graph view does, but written for an AI to act on.
  • Daily. A skill that runs at the start of a day's session, loads identity + active projects, and sets the AI up to be useful immediately.

    • The list will evolve. The pattern won't: each skill is small, focused, and reads from the same vault you already write to.

    Why Skills Beat Custom Instructions

    Before skills existed, the way to give Claude vault-awareness was to paste long instructions into every prompt or into a Custom GPT-style system prompt. That approach has three problems:

  • It bloats the context. Every session pays the token cost.
  • It's hard to update. A single big instruction is fragile; editing one bullet risks breaking the rest.
  • It can't compose. You can't "use capture without retrieve" if everything is one giant prompt.

    • Skills solve all three. Each skill is loaded only when invoked, edits are local, and they compose naturally, capture then link then summarize is a workflow, not a monolith.

    The Two-File Pairing That Makes Them Useful

    Skills are tools. Tools without context produce generic outputs. The pairing that makes the official set actually work for me:

    File 1, Your three core second-brain files (identity / projects / decisions). Without these, the skills don't know what to capture as, what to retrieve for, or what to link to. See the 3-file template post for the structure.

    File 2, A skills index file (.obsidian/ai-skills.md or similar). A short file that lists which official skills are installed and when each should be invoked. Example: "Use daily at the start of a session. Use capture when I share a one-off thought. Use summarize only when I explicitly ask." This index acts as a meta-prompt that helps Claude pick the right skill without you having to name it every time.

    With these two pieces in place, the skills start behaving as advertised. Without them, they're just well-written prompts looking for context that doesn't exist.

    How I Actually Use Them Day to Day

    A realistic day:

  • Morning. Open Claude Code in the project I'm working on. The root CLAUDE.md loads, plus any folder-specific CLAUDE.md. The daily skill ran when I opened Claude.ai for chat-mode work; Claude already knows what's active.
  • During work. I drop one-liner thoughts into Claude ("client X mentioned they're worried about Y"). The capture skill decides whether that belongs in projects.md under that client, in decisions.md, or as a new note. I almost never have to say where to put it.
  • End of week. I run summarize against the week's captures + the project file. The output is a Friday-review draft I edit, not write from scratch.
  • When stuck. I invoke retrieve with the current problem. The skill pulls the 3 - 5 most relevant notes (sometimes including past decisions I'd forgotten I made) and feeds them as context.
  • When linking. When writing a new long-form note, I run link to suggest existing notes I should reference. About 30% of suggestions are useful, 70% are noise, useful enough to keep using.

    • None of this is exotic. It's the same workflow I had before the official skills, but with less friction.

    What the Skills Don't Do

    Setting expectations honestly:

  • They don't fix a stale vault. If your active-projects file is from three months ago, the skills will confidently surface stale context.
  • They don't replace the three-file template. They sit on top of it. Without an identity/projects/decisions base, the skills don't have enough signal to be useful.
  • They don't work outside Claude. They're Claude Skills specifically. The capabilities they encode (capture, retrieve, summarize) are universal, but the official implementation targets Claude.
  • They don't preserve your taste. They follow the instructions in your context files; if your taste isn't documented there, the skills won't infer it.

    • Installation (High Level)

    Specifics will drift as the official repo updates. The pattern:

  • Clone or download the official skills repo (linked from Steph Ango's posts / the Obsidian community).
  • Add the skills to your Claude.ai workspace via the Skills UI, or reference them from Claude Code via your settings.
  • Add the skills index file to your vault.
  • Test with a small task. If capture doesn't pick the right destination, edit your context files (not the skill) until it does.

    • The setup is one-time, maybe 30 minutes, and then it's invisible.

    Where to Go Next

  • If you don't have a second brain yet, start with the 3-file template.
  • If you have a vault but it's noisy for AI, read the pillar second-brain post for the curation principles.
  • If you're using ChatGPT and wondering whether to switch, the Claude + Obsidian comparison covers the trade-offs.

    • The official skills are the easiest way to test whether AI-augmented Obsidian fits your workflow. Spend a week with them on top of a real second brain and you'll know.

    skills Obsidian الرسميّة لـ Steph Ango: كيف تعمل وكيف أستخدمها

    الخلاصة

    Steph Ango هو الرئيس التنفيذيّ لـ Obsidian. في أواخر 2025 نشر مجموعة Claude Skills رسميّة مصمَّمة لمستخدمي Obsidian: سير عمل صغير قابل للتركيب يمنح Claude قدرات تعي الخزنة: التقاط فكرة في الملاحظة الصحيحة، استرجاع السياق عبر الخزنة، تلخيص عبر الملاحظات، ربط الأفكار. ليست سحراً ولا بديلاً عن دماغ ثانٍ منقّى. هي طبقة الأدوات المفقودة بين "لديّ خزنة" و"الذكاء الاصطناعيّ يستخدم خزنتي بفعّاليّة". هذا المقال يغطّي ما في المجموعة الرسميّة، متى يكون كلّ skill نافعاً فعلاً، والملفّان المقترنان اللذان يجعلانها تعمل لي يوميّاً.

    من هو Steph Ango (ولماذا يهمّ)

    Steph Ango الرئيس التنفيذيّ لـ Obsidian. كان صوت المنتج لسنوات ويكتب بانتظام عن البرمجيّات المحلّيّة-أوّلاً، "الملفّ فوق التطبيق"، والقيم بعيدة المدى التي تجعل Obsidian ما هو عليه. أيّ شيء يطلقه لـ Obsidian يحمل ثقلاً لأنّه يحدّد اتّجاه المنتج نفسه.

    عندما أصدر مجموعة Claude Skills لمستخدمي Obsidian أواخر 2025، أمران لافتان:

  • تأييد رسميّ بالشعور لـ Claude كرفيق ذكاء اصطناعيّ لـ Obsidian. لا Microsoft Copilot، لا ChatGPT، لا Gemini، بل Claude. هناك أسباب تقنيّة (Claude Code يقرأ الملفّات أصلاً، موقف Anthropic من الخصوصيّة يتماشى مع فلسفة Obsidian المحلّيّة-أوّلاً)، لكنّ الاختيار يشير إلى اتّجاه.
  • مثال عمليّ على كيف يجب أن تُبنى skills. الـ skills قصيرة، مركّزة، قابلة للتركيب: كلّ واحد يفعل شيئاً واحداً جيّداً، ويتراكم فوق أيّ إعداد دماغ ثانٍ بنيته أصلاً.

    • لو كنت مهتمّاً بـ Obsidian وتنتظر إشارة واضحة حول كيف ينبغي أن يلتقي Obsidian والذكاء الاصطناعيّ، هذه هي.

    ما في المجموعة الرسميّة

    المجموعة صغيرة عمداً. كلّ skill بضع مئات الأسطر من التعليمات المكتوبة بعناية مع سكربتات داعمة اختياريّة. الـ skills الرئيسيّة (قابلة للتحديث، راجع مستودع GitHub للحالة الحاليّة):

  • Capture (التقاط). أضف فكرةً إلى الملاحظة الصحيحة في خزنتك. الـ skill يفكّر أين تنتمي الفكرة (مشروع نشط؟ قرار؟ ملاحظة جديدة؟) بدل إغراق صندوق وارد.
  • Retrieve (استرجاع). اسحب السياق ذا الصلة عبر خزنتك للسؤال الحاليّ. ذكيّ بما يكفي لتخطّي الملاحظات البائتة وإعطاء أولويّة للملفّات المرجعيّة.
  • Summarize (تلخيص). كثّف عبر عدّة ملاحظات في فقرة متماسكة. نافع لمراجعات نهاية الأسبوع أو استعلامات "ماذا قرّرت بشأن X".
  • Link (ربط). اقترح روابط بين الملاحظة الحاليّة والملاحظات الموجودة: نسخة واعية بالروابط الخلفيّة ممّا يفعله عرض graph في Obsidian، لكن مكتوبة ليتصرّف عليها الذكاء الاصطناعيّ.
  • Daily (يوميّ). skill يُشغَّل ببدء جلسة اليوم، يحمّل الهويّة + المشاريع النشطة، ويهيّئ الذكاء الاصطناعيّ ليكون نافعاً فوراً.

    • القائمة ستتطوّر. النمط لن: كلّ skill صغير، مركّز، يقرأ من نفس الخزنة التي تكتب إليها أصلاً.

    لماذا تتفوّق Skills على Custom Instructions

    قبل وجود skills، الطريقة لمنح Claude وعياً بالخزنة كانت لصق تعليمات طويلة في كلّ موجِّه أو في system prompt على نمط Custom GPT. هذا الأسلوب له ثلاث مشاكل:

  • يضخّم السياق. كلّ جلسة تدفع تكلفة tokens.
  • يصعب تحديثه. تعليم واحد كبير هشّ؛ تعديل نقطة واحدة قد يكسر الباقي.
  • لا يمكن تركيبه. لا تستطيع "استخدام capture بلا retrieve" لو كان كلّ شيء موجّهاً عملاقاً.

    • Skills تحلّ الثلاثة. كلّ skill يُحمَّل عند استدعائه فقط، التعديلات محلّيّة، وتتركّب طبيعياً: capture ثمّ link ثمّ summarize سير عمل، لا كتلة واحدة.

    الملفّان المقترنان اللذان يجعلانها نافعةً

    Skills أدوات. الأدوات بلا سياق تنتج مخرجات عامّة. الاقتران الذي يجعل المجموعة الرسميّة تعمل لي:

    الملفّ 1, ملفّاتك الأساسيّة الثلاثة للدماغ الثاني (هويّة / مشاريع / قرارات). بدونها، الـ skills لا تعرف ماذا تلتقط بصفته، ماذا تسترجع من أجله، أو بأيّ شيء تربط. راجع مقال قالب الملفّات الثلاثة للبنية.

    الملفّ 2, ملفّ فهرس skills (.obsidian/ai-skills.md أو ما شابه). ملفّ قصير يسرد أيّ skills رسميّة مثبَّتة ومتى يُستدعى كلّ منها. مثال: "استخدم daily في بداية الجلسة. استخدم capture عندما أشارك فكرةً عابرةً. استخدم summarize فقط عند طلبي الصريح." هذا الفهرس يعمل كموجِّه-meta يساعد Claude على اختيار الـ skill الصحيح دون اضطرارك للتسمية في كلّ مرّة.

    مع هذين القطعتين، تبدأ الـ skills بالتصرّف كما تُعَلَّن. بدونهما، هي مجرّد موجِّهات مكتوبة جيّداً تبحث عن سياق غير موجود.

    كيف أستخدمها فعلاً يوميّاً

    يوم واقعيّ:

  • الصباح. أفتح Claude Code في المشروع الذي أعمل عليه. الـ CLAUDE.md الجذريّ يُحمَّل، مع أيّ CLAUDE.md خاصّ بالمجلّد. الـ daily skill شُغِّل عند فتح Claude.ai لعمل وضع الدردشة؛ Claude يعرف ما هو نشط.
  • أثناء العمل. أضع أفكاراً سطريّةً في Claude ("العميل X ذكر أنّه قلق بشأن Y"). الـ capture skill يقرّر إن كان ذلك ينتمي إلى projects.md تحت ذلك العميل، إلى decisions.md، أو كملاحظة جديدة. نادراً ما أحتاج لتحديد المكان.
  • نهاية الأسبوع. أشغّل summarize على التقاطات الأسبوع + ملفّ المشاريع. المخرَج مسوّدة مراجعة الجمعة أعدّلها، لا أكتبها من الصفر.
  • عند التعثّر. أستدعي retrieve بالمشكلة الحاليّة. الـ skill يسحب 3 - 5 ملاحظات الأكثر صلةً (أحياناً قرارات سابقة نسيت أنّي اتّخذتها) ويغذّيها كسياق.
  • عند الربط. عند كتابة ملاحظة طويلة جديدة، أشغّل link لاقتراح ملاحظات موجودة يجب الإشارة إليها. نحو 30% من الاقتراحات نافعة، 70% ضوضاء، نافع بما يكفي لمواصلة الاستخدام.

    • لا شيء من هذا غريب. هو نفس سير العمل الذي كان لديّ قبل الـ skills الرسميّة، لكن باحتكاك أقلّ.

    ما لا تفعله Skills

    تحديد توقّعات بصدق:

  • لا تصلح خزنةً بائتةً. لو كان ملفّ مشاريعك النشطة قبل ثلاثة أشهر، ستسحب الـ skills سياقاً بائتاً بثقة.
  • لا تستبدل قالب الملفّات الثلاثة. تجلس فوقه. بدون قاعدة هويّة/مشاريع/قرارات، الـ skills لا تملك إشارةً كافيةً لتكون نافعةً.
  • لا تعمل خارج Claude. هي Claude Skills تحديداً. القدرات التي تشفّرها (التقاط، استرجاع، تلخيص) عامّة، لكنّ التطبيق الرسميّ يستهدف Claude.
  • لا تحفظ ذوقك. تتبع التعليمات في ملفّات سياقك؛ لو لم يكن ذوقك موثَّقاً هناك، لن تستنتجه الـ skills.

    • التثبيت (مستوى عالٍ)

    التفاصيل ستتغيّر مع تحديثات المستودع الرسميّ. النمط:

  • استنسخ أو حمّل مستودع skills الرسميّة (مرتبط من منشورات Steph Ango / مجتمع Obsidian).
  • أضف skills إلى مساحة Claude.ai عبر واجهة Skills، أو أشِر إليها من Claude Code عبر إعداداتك.
  • أضف ملفّ فهرس skills إلى خزنتك.
  • اختبر بمهمّة صغيرة. لو لم يختر capture الوجهة الصحيحة، عدّل ملفّات سياقك (لا الـ skill) حتى يفعل.

    • الإعداد لمرّة واحدة، ربّما 30 دقيقة، ثمّ يصبح غير مرئيّ.

    إلى أين بعد

  • لو ليس لديك دماغ ثانٍ بعد، ابدأ بـ قالب الملفّات الثلاثة.
  • لو كان لديك خزنة لكنّها ضوضائيّة للذكاء الاصطناعيّ، اقرأ المقال الأساسيّ لمبادئ التنقية.
  • لو تستخدم ChatGPT وتتساءل عن التبديل، مقارنة Claude + Obsidian تغطّي المقايضات.

    • الـ skills الرسميّة أسهل طريقة لاختبار ما إذا كان Obsidian المعزَّز بالذكاء الاصطناعيّ يلائم سير عملك. اقضِ أسبوعاً معها فوق دماغ ثانٍ حقيقيّ وستعرف.