New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Obsidian CLI

by Atmosphere in Atmosphere/atmosphere

Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more.

Apache-2.0Auto-check passedKnowledge Management

Install Obsidian CLI

skills CLI
$ npx skills add Atmosphere/atmosphere --skill obsidian-cli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Atmosphere/atmosphere obsidian-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Atmosphere/atmosphere.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/obsidian-cli .claude/skills/obsidian-cli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
obsidian-cli
GitHub stars
3.8k
Used in
13 other repos
Token cost
~795 tokens
SKILL.md length
237 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
Apache-2.0

At a glance

Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more.

  • Works in 4 steps: Reload the plugin to pick up changes → Check for errors — if errors appear, fix… → Verify visually with a screenshot or DOM… → …
  • The user asks to interact with their Obsidian vault
  • SKILL.md covers Command reference, Syntax, File targeting and Vault targeting, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Obsidian CLI is an agent skill from Atmosphere/atmosphere. Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more. Also supports plugin and theme development with commands to reload plugins, run JavaScript, capture errors, take screenshots, and inspect the DOM. Use when the user asks to interact with their Obsidian vault, manage notes, search vault content, perform vault operations from the command line, or develop and debug Obsidian plugins and themes.

Its SKILL.md is about 800 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Knowledge Management. It works with Obsidian and JavaScript. The repository describes itself as: Portable AI agent runtime for the JVM. One @Agent class runs on Spring AI, LangChain4j, Anthropic, or 9 more behind one SPI. Token streaming, tool calls, human approvals, and… The licence is Apache-2.0.

When your agent uses it

  • The user asks to interact with their Obsidian vault
  • Search vault content
  • Perform vault operations from the command line
  • Develop and debug Obsidian plugins and themes

Example prompts

  • “/obsidian-cli”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Reload the plugin to pick up changes
  2. Check for errors — if errors appear, fix and repeat from step 1
  3. Verify visually with a screenshot or DOM inspection
  4. Check console output for warnings or unexpected logs

What it can do on your machine

Read from SKILL.md and the folder at commit 13671cf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • help.obsidian.md

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Obsidian CLI loads about 795 tokens when it runs. Until then it costs about 120 tokens; SKILL.md has 237 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~120
When it runs · the whole SKILL.md, loaded when a task matches
~795

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Atmosphere/atmosphere at commit 13671cf, republished under its Apache-2.0 licence (© Atmosphere). 237 words, ~795 tokens.

Download SKILL.mdSave it as .claude/skills/obsidian-cli/SKILL.md (or your agent's skills folder).
name
obsidian-cli
description
Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more. Also supports plugin and theme development with commands to reload plugins, run JavaScript, capture errors, take screenshots, and inspect the DOM. Use when the user asks to interact with their Obsidian vault, manage notes, search vault content, perform vault operations from the command line, or develop and debug Obsidian plugins and themes.

Obsidian CLI

Use the obsidian CLI to interact with a running Obsidian instance. Requires Obsidian to be open.

Command reference

Run obsidian help to see all available commands. This is always up to date. Full docs: https://help.obsidian.md/cli

Syntax

Parameters take a value with =. Quote values with spaces:

bash
obsidian create name="My Note" content="Hello world"

Flags are boolean switches with no value:

bash
obsidian create name="My Note" silent overwrite

For multiline content use \n for newline and \t for tab.

File targeting

Many commands accept file or path to target a file. Without either, the active file is used.

  • file=<name> — resolves like a wikilink (name only, no path or extension needed)
  • path=<path> — exact path from vault root, e.g. folder/note.md

Vault targeting

Commands target the most recently focused vault by default. Use vault=<name> as the first parameter to target a specific vault:

bash
obsidian vault="My Vault" search query="test"

Common patterns

bash
obsidian read file="My Note"
obsidian create name="New Note" content="# Hello" template="Template" silent
obsidian append file="My Note" content="New line"
obsidian search query="search term" limit=10
obsidian daily:read
obsidian daily:append content="- [ ] New task"
obsidian property:set name="status" value="done" file="My Note"
obsidian tasks daily todo
obsidian tags sort=count counts
obsidian backlinks file="My Note"

Use --copy on any command to copy output to clipboard. Use silent to prevent files from opening. Use total on list commands to get a count.

Plugin development

Develop/test cycle

After making code changes to a plugin or theme, follow this workflow:

  1. Reload the plugin to pick up changes:
    bash
    obsidian plugin:reload id=my-plugin
  2. Check for errors — if errors appear, fix and repeat from step 1:
    bash
    obsidian dev:errors
  3. Verify visually with a screenshot or DOM inspection:
    bash
    obsidian dev:screenshot path=screenshot.png
obsidian dev:dom selector=".workspace-leaf" text
  4. Check console output for warnings or unexpected logs:
    bash
    obsidian dev:console level=error
Additional developer commands

Run JavaScript in the app context:

bash
obsidian eval code="app.vault.getFiles().length"

Inspect CSS values:

bash
obsidian dev:css selector=".workspace-leaf" prop=background-color

Toggle mobile emulation:

bash
obsidian dev:mobile on

Run obsidian help to see additional developer commands including CDP and debugger controls.

© Atmosphere, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/obsidian-cli of Atmosphere/atmosphere.

Open the folder on GitHubat commit 13671cf

Used in 13 other repositories

We found 16 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 13 other GitHub owners. This page covers the copy in Atmosphere/atmosphere, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Obsidian CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Obsidian CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Obsidian CLI this skillAtmosphere/atmosphere3.8k13 repos~795Automated safety check: PassApache-2.0
Confluence To Markdowniurykrieger/claude-bedrock1051 repos~2.8kAutomated safety check: NotesMIT
Anytype Importpricklywiggles/niamos192—~3.3kAutomated safety check: PassNone
Self LearnPratiyush/llm-wiki395—~1.6kAutomated safety check: PassMIT
Obsidian Project Memorybrycewang-stanford/Auto-Empirical-Research-Skills4.5k—~2.4kAutomated safety check: PassCustom licence
AI BrainOotto-AI/claude-content-skills101—~1.1kAutomated safety check: PassMIT

Similar skills

  • Confluence To Markdown

    iurykrieger/claude-bedrock

    Internal fetcher module for Confluence pages. An agent skill from iurykrieger/claude-bedrock.

    105 GitHub starsUsed in 1 repo~2.8k tokens
    Knowledge ManagementAuto-check: notes

  • Anytype Import

    pricklywiggles/niamos

    Import a page from the user's self-hosted Anytype into this Niamos Obsidian vault, page-by-page, recursing into children only when the user explicitly says so.

    192 GitHub stars~3.3k tokensUpdated 3 mo ago
    Knowledge ManagementAuto-check passed

  • Self Learn

    Pratiyush/llm-wiki

    Extract reusable patterns from recent sessions, propose framework improvements, and (with approval) update the framework docs.

    395 GitHub stars~1.6k tokensUpdated 3 mo ago
    Knowledge ManagementAuto-check passed

  • Obsidian Project Memory

    brycewang-stanford/Auto-Empirical-Research-Skills

    This skill should be used when the user asks to maintain an Obsidian knowledge base for a research project, import an existing research repository into Obsidian, keep project memory or daily notes…

    4.5k GitHub stars~2.4k tokensUpdated 2 days ago
    Knowledge ManagementAuto-check passed

  • AI Brain

    Ootto-AI/claude-content-skills

    Give Claude a permanent, searchable long-term memory using an Obsidian vault as the store.

    101 GitHub stars~1.1k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed

  • Brain

    poteto/noodle

    Read/write brain files (Obsidian vault at brain/). An agent skill from poteto/noodle.

    420 GitHub stars~860 tokensUpdated 6 mo ago
    Knowledge ManagementAuto-check passed

More from Atmosphere/atmosphere

All 20 skills in this repo

  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k tokens
    Auto-check passed

  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Auto-check passed

  • Release Sample Sweep

    Atmosphere/atmosphere

    Run the pre-release end-to-end sweep of every user-facing surface — the 33 samples under samples/ (booted from their packaged artifacts and driven in a real browser via chrome-devtools MCP), the…

    3.8k GitHub stars~4.2k tokensUpdated yesterday
    Auto-check passed

  • Obsidian Writer

    Atmosphere/atmosphere

    Write well-formatted notes to the atmosphere-vault Obsidian knowledge base.

    3.8k GitHub stars~2.6k tokensUpdated yesterday
    Auto-check passed

  • Carnet

    Atmosphere/atmosphere

    Work the private register (Atmosphere/atmosphere-carnet) from a session — claim an issue before touching it so peers see who holds it and which session, release or close it when done, file new…

    3.8k GitHub stars~4k tokensUpdated yesterday
    Auto-check passed

  • Obsidian Vault Setup

    Atmosphere/atmosphere

    A skill your agent uses when setting up the shared atmosphere-vault Obsidian vault on a new machine or for a new team member.

    3.8k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Obsidian CLI

What does Obsidian CLI do?

Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more. Obsidian CLI is an agent skill from Atmosphere/atmosphere. Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more.

When should I use Obsidian CLI?

Obsidian CLI fits situations like: the user asks to interact with their Obsidian vault; search vault content; perform vault operations from the command line; develop and debug Obsidian plugins and themes.

How do I install Obsidian CLI in Claude Code?

Run `npx skills add Atmosphere/atmosphere --skill obsidian-cli -a claude-code`. Or copy the skill folder (.claude/skills/obsidian-cli in Atmosphere/atmosphere) into .claude/skills/obsidian-cli in your project. Claude Code loads it when a task matches its description.

How do I install Obsidian CLI in Codex?

Run `npx skills add Atmosphere/atmosphere --skill obsidian-cli -a codex`. Or copy the skill folder (.claude/skills/obsidian-cli in Atmosphere/atmosphere) into .agents/skills/obsidian-cli in your project. Codex loads it when a task matches its description.

Can I use Obsidian CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Atmosphere/atmosphere --skill obsidian-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/obsidian-cli, .gemini/skills/obsidian-cli, .github/skills/obsidian-cli and .opencode/skills/obsidian-cli in your project.

What does Obsidian CLI need to run?

SKILL.md names no scripts, command-line tools or credentials: Obsidian CLI is instructions for the agent only.

Does Obsidian CLI access the network?

SKILL.md names 1 domain. As links in the text: help.obsidian.md. This is read from the text; nothing was executed.

Is Obsidian CLI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Obsidian CLI use?

Obsidian CLI is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Obsidian CLI use?

About 795 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Obsidian CLI?

Skills that share tags, products or a category with Obsidian CLI: Confluence To Markdown (iurykrieger/claude-bedrock, 105 stars), Anytype Import (pricklywiggles/niamos, 192 stars), Self Learn (Pratiyush/llm-wiki, 395 stars) and Obsidian Project Memory (brycewang-stanford/Auto-Empirical-Research-Skills, 4.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Obsidian CLI?

Atmosphere (a GitHub organization) maintains it in Atmosphere/atmosphere, which has 3,819 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 6, 2026.

Source: Atmosphere/atmosphere on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.