Agent Skills for use with Obsidian. These skills follow the [Agent Skills specification](https://agentskills.io/specification) so they can be used by any skills-compatible agent, including Claude Code, Codex, and Open Code. ## Installation Obsidian is an official plugin for: - [ChatGPT and Codex](https://chatgpt.com/plugins/plugins_6aee4fde227881919d61b034b1c31096) - [Cursor](https://cursor.com/marketplace/obsidian) - [Grok Bot](https://x.ai/bot/plugin/88871845) ### Claude Code marketplace From terminal: ```sh claude plugin marketplace add obsidianmd/obsidian-skills claude plugin install obsidian@obsidian-skills ``` From within a Claude Code session: ```sh /plugin marketplace add obsidianmd/obsidian-skills /plugin install obsidian@obsidian-skills ``` To get new skills later, run `claude plugin update obsidian@obsidian-skills`. ### Codex marketplace To install from this repo instead of the [ChatGPT plugin directory](https://chatgpt.com/plugins/plugins_6aee4fde227881919d61b034b1c31096): ```sh codex plugin marketplace add obsidianmd/obsidian-skills ``` Then install Obsidian from the plugin directory in Codex or the ChatGPT desktop app. ### npx skills ```sh npx skills add https://github.com/obsidianmd/obsidian-skills ``` To use ssh instead, if you have a GitHub SSH key set up: ```sh npx skills add git@github.com:obsidianmd/obsidian-skills.git ``` ### Gemini CLI ```sh gemini extensions install https://github.com/obsidianmd/obsidian-skills ``` ### Manually #### Claude Code Copy the `plugins/obsidian/skills/` directory to `.claude/skills/` in the root of your Obsidian vault (or whichever folder you're using with Claude Code). See more in the [official Claude Skills documentation](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview). #### Codex Copy the `plugins/obsidian/skills/` directory into your Codex skills path (typically `~/.agents/skills`). See the [Agent Skills specification](https://agentskills.io/specification) for the standard skill format. #### OpenCode Clone the entire repo into the OpenCode skills directory (`~/.opencode/skills/`): ```sh git clone https://github.com/obsidianmd/obsidian-skills.git ~/.opencode/skills/obsidian-skills ``` Do not copy only the inner `skills/` folder — clone the full repo so the directory structure is `~/.opencode/skills/obsidian-skills/plugins/obsidian/skills//SKILL.md`. OpenCode auto-discovers all `SKILL.md` files under `~/.opencode/skills/`. No changes to `opencode.json` or any config file are needed. Skills become available after restarting OpenCode. ## Release maintenance Update the plugin version in every manifest with: ```sh ./scripts/bump.sh patch ``` The script also accepts `major`, `minor`, or an explicit version like `1.1.0`. Gemini CLI installs from the latest GitHub release, so publish a release for each version, tagged with the version number. The `Gemini release archive` workflow then attaches `obsidian-gemini.tar.gz`, which has real copies of the skills. Don't attach other files to a release, because Gemini CLI only picks a file when there's exactly one; otherwise it falls back to the source archive, which has no Gemini manifest. To build the archive locally, run `./scripts/package-gemini.sh`. ## Skills | Skill | Description | | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | [obsidian-markdown](plugins/obsidian/skills/obsidian-markdown) | Create and edit [Obsidian Flavored Markdown](https://help.obsidian.md/obsidian-flavored-markdown) (`.md`) with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax | | [obsidian-bases](plugins/obsidian/skills/obsidian-bases) | Create and edit [Obsidian Bases](https://help.obsidian.md/bases/syntax) (`.base`) with views, filters, formulas, and summaries | | [json-canvas](plugins/obsidian/skills/json-canvas) | Create and edit [JSON Canvas](https://jsoncanvas.org/) files (`.canvas`) with nodes, edges, groups, and connections | | [obsidian-cli](plugins/obsidian/skills/obsidian-cli) | Interact with Obsidian vaults via the [Obsidian CLI](https://help.obsidian.md/cli) including plugin and theme development | | [obsidian-headless](plugins/obsidian/skills/obsidian-headless) | Sync and publish vaults from the command line with [Obsidian Headless](https://help.obsidian.md/headless), without the desktop app | | [defuddle](plugins/obsidian/skills/defuddle) | Extract clean markdown from web pages using [Defuddle](https://github.com/kepano/defuddle), removing clutter to save tokens | | [knap](plugins/obsidian/skills/knap) | Render Markdown templates from JSON or CSV data using [Knap](https://github.com/obsidianmd/knap), including batch file generation |