obsidian-markdown

An agent skill by kepano, from kepano/obsidian-skills. Tags: copy-editing, documents, local-workflow.

What it does

Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.

Install

With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:

npx skills add kepano/obsidian-skills --skill obsidian-markdown

Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):

git clone --depth 1 https://github.com/kepano/obsidian-skills
cp -r obsidian-skills/skills/obsidian-markdown ~/.claude/skills/obsidian-markdown

Safety box score

Grade A, minimal risk: 4 of 100 risk points, rated 2026-10-20. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.

This skill is plain-text documentation for creating and editing Obsidian Flavored Markdown notes. It does not ship code or automation; the main effect is scoped writes to note files in the vault, plus support for Obsidian features like embeds, callouts, and hidden comments in rendered view.

Category levels, from 0 (none) to 3 (high)
Category	Level	Why
Code & shell execution	0 (none)	The shipped files are only markdown docs; there are no shell commands, scripts, or code-evaluation steps.
Network access	0 (none)	It only links to Obsidian help pages and describes local note embeds; it does not instruct downloads, API calls, or remote posting.
Filesystem reach	1 (low)	The workflow is explicitly about creating and editing `.md` notes and frontmatter inside the vault (`Create and edit valid Obsidian Flavored Markdown`, `Add frontmatter... at the top of the file`).
Secrets & credentials	0 (none)	No tokens, passwords, `.env` files, keychains, browser sessions, or logins are mentioned.
Privilege & persistence	0 (none)	There is no sudo, service registration, shell/profile editing, or OS setting change.
Instruction hijack surface	0 (none)	The text contains no instructions to ignore higher-priority rules or follow remote instructions; it is syntax guidance only.
Irreversible actions	0 (none)	The skill does not push, publish, send messages, pay, book, merge, or delete anything.
Transparency	0 (none)	All included files are readable markdown; there are no binaries, generated code, or opaque installers.

Before installing

Confirm the repo still contains only markdown docs and no scripts or installers.
If you will use `![[...]]`, callouts, or frontmatter, test them once in a scratch Obsidian note first.

Rated 2026-10-20 by an automated review of 4 files from the skill's repository.

Source

Repository: kepano/obsidian-skills (all skills from this repository)
Path: skills/obsidian-markdown/SKILL.md
Branch: main
Updated: 2026-09-19

caveman — Terse caveman voice: answer first, fluff gone, every technical fact kept. Use for /caveman, "caveman mode", "talk like caveman", "be brief", "less tokens".
caveman-compress — Compress a memory file such as CLAUDE.md or a todo list into caveman format to save input tokens, keeping a readable backup. Trigger: /caveman-compress.
google-docs — Author and edit Google Docs with the google-docs tools - structured writing, character and paragraph styling, lists, tables, images, headers/footers.
megacave — Caveman in Classical Chinese: 文言文 register, far fewer characters, technical terms verbatim. Invoke only with /megacave or /caveman wenyan.
ultracave — Caveman at maximum compression: fragments, one word when one word is enough, each fact once. Invoke only with /ultracave or /caveman ultra.
defuddle — Extract clean Markdown from HTML pages with Defuddle CLI.