How do I install the Obsidian Markdown Mastery skill?

Run npx skillmds@latest add aibot88/obsidian-markdown-mastery in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Obsidian Markdown Mastery safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Obsidian Markdown Mastery?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Obsidian Markdown Mastery free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Obsidian Markdown Mastery?

aibot88 (@aibot88) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Obsidian Markdown Mastery by aibot88

Name: Obsidian Markdown Mastery
Rating: 4.2 (5 reviews)
Author: aibot88

Obsidian Markdown Mastery

Core markdown syntax skill for Obsidian. Enforces strict parsing and authoring of Obsidian proprietary syntax (Wikilinks, Blocks, Headings, Aliases, Embeds, Callouts). Use when reading, writing, or validating Obsidian-flavored markdown.

aibot88 Updated Sep 9, 2026 3 repo stars

File contents

Dependencies

This skill requires Python 3.8+ and standard library only. No external packages needed.

To install this skill's dependencies:

pip-compile ./requirements.in
pip install -r ./requirements.txt

See ./requirements.txt for the dependency lockfile (currently empty — standard library only).

Obsidian Markdown Mastery (Protocol 129 COMPLIANT)

Status: Active Author: Obsidian Integration Plugin Domain: Obsidian Integration

Core Mandate

The obsidian-markdown-mastery skill is responsible for the exact formatting, extraction, and validation of Obsidian-flavoured Markdown. It provides the low-level string manipulation that allows higher-order agents (like the Graph Traverser or JSON Canvas Architect) to safely interpret relational links without breaking the .md Vault.

CRITICAL ARCHITECTURAL RULE: All vault data manipulation MUST occur through deterministic Python scripts rather than agent-prompted regex. This skill defines the obsidian-parser module that performs these deterministic actions.

Agnosticism Enforcement: This module knows NOTHING about project-specific protocols, persistence layers, or external services. It only knows how to parse text into valid Obsidian links and block-quotes. Project-specific configuration (vault paths, injection points) is managed via the OBSIDIAN_VAULT_PATH environment variable.

Available Commands

Analyze Markdown Content

Extracts all Obsidian-specific metadata (links, embeds, blocks) from a given markdown file or string. Command: python ./parser.py analyze --file <path_to_md>

Inject Callout

Wraps a target text block in an Obsidian-flavored callout. Command: python ./parser.py callout --type <type> --title <title> --text <content>

The Parsed Syntax (Data Dictionary)

When manipulating strings via this module, the following formats are enforced:

1. Linking and Aliasing

Standard Link: [[Note Name]]
Heading Link: [[Note Name#Heading Name]]
Block Link: [[Note Name#^block-id]]
Aliased Link: [[Note Name|Display Text]]

2. Transclusion (Embeds)

Standard Embed: ![[Note Name]] (Note the leading !)
(The parser specifically categorizes these differently so graph mappers know they are transclusions, not semantic links).

3. Callouts

Syntax:

> [!type] Title
> Content block goes here.

Supported Types: info, warning, error, success, note.

Configuration Environment Variable

Other tools (such as protocol-manager and chronicle-manager) rely on the unified OBSIDIAN_VAULT_PATH environment variable to discover where the root of the Obsidian Vault resides. If missing, it defaults to the project root.

---name: obsidian-markdown-masterydescription: Core markdown syntax skill for Obsidian. Enforces strict parsing and authoring of Obsidian proprietary syntax (Wikilinks, Blocks, Headings, Aliases, Embeds, Callouts). Use when reading, writing, or validating Obsidian-flavored markdown.--- ## Dependencies This skill requires **Python 3.8+** and standard library only. No external packages needed. **To install this skill's dependencies:** ```bash pip-compile ./requirements.in pip install -r ./requirements.txt ``` See `./requirements.txt` for the dependency lockfile (currently empty — standard library only). --- # Obsidian Markdown Mastery (Protocol 129 COMPLIANT) **Status:** Active **Author:** Obsidian Integration Plugin **Domain:** Obsidian Integration ## Core Mandate The `obsidian-markdown-mastery` skill is responsible for the exact formatting, extraction, and validation of Obsidian-flavoured Markdown. It provides the low-level string manipulation that allows higher-order agents (like the Graph Traverser or JSON Canvas Architect) to safely interpret relational links without breaking the `.md` Vault. > **CRITICAL ARCHITECTURAL RULE:** > All vault data manipulation MUST occur through deterministic Python scripts rather than agent-prompted regex. This skill defines the `obsidian-parser` module that performs these deterministic actions. > > *Agnosticism Enforcement*: This module knows NOTHING about project-specific protocols, persistence layers, or external services. It only knows how to parse text into valid Obsidian links and block-quotes. Project-specific configuration (vault paths, injection points) is managed via the `OBSIDIAN_VAULT_PATH` environment variable. ## Available Commands ### Analyze Markdown Content Extracts all Obsidian-specific metadata (links, embeds, blocks) from a given markdown file or string. **Command**: `python ./parser.py analyze --file <path_to_md>` ### Inject Callout Wraps a target text block in an Obsidian-flavored callout. **Command**: `python ./parser.py callout --type <type> --title <title> --text <content>` ## The Parsed Syntax (Data Dictionary) When manipulating strings via this module, the following formats are enforced: ### 1. Linking and Aliasing * **Standard Link**: `[[Note Name]]` * **Heading Link**: `[[Note Name#Heading Name]]` * **Block Link**: `[[Note Name#^block-id]]` * **Aliased Link**: `[[Note Name|Display Text]]` ### 2. Transclusion (Embeds) * **Standard Embed**: `![[Note Name]]` (Note the leading `!`) * *(The parser specifically categorizes these differently so graph mappers know they are transclusions, not semantic links).* ### 3. Callouts * **Syntax**: ```markdown > [!type] Title > Content block goes here. ``` * **Supported Types**: `info`, `warning`, `error`, `success`, `note`. ## Configuration Environment Variable Other tools (such as `protocol-manager` and `chronicle-manager`) rely on the unified `OBSIDIAN_VAULT_PATH` environment variable to discover where the root of the Obsidian Vault resides. If missing, it defaults to the project root.

Frequently asked questions