Obsidian Notes skill
Writes notes in Obsidian's format, with links between notes, callouts and properties.
A Free skill. Sign-in opens soon.
- By
- Steph Ango
- Licence
- MIT
- Installs
- 91.3K
- Works in
- 17 apps
What Obsidian Notes makes
This skill teaches your AI to write notes the way Obsidian expects them. Obsidian is a note-taking app that uses plain text files. It adds its own extras to normal Markdown, and this skill covers those extras so the notes work properly in your vault.
It covers links between notes (wikilinks), embeds of other notes, images and PDFs, callout boxes, and properties at the top of a note such as title, tags and aliases. Its steps are: add properties, write the content, link related notes, embed what you need, add callouts and check the note displays correctly.
Best for: Obsidian users who want their AI to write notes that fit into their vault.
- Wikilinks to notes, headings and blocks
- Embeds for notes, images and PDF pages
- Callouts such as note, tip and warning
- Properties: tags, aliases and more
- Tells you when to use wikilinks and when normal links
Made with this skill
Obsidian note from a call with a plumber. Turn rough notes from a call into an Obsidian note: Dana from Harbor Plumbing; moving the sink to the window wall; drain can move about 2 m along the outside wall without cutting joists; old shut-off valve is seized, replace it; dishwasher stays on the sink side; Nov 18 start held only if confirmed by Friday; check sill height against the chosen tap; photos already sent; need a written quote; ask Sam the electrician about the outlet; a cheaper pump option, not keen. The vault already has notes for Harbor Plumbing, Kitchen renovation 2026, Appliance list, Tap options and Sam (electrician), and the call recording. Any brands, names or numbers inside are invented examples.
Example prompts
Type something like this once the skill is added. Your app opens the skill when the request matches.
-
Create a meeting note with properties, a callout for decisions and links to related notes.
-
Turn this article summary into an Obsidian note with tags.
-
Add a foldable FAQ callout to my project note.
-
Fix the links in this note so Obsidian tracks renames.
What’s inside
5 files in the skill folder, with its MIT licence kept inside. Only text instructions and reference files, no program files.
- SKILL.md the instructions
- references/ 3 files
- LICENSE licence
Which apps it works in
A skill is a folder of plain files, so any app that reads the open skills format can use it. Pick your app for its page.
How to add Obsidian Notes to your app
Step by step for each app. We say where to click, so you never need to leave this page.
ChatGPTby OpenAI
- 1 Download the skill (.zip) with the button at the top of this page, then unzip it.
- 2 Open the ChatGPT desktop app and look for Skills in the sidebar, where standalone skills are listed.
- 3 Add the “obsidian-markdown” folder there if your version offers it. If you do not see Skills yet, use this skill in Claude or Codex instead.
- 4 In a chat, type @ and pick the skill, or just ask. Ask for what you want, for example: “Create a meeting note with properties, a callout for decisions and links to related notes.”
To make your own, describe the workflow to @skill-creator in ChatGPT Work and it drafts a skill for you.
Claude appby Anthropic
- 1 Download the skill (.zip) with the button at the top of this page.
- 2 In the Claude app, open Settings > Features.
- 3 Upload the .zip file.
- 4 Ask for what you want, for example: “Create a meeting note with properties, a callout for decisions and links to related notes.”
The current Claude Help Center lists Free, Pro, Max, Team and Enterprise. Organization policy can restrict uploads and sharing. Chat runs code in an isolated environment; uploading a skill does not give it your local project, coding-agent tools or unrestricted network access.
Codexby OpenAI
- 1 Download the skill (.zip) with the button at the top of this page, then unzip it.
- 2 Move the “obsidian-markdown” folder into your skills folder:
~/.agents/skills - 3 Or paste the install prompt below into Codex and let it do the copying.
- 4 Start a new session. Ask for what you want, for example: “Create a meeting note with properties, a callout for decisions and links to related notes.”
Install prompt: paste this into Codex
I downloaded the agent skill "Obsidian Notes" as obsidian-markdown.zip. Unzip it and copy the obsidian-markdown folder into ~/.agents/skills. Before you finish, list every file it contains, show me any scripts and what they do, and stop if anything asks for passwords, API keys or downloads from other websites.
To use the skill in one project only, put it in .agents/skills inside that project instead.
Claude Codeby Anthropic
- 1 Download the skill (.zip) with the button at the top of this page, then unzip it.
- 2 Move the “obsidian-markdown” folder into your skills folder:
~/.claude/skills - 3 Or paste the install prompt below into Claude Code and let it do the copying.
- 4 Start a new session. Ask for what you want, for example: “Create a meeting note with properties, a callout for decisions and links to related notes.”
Install prompt: paste this into Claude Code
I downloaded the agent skill "Obsidian Notes" as obsidian-markdown.zip. Unzip it and copy the obsidian-markdown folder into ~/.claude/skills. Before you finish, list every file it contains, show me any scripts and what they do, and stop if anything asks for passwords, API keys or downloads from other websites.
Built-in installer: claude plugin marketplace add <owner/repo>
Built-in installer: claude plugin install <plugin>@<marketplace>
To use the skill in one project only, put it in .claude/skills inside that project instead.
Cursor
- 1 Download the skill (.zip) with the button at the top of this page, then unzip it.
- 2 Move the “obsidian-markdown” folder into your skills folder:
~/.cursor/skills - 3 Or paste the install prompt below into Cursor and let it do the copying.
- 4 Start a new session. Ask for what you want, for example: “Create a meeting note with properties, a callout for decisions and links to related notes.”
Install prompt: paste this into Cursor
I downloaded the agent skill "Obsidian Notes" as obsidian-markdown.zip. Unzip it and copy the obsidian-markdown folder into ~/.cursor/skills. Before you finish, list every file it contains, show me any scripts and what they do, and stop if anything asks for passwords, API keys or downloads from other websites.
To use the skill in one project only, put it in .cursor/skills inside that project instead. Cursor also reads ~/.agents/skills, ~/.claude/skills, ~/.codex/skills.
GitHub Copilotby GitHub
- 1 Download the skill (.zip) with the button at the top of this page, then unzip it.
- 2 Move the “obsidian-markdown” folder into your skills folder:
~/.copilot/skills - 3 Or paste the install prompt below into GitHub Copilot and let it do the copying.
- 4 Start a new session. Ask for what you want, for example: “Create a meeting note with properties, a callout for decisions and links to related notes.”
Install prompt: paste this into GitHub Copilot
I downloaded the agent skill "Obsidian Notes" as obsidian-markdown.zip. Unzip it and copy the obsidian-markdown folder into ~/.copilot/skills. Before you finish, list every file it contains, show me any scripts and what they do, and stop if anything asks for passwords, API keys or downloads from other websites.
Built-in installer: gh skill install <owner/repo> <skill> --agent github-copilot --scope user
To use the skill in one project only, put it in .github/skills inside that project instead. GitHub Copilot also reads ~/.agents/skills.
Gemini CLIby Google
- 1 Download the skill (.zip) with the button at the top of this page, then unzip it.
- 2 Move the “obsidian-markdown” folder into your skills folder:
~/.gemini/skills - 3 Or paste the install prompt below into Gemini CLI and let it do the copying.
- 4 Start a new session. Ask for what you want, for example: “Create a meeting note with properties, a callout for decisions and links to related notes.”
Install prompt: paste this into Gemini CLI
I downloaded the agent skill "Obsidian Notes" as obsidian-markdown.zip. Unzip it and copy the obsidian-markdown folder into ~/.gemini/skills. Before you finish, list every file it contains, show me any scripts and what they do, and stop if anything asks for passwords, API keys or downloads from other websites.
Built-in installer: gemini skills install <git-url>
To use the skill in one project only, put it in .gemini/skills inside that project instead. Gemini CLI also reads ~/.agents/skills.
Windsurf
- 1 Download the skill (.zip) with the button at the top of this page, then unzip it.
- 2 Move the “obsidian-markdown” folder into your skills folder:
~/.codeium/windsurf/skills - 3 Or paste the install prompt below into Windsurf and let it do the copying.
- 4 Start a new session. Ask for what you want, for example: “Create a meeting note with properties, a callout for decisions and links to related notes.”
Install prompt: paste this into Windsurf
I downloaded the agent skill "Obsidian Notes" as obsidian-markdown.zip. Unzip it and copy the obsidian-markdown folder into ~/.codeium/windsurf/skills. Before you finish, list every file it contains, show me any scripts and what they do, and stop if anything asks for passwords, API keys or downloads from other websites.
To use the skill in one project only, put it in .windsurf/skills inside that project instead.
Kiro
- 1 Download the skill (.zip) with the button at the top of this page, then unzip it.
- 2 Move the “obsidian-markdown” folder into your skills folder:
~/.kiro/skills - 3 Or paste the install prompt below into Kiro and let it do the copying.
- 4 Start a new session. Ask for what you want, for example: “Create a meeting note with properties, a callout for decisions and links to related notes.”
Install prompt: paste this into Kiro
I downloaded the agent skill "Obsidian Notes" as obsidian-markdown.zip. Unzip it and copy the obsidian-markdown folder into ~/.kiro/skills. Before you finish, list every file it contains, show me any scripts and what they do, and stop if anything asks for passwords, API keys or downloads from other websites.
To use the skill in one project only, put it in .kiro/skills inside that project instead.
Antigravityby Google
- 1 Download the skill (.zip) with the button at the top of this page, then unzip it.
- 2 Move the “obsidian-markdown” folder into your skills folder:
~/.gemini/antigravity/skills - 3 Or paste the install prompt below into Antigravity and let it do the copying.
- 4 Start a new session. Ask for what you want, for example: “Create a meeting note with properties, a callout for decisions and links to related notes.”
Install prompt: paste this into Antigravity
I downloaded the agent skill "Obsidian Notes" as obsidian-markdown.zip. Unzip it and copy the obsidian-markdown folder into ~/.gemini/antigravity/skills. Before you finish, list every file it contains, show me any scripts and what they do, and stop if anything asks for passwords, API keys or downloads from other websites.
To use the skill in one project only, put it in .agents/skills inside that project instead.
OpenCode
- 1 Download the skill (.zip) with the button at the top of this page, then unzip it.
- 2 Move the “obsidian-markdown” folder into your skills folder:
~/.config/opencode/skills - 3 Or paste the install prompt below into OpenCode and let it do the copying.
- 4 Start a new session. Ask for what you want, for example: “Create a meeting note with properties, a callout for decisions and links to related notes.”
Install prompt: paste this into OpenCode
I downloaded the agent skill "Obsidian Notes" as obsidian-markdown.zip. Unzip it and copy the obsidian-markdown folder into ~/.config/opencode/skills. Before you finish, list every file it contains, show me any scripts and what they do, and stop if anything asks for passwords, API keys or downloads from other websites.
To use the skill in one project only, put it in .opencode/skills inside that project instead. OpenCode also reads ~/.agents/skills, ~/.claude/skills.
Cline
- 1 Download the skill (.zip) with the button at the top of this page, then unzip it.
- 2 Move the “obsidian-markdown” folder into your skills folder:
~/.agents/skills - 3 Or paste the install prompt below into Cline and let it do the copying.
- 4 Start a new session. Ask for what you want, for example: “Create a meeting note with properties, a callout for decisions and links to related notes.”
Install prompt: paste this into Cline
I downloaded the agent skill "Obsidian Notes" as obsidian-markdown.zip. Unzip it and copy the obsidian-markdown folder into ~/.agents/skills. Before you finish, list every file it contains, show me any scripts and what they do, and stop if anything asks for passwords, API keys or downloads from other websites.
To use the skill in one project only, put it in .agents/skills inside that project instead.
Amp
- 1 Download the skill (.zip) with the button at the top of this page, then unzip it.
- 2 Move the “obsidian-markdown” folder into your skills folder:
~/.config/agents/skills - 3 Or paste the install prompt below into Amp and let it do the copying.
- 4 Start a new session. Ask for what you want, for example: “Create a meeting note with properties, a callout for decisions and links to related notes.”
Install prompt: paste this into Amp
I downloaded the agent skill "Obsidian Notes" as obsidian-markdown.zip. Unzip it and copy the obsidian-markdown folder into ~/.config/agents/skills. Before you finish, list every file it contains, show me any scripts and what they do, and stop if anything asks for passwords, API keys or downloads from other websites.
Built-in installer: amp skill add <github-url> --global
To use the skill in one project only, put it in .agents/skills inside that project instead. Amp also reads ~/.agents/skills, ~/.config/amp/skills, ~/.claude/skills.
Gooseby Block
- 1 Download the skill (.zip) with the button at the top of this page, then unzip it.
- 2 Move the “obsidian-markdown” folder into your skills folder:
~/.agents/skills - 3 Or paste the install prompt below into Goose and let it do the copying.
- 4 Start a new session. Ask for what you want, for example: “Create a meeting note with properties, a callout for decisions and links to related notes.”
Install prompt: paste this into Goose
I downloaded the agent skill "Obsidian Notes" as obsidian-markdown.zip. Unzip it and copy the obsidian-markdown folder into ~/.agents/skills. Before you finish, list every file it contains, show me any scripts and what they do, and stop if anything asks for passwords, API keys or downloads from other websites.
To use the skill in one project only, put it in .agents/skills inside that project instead. Goose also reads ~/.claude/skills.
OpenClaw
- 1 Download the skill (.zip) with the button at the top of this page, then unzip it.
- 2 Move the “obsidian-markdown” folder into your skills folder:
~/.openclaw/skills - 3 Or paste the install prompt below into OpenClaw and let it do the copying.
- 4 Start a new session. Ask for what you want, for example: “Create a meeting note with properties, a callout for decisions and links to related notes.”
Install prompt: paste this into OpenClaw
I downloaded the agent skill "Obsidian Notes" as obsidian-markdown.zip. Unzip it and copy the obsidian-markdown folder into ~/.openclaw/skills. Before you finish, list every file it contains, show me any scripts and what they do, and stop if anything asks for passwords, API keys or downloads from other websites.
Built-in installer: openclaw skills install @owner/<slug>
Built-in installer: openclaw skills install @owner/<slug> --global
Built-in installer: openclaw skills install git:owner/repo@ref
To use the skill in one project only, put it in skills inside that project instead. OpenClaw also reads ~/.agents/skills.
Hermes Agentby Nous Research
- 1 Download the skill (.zip) with the button at the top of this page, then unzip it.
- 2 Move the “obsidian-markdown” folder into your skills folder:
~/.hermes/skills - 3 Or paste the install prompt below into Hermes Agent and let it do the copying.
- 4 Start a new session. Ask for what you want, for example: “Create a meeting note with properties, a callout for decisions and links to related notes.”
Install prompt: paste this into Hermes Agent
I downloaded the agent skill "Obsidian Notes" as obsidian-markdown.zip. Unzip it and copy the obsidian-markdown folder into ~/.hermes/skills. Before you finish, list every file it contains, show me any scripts and what they do, and stop if anything asks for passwords, API keys or downloads from other websites.
Built-in installer: hermes skills install <owner/repo/skill>
VS Codeby Microsoft
- 1 Download the skill (.zip) with the button at the top of this page, then unzip it.
- 2 Move the “obsidian-markdown” folder into your skills folder:
~/.copilot/skills - 3 Or paste the install prompt below into VS Code and let it do the copying.
- 4 Start a new session. Ask for what you want, for example: “Create a meeting note with properties, a callout for decisions and links to related notes.”
Install prompt: paste this into VS Code
I downloaded the agent skill "Obsidian Notes" as obsidian-markdown.zip. Unzip it and copy the obsidian-markdown folder into ~/.copilot/skills. Before you finish, list every file it contains, show me any scripts and what they do, and stop if anything asks for passwords, API keys or downloads from other websites.
To use the skill in one project only, put it in .github/skills inside that project instead. VS Code also reads ~/.claude/skills, ~/.agents/skills.
Questions about Obsidian Notes
Do I need Obsidian?
The notes are plain Markdown files, but the extras only display properly in Obsidian.
Does it cover normal Markdown?
No. It assumes ordinary Markdown is already known and covers only the Obsidian extras.
Does it edit my vault?
It writes and edits the note files your agent has access to.
Is the Obsidian Notes skill free?
Yes. It is a Free skill on Best Agent Skills. Sign-in opens soon; when it does, a free account is all you need to download it.
Who made the Obsidian Notes skill?
Steph Ango. We did not write it. Best Agent Skills curates skills like this one, explains them in plain words and shows how to add them to your app. It is shared under the MIT licence (Copyright (c) 2026 Steph Ango (@kepano)).
