--- title: "Build Your AI Second Brain: Obsidian + Claude + Steph Ango's Official Skills" title_ar: "دماغك الثاني بالذكاء الاصطناعي: Obsidian + Claude + السكيلز الرسمية" url: "https://www.aiwithmo.com/prompts/obsidian-claude-second-brain" canonical: "https://www.aiwithmo.com/prompts/obsidian-claude-second-brain" published: 2026-05-12 updated: 2026-05-14 category: ai-tools languages: [ar, en] author: Mohamed Khair site: aiwithmo --- # Build Your AI Second Brain: Obsidian + Claude + Steph Ango's Official Skills ## دماغك الثاني بالذكاء الاصطناعي: Obsidian + Claude + السكيلز الرسمية Source: https://www.aiwithmo.com/prompts/obsidian-claude-second-brain · Author: Mohamed Khair (محمد خير), aiwithmo · Published in Arabic and English. ## English Every conversation you have with Claude starts from zero. The AI remembers nothing about your projects, your decisions, or your thinking style. You re-explain everything, every single time. Obsidian fixes this permanently. Obsidian is a free note-taking app built entirely on plain Markdown files stored locally on your device. Because your vault is just a folder of text files, Claude Code can read, write, search, and link across all of it, without any plugins, APIs, or complex setup. You open your terminal inside the vault folder, type claude, and Claude has access to your entire knowledge base. The moment that changed everything came in January 2026. Steph Ango, CEO of Obsidian (known as kepano on GitHub), quietly published an official repository called obsidian-skills. It crossed 13,900 stars within weeks. The repo teaches Claude Code the correct syntax for every Obsidian file type: wikilinks, frontmatter, Bases databases, Canvas spatial maps, and the Obsidian CLI. Without these skills, Claude writes broken links. With them, it writes notes a human expert would be proud of. Around the same time, Andrej Karpathy, co-founder of OpenAI, shared an approach that validated the entire pattern: instead of building complex RAG pipelines with vector databases and embeddings, just point an LLM at plain Markdown files and let it read, link, and maintain them directly. 14,000 GitHub stars in a week. The community had its blueprint. The result: a Second Brain that does not just store your knowledge: it actively connects it, queries it, and builds on it every time you add something new. Official skills repo: https://github.com/kepano/obsidian-skills Follow for more: - https://www.instagram.com/ai.with.mo/ Course Registration: - https://halaqa.app/enrollment?course=start-with-ai ## العربية كل محادثة بتبدأها مع Claude بتبدأ من الصفر. ما بتذكر مشاريعك، قراراتك، ولا طريقة تفكيرك. بتشرح من أول وجديد كل مرة. Obsidian بيحل هالمشكلة بشكل نهائي. Obsidian تطبيق ملاحظات مجاني مبني على ملفات Markdown عادية محفوظة على جهازك مباشرة. وبسبب إن الـ vault مجرد مجلد ملفات نصية، Claude Code يقدر يقرأ، يكتب، يبحث، ويربط بين كل المحتوى، بدون أي إضافات أو APIs أو إعداد معقد. بتفتح التيرمنال جوا مجلد الـ vault، بتكتب claude، وClaude عنده وصول لكل قاعدة معرفتك. اللحظة اللي غيرت كل شيء كانت في يناير 2026. Steph Ango، الـ CEO تبع Obsidian والمعروف بـ kepano على GitHub، نشر ريبو رسمي اسمه obsidian-skills. وصل لـ 13,900 نجمة خلال أسابيع. الريبو بيعلّم Claude Code الصيغة الصحيحة لكل نوع ملف في Obsidian: الـ wikilinks، الـ frontmatter، قواعد بيانات Bases، خرائط Canvas، وأوامر الـ CLI. بدون هالسكيلز، Claude بيكتب روابط مكسورة. معها، بيكتب ملاحظات متقنة. في نفس الوقت تقريباً، Andrej Karpathy، المؤسس المشارك لـ OpenAI، شارك فكرة أكدت هالنهج كله: بدل ما تبني RAG pipelines معقدة مع vector databases، بس وجّه الـ LLM على ملفات Markdown عادية وخليه يقرأها ويربطها ويحافظ عليها مباشرة. 14,000 نجمة GitHub في أسبوع واحد. النتيجة: دماغ ثاني ما بيخزن معرفتك بس: بيربطها، بيبحث فيها، وبيبني عليها كل مرة تضيف شيء جديد. رابط الريبو الرسمي: https://github.com/kepano/obsidian-skills تابع حسابي على الانستغرام: - https://www.instagram.com/ai.with.mo/ رابط الانضمام للدورة: - https://halaqa.app/enrollment?course=start-with-ai ## Steps ### 1. The Problem Every Note-Taker Hits - and Why Obsidian Fixes It *Notes go in. They rarely come back out at the right moment.* Most people who take notes seriously hit the same wall: the knowledge goes in but rarely comes back out. You wrote something important six months ago. You will never find it. The folder system breaks down. The tags get inconsistent. The connections between ideas - the whole point of a second brain - never actually get made, because making them manually takes more effort than the system saves. Obsidian's Graph View makes the problem visible: isolated nodes with no connections. The insight that changed this in 2026 is that you were never supposed to maintain those connections yourself. Claude Code, pointed at a vault of plain Markdown files, can read every note you have ever written, find the relationships you missed, and build the links for you. The vault becomes something you actually use rather than something you maintain. ### 2. Steph Ango's obsidian-skills: Why It Changes Everything *The CEO of Obsidian officially taught Claude how to use his own app* In January 2026, Steph Ango - CEO of Obsidian, known as kepano on GitHub - published an official repository called obsidian-skills. It reached 13,900+ stars within weeks. This is not a community plugin or a third-party integration. It is the product leadership officially signaling that AI agents are now first-class collaborators in Obsidian. The repository ships five skills that teach Claude Code the correct syntax for every Obsidian file type. Without them, Claude guesses at the format and often gets it wrong: broken wikilinks, invalid Bases JSON, Canvas files that won't open. With them, Claude writes notes exactly as a human Obsidian expert would - proper frontmatter, correct wikilink syntax, valid database queries, and spatial canvas layouts. Installation takes one command. The difference in output quality is immediate. ### 3. How to Structure Your Vault So Claude Can Actually Use It *Structure beats volume - 100 organized notes beat 1,000 scattered ones* The most common failure mode is creating hundreds of notes with no consistent structure, then wondering why Claude's answers are generic. Two things make the difference. First, the CLAUDE.md file at your vault root - Claude Code reads this automatically at the start of every session. Put your folder structure, your tagging schema, your note templates, and the rules you want Claude to follow. This is your contract with the AI. Second, YAML frontmatter at the top of every note. Without it, Claude treats all files as equal. With it, you can ask for 'all notes with status active and tag project-alpha' and get exactly that. The minimum frontmatter is four fields: date, tags, status, and type. That is enough to turn a folder of text files into a queryable knowledge database. ### 4. The Prompts That Actually Build the Second Brain *Tell Claude what to connect, not how to connect it* The key mental shift is asking for outcomes, not instructions. Instead of 'read this note and find related notes,' say 'scan everything I added this week, find 3-5 existing notes each new note relates to, add wikilinks in both directions, and tell me why each connection matters.' Claude reads across your entire vault, identifies relationships you never noticed, and builds a mesh of links that compounds every time you add something new. The 50th note you add is dramatically more connected than the first - because Claude cross-references it against everything that already exists. Other high-value prompts: building topic wiki pages that synthesize everything you know about a subject, processing your inbox into the right PARA folder with correct metadata, and running weekly synthesis that surfaces decisions made, open questions, and new connections across your projects. ## الخطوات ### 1. المشكلة اللي كل واحد بيوصلها مع الملاحظات *بتكتب ملاحظات ما بترجعلك وقت تحتاجها* معظم الناس اللي بياخذوا ملاحظات بجدية بيوصلوا لنفس الجدار: المعرفة بتدخل بس ما بترجع. كتبت شيء مهم قبل ستة أشهر - ما رح تلاقيه. نظام المجلدات بيتشتت. التاغات بتصير غير منتظمة. الروابط بين الأفكار - اللي هاد أصلاً الهدف من الدماغ الثاني - ما بتتعمل بالفعل، لأن تعملها يدوياً بياخذ وقت أكثر مما بيوفر النظام. Graph View في Obsidian بيخليك تشوف المشكلة واضحة: نقاط معزولة بدون روابط. الفكرة اللي غيرت هالموضوع في 2026 هي إنك ما المفروض تكون أنت اللي تحافظ على هالروابط. Claude Code، لما تشيره على مجلد ملفات Markdown، يقدر يقرأ كل ملاحظة كتبتها، يلاقي العلاقات اللي فاتتك، ويبني الروابط عنك. ### 2. ريبو obsidian-skills: ليش هو أهم شيء في هالموضوع *الـ CEO تبع Obsidian علّم Claude كيف يستخدم تطبيقه بشكل صح* في يناير 2026، نشر Steph Ango - الـ CEO تبع Obsidian، المعروف بـ kepano على GitHub - ريبو رسمي اسمه obsidian-skills. وصل لـ 13,900+ نجمة خلال أسابيع. هاد مو بلاغين مجتمع أو تكامل تابع ثالث. هاد إشارة رسمية من قيادة المنتج إن وكلاء الذكاء الاصطناعي صاروا شركاء من الدرجة الأولى في Obsidian. الريبو فيه 5 سكيلز بتعلّم Claude Code الصيغة الصحيحة لكل نوع ملف في Obsidian. بدونها، Claude بيخمّن الشكل وكثير بيغلط: روابط مكسورة، JSON غير صالح لـ Bases، ملفات Canvas ما بتفتح. معها، Claude بيكتب ملاحظات متقنة تماماً - frontmatter صحيح، wikilinks سليمة، استعلامات قواعد بيانات صحيحة، وتخطيطات Canvas منظمة. التثبيت أمر واحد. الفرق في جودة المخرجات فوري. ### 3. كيف ترتب الـ vault حتى Claude يقدر يشتغل عليه فعلاً *التنظيم أهم من الكمية* أكثر شيء بيفشل فيه الناس هو إنهم يعملوا مئات الملاحظات بدون هيكل ثابت، وبعدين يتساءلوا ليش إجابات Claude عامة. في شيئين بيعملوا الفرق. أول شيء: ملف CLAUDE.md في جذر الـ vault - Claude Code بيقرأه تلقائياً في بداية كل جلسة. حطّ فيه هيكل المجلدات، نظام التاغات، قوالب الملاحظات، والقواعد اللي بدك Claude يتبعها. هاد عقدك مع الذكاء الاصطناعي. ثاني شيء: YAML frontmatter في أعلى كل ملاحظة. بدونه، Claude بيتعامل مع كل الملفات بنفس الطريقة. معه، تقدر تطلب 'كل الملاحظات بـ status نشط وتاغ project-alpha' وتحصل على بالضبط هيك. الـ frontmatter الأدنى هو 4 حقول: date، tags، status، وtype. هاد كافي لتحوّل مجلد ملفات نصية لقاعدة معرفة قابلة للاستعلام. ### 4. البرومتات اللي بتبني الدماغ الثاني فعلاً *قوله شو يربط، مو كيف يربط* التغيير الذهني المهم هو إنك تطلب نتائج مو تعليمات. بدل 'اقرأ هالملاحظة ولاقي ملاحظات مرتبطة'، قول: 'افحص كل شيء أضفته هالأسبوع، لاقي 3-5 ملاحظات موجودة كل ملاحظة جديدة مرتبطة فيها، أضف wikilinks بالاتجاهين، وقلي ليش كل ربط مهم.' Claude بيقرأ عبر كل الـ vault، بيحدد علاقات ما لاحظتها، وبيبني شبكة روابط بتتراكم كل مرة تضيف شيء جديد. الملاحظة الخمسين اللي تضيفها أكثر ارتباطاً بمراحل من الأولى - لأن Claude بيقارنها مع كل اللي موجود مسبقاً. برومتات ثانية بتعطي قيمة كبيرة: بناء صفحات wiki للمواضيع بتلخص كل ما تعرفه، معالجة الـ inbox ونقله للمجلد الصح مع البيانات الوصفية، وتلخيص أسبوعي بيبرز القرارات المتخذة والأسئلة المفتوحة والروابط الجديدة بين مشاريعك. ## Prompt (البرومبت) ```text # ─── STEP 1: INSTALL OBSIDIAN-SKILLS (The Most Important Step) ─── # Open your terminal inside your Obsidian vault folder, then run: git clone https://github.com/kepano/obsidian-skills .claude/skills # Or via Claude Code plugin marketplace: /plugin marketplace add kepano/obsidian-skills /plugin install obsidian@obsidian-skills # Before working with a specific file type, load the relevant skill: /obsidian-markdown # For .md notes: correct wikilinks & frontmatter /obsidian-bases # For .base database files /json-canvas # For .canvas spatial maps /defuddle # Strip web pages to clean markdown before saving # ─── STEP 2: CREATE YOUR CLAUDE.md AT VAULT ROOT ─── # This is the most important file: Claude reads it first in every session. # Template: ## Vault Overview This is a personal knowledge base organized using the PARA method. Owner: [Your name] | Focus: [Your main topics] ## Folder Structure - 0. Inbox/ → Unsorted incoming notes - 1. Projects/ → Active work with deadlines - 2. Areas/ → Ongoing responsibilities - 3. Resources/ → Reference and research - 4. Archive/ → Completed or inactive items ## Note Schema (always use this frontmatter): --- date: YYYY-MM-DD tags: [topic, subtopic] status: active | draft | archived project: project-name type: note | meeting | research | idea | decision --- ## Rules for Claude: - Always use [[wikilinks]] for internal references - Never modify files in 4. Archive/ - When adding a new note, check for existing related notes and link them - Use /obsidian-markdown skill before writing any .md file # ─── STEP 3: PROMPTS THAT ACTUALLY BUILD YOUR SECOND BRAIN ─── # Connect everything, run this after adding new notes: "Scan all notes in 3. Resources/ added this week. For each new note, find 3-5 existing notes it relates to and add [[wikilinks]] to both files. Write a one-line reason for each link." # Build a topic wiki page automatically: "Read all notes tagged [your topic]. Create a new wiki page in 3. Resources/[topic].md that summarizes the key ideas, lists all related notes as wikilinks, and highlights contradictions or gaps." # Process your inbox: "Go through every file in 0. Inbox/. For each one: 1. Determine the correct PARA category 2. Move it to the right folder 3. Add proper frontmatter (date, tags, type, status) 4. Link it to 2-3 related existing notes Report what you moved and why." # Weekly synthesis: "Summarize all notes modified or created this week. Group by project. List decisions made, open questions, and new connections found between topics. Save as _Weekly/[YYYY-WXX].md" # Ask your own knowledge base: "What have I decided about [topic]? Check my decision notes and quote the relevant parts with file references." # ─── PRO TIPS ─── # /defuddle before saving any web article, cuts token cost by ~60% # YAML frontmatter is essential, without it Claude treats all files the same # The 50th note you add is more useful than the first: connections compound # Claude Code does NOT need MCP for this, just open terminal in vault folder ``` --- More free bilingual AI guides: https://www.aiwithmo.com/prompts · One to one AI mentorship in Arabic or English: https://www.aiwithmo.com/mentorship