SkillGild
Productivity

Obsidian Skills

Official skills from Obsidian's CEO that teach agents to work correctly with a vault: Obsidian-flavoured Markdown (wikilinks, embeds, callouts, properties), Bases (views, filters, formulas), JSON Canvas files, the Obsidian CLI, defuddle for clean web-to-markdown extraction, and knap for templated note generation.

skillgild install obsidian-skills
Works with
  • Claude Code
  • Codex
  • Cursor
  • Gemini CLI
and any MCP client

License: MIT · Created by Steph Ango (kepano)

Free

What you get

  • Official skills from Obsidian's CEO that teach agents to work correctly with a vault: Obsidian-flavoured Markdown (wikilinks, embeds, callouts, properties), Bases (views, filters, formulas), JSON Canvas files, the Obsidian CLI, defuddle for clean web-to-markdown extraction, and knap for templated note generation.
  • Without them an agent breaks wikilinks and canvas JSON.

Requirements

  • An Obsidian vault on disk

Install the Obsidian Skills skill

Pick your agent. The wrapper only tells your agent how to start a session. The skill's instructions arrive with each session, after your access is checked.

  1. Sign in once from your terminal.

    Terminal
    skillgild login
  2. Install this skill for Claude Code.

    Terminal
    skillgild install obsidian-skills --agent claude-code
  3. Register the SkillGild MCP server with Claude Code.

    Terminal
    claude mcp add --scope user skillgild -- $(command -v skillgild) mcp

How it runs

  1. Your agent starts a session. SkillGild checks your access and allowance, counts one run, and sends the skill's instructions for this task.
  2. Your agent does the work with its own model and tools, in your project. SkillGild makes no AI model call.

Use it from code

Start a session, follow its guide, then end it. Create an API key under Account and pass it as a bearer token.

Terminal
# Prints the session ID, its tools and the instructions for your agent
skillgild session obsidian-skills
skillgild end <session-id>

Questions

How do I install Obsidian Skills in Claude Code?

Run skillgild install obsidian-skills --agent claude-code and connect the SkillGild MCP server (skillgild mcp). When a task matches, your agent starts a session, which uses one of your 25 free runs this month, and follows the skill's instructions. Use --agent codex, cursor or gemini-cli for other clients.

Is Obsidian Skills free?

Yes. It includes 25 free runs every month on SkillGild. Obsidian Skills is open source (MIT) by Steph Ango (kepano); SkillGild packages it from https://github.com/kepano/obsidian-skills at a pinned commit and credits the author.

Does Obsidian Skills run on SkillGild?

It runs in your coding agent with your own model. SkillGild checks your monthly allowance and delivers the skill's instructions for each session; it makes no model call and never sees your project unless your agent sends it.

Which agents does Obsidian Skills work with?

The project lists Claude Code, Codex, OpenCode and other Agent Skills hosts. It is a plain Agent Skills folder (SKILL.md plus supporting files), so any client that reads that format can load it.

Related guides

Setup steps and worked examples for this kind of skill.