Obsidian Skills
Six skills that teach your agent Obsidian: notes syntax, databases, canvases, the command line and web clipping.
A Free skill. Sign-in opens soon.
- By
- Steph Ango (kepano)
- Licence
- MIT
- Works in
- 17 apps
What Obsidian Skills makes
Obsidian Skills is a pack by Steph Ango (kepano) that teaches an agent how to work inside an Obsidian notes vault. It covers the note format, database-like views, visual canvases and the command line tool.
This is the pack that contains our separate Obsidian Markdown page. Choose the pack if you want all six skills, or the single skill if you only write notes with links and callouts.
Best for: Obsidian users who want their AI to write notes the way Obsidian expects.
- obsidian-markdown: write notes with wikilinks, embeds, callouts and properties.
- obsidian-bases: build database-like table and card views of your notes.
- json-canvas: create and edit canvas files with nodes, edges and groups.
- obsidian-cli: read, create and search notes from the command line.
- defuddle: pull clean Markdown out of a web page.
Example prompts
Type something like this once the skill is added. Your app opens the skill when the request matches.
-
Create a note for my reading list with a table of books and links to related notes.
-
Make a canvas that maps the chapters of my novel and how they connect.
-
Build a Base that shows all my project notes by status.
-
Clip this article into a clean note for my vault.
What’s inside
12 files in this pack, with its MIT licence kept inside. Only text instructions and reference files, no program files.
- defuddle/ 1 files
- json-canvas/ 2 files
- knap/ 1 files
- obsidian-bases/ 2 files
- obsidian-cli/ 1 files
- obsidian-markdown/ 4 files
- LICENSE licence
Skills in this pack
- defuddle
- json-canvas
- knap
- obsidian-bases
- obsidian-cli
- obsidian-markdown
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 Skills 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 folders inside 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 note for my reading list with a table of books 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. If the app wants one skill at a time, unzip it and upload the .zip of a single skill folder instead.
- 4 Ask for what you want, for example: “Create a note for my reading list with a table of books 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 folders inside 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 note for my reading list with a table of books and links to related notes.”
Install prompt: paste this into Codex
I downloaded the agent skill "Obsidian Skills" as obsidian-skills.zip. Unzip it and copy the folders inside 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 folders inside 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 note for my reading list with a table of books and links to related notes.”
Install prompt: paste this into Claude Code
I downloaded the agent skill "Obsidian Skills" as obsidian-skills.zip. Unzip it and copy the folders inside 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 folders inside 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 note for my reading list with a table of books and links to related notes.”
Install prompt: paste this into Cursor
I downloaded the agent skill "Obsidian Skills" as obsidian-skills.zip. Unzip it and copy the folders inside 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 folders inside 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 note for my reading list with a table of books and links to related notes.”
Install prompt: paste this into GitHub Copilot
I downloaded the agent skill "Obsidian Skills" as obsidian-skills.zip. Unzip it and copy the folders inside 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 folders inside 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 note for my reading list with a table of books and links to related notes.”
Install prompt: paste this into Gemini CLI
I downloaded the agent skill "Obsidian Skills" as obsidian-skills.zip. Unzip it and copy the folders inside 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 folders inside 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 note for my reading list with a table of books and links to related notes.”
Install prompt: paste this into Windsurf
I downloaded the agent skill "Obsidian Skills" as obsidian-skills.zip. Unzip it and copy the folders inside 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 folders inside 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 note for my reading list with a table of books and links to related notes.”
Install prompt: paste this into Kiro
I downloaded the agent skill "Obsidian Skills" as obsidian-skills.zip. Unzip it and copy the folders inside 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 folders inside 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 note for my reading list with a table of books and links to related notes.”
Install prompt: paste this into Antigravity
I downloaded the agent skill "Obsidian Skills" as obsidian-skills.zip. Unzip it and copy the folders inside 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 folders inside 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 note for my reading list with a table of books and links to related notes.”
Install prompt: paste this into OpenCode
I downloaded the agent skill "Obsidian Skills" as obsidian-skills.zip. Unzip it and copy the folders inside 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 folders inside 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 note for my reading list with a table of books and links to related notes.”
Install prompt: paste this into Cline
I downloaded the agent skill "Obsidian Skills" as obsidian-skills.zip. Unzip it and copy the folders inside 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 folders inside 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 note for my reading list with a table of books and links to related notes.”
Install prompt: paste this into Amp
I downloaded the agent skill "Obsidian Skills" as obsidian-skills.zip. Unzip it and copy the folders inside 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 folders inside 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 note for my reading list with a table of books and links to related notes.”
Install prompt: paste this into Goose
I downloaded the agent skill "Obsidian Skills" as obsidian-skills.zip. Unzip it and copy the folders inside 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 folders inside 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 note for my reading list with a table of books and links to related notes.”
Install prompt: paste this into OpenClaw
I downloaded the agent skill "Obsidian Skills" as obsidian-skills.zip. Unzip it and copy the folders inside 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 folders inside 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 note for my reading list with a table of books and links to related notes.”
Install prompt: paste this into Hermes Agent
I downloaded the agent skill "Obsidian Skills" as obsidian-skills.zip. Unzip it and copy the folders inside 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 folders inside 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 note for my reading list with a table of books and links to related notes.”
Install prompt: paste this into VS Code
I downloaded the agent skill "Obsidian Skills" as obsidian-skills.zip. Unzip it and copy the folders inside 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 Skills
How is this different from Obsidian Markdown?
Obsidian Markdown is one member of this pack. The pack adds five more skills.
Licence?
MIT, by Steph Ango. The pack also lists a sixth skill, knap, which renders Markdown from templates and data.
Is the Obsidian Skills 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 Skills skill?
Steph Ango (kepano). 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)).
