Where to Find the Obsidian Markdown Skill Definition in the Repository

The Obsidian Markdown skill definition is located at skills/obsidian-markdown/SKILL.md in the kepano/obsidian-skills repository.

The kepano/obsidian-skills repository hosts structured skill definitions for enhancing Obsidian workflows. When you need to locate the Obsidian Markdown skill definition, you will find the primary manifest and usage documentation at a specific path within the codebase, accompanied by detailed reference materials.

Primary Skill Definition File

The canonical source for the Obsidian Markdown skill is the skills/obsidian-markdown/SKILL.md file. This markdown document serves as the skill manifest, containing YAML frontmatter metadata followed by comprehensive usage instructions for Obsidian Flavored Markdown syntax.

Skill Manifest Structure

The file opens with metadata defining the skill identity:

---
name: obsidian-markdown
description: Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian‑specific syntax.
---

The remainder of the document provides detailed guidance on implementing Obsidian-specific features like wikilinks, embeds, and frontmatter properties.

Supporting Reference Documentation

The skill definition references additional documentation stored in the skills/obsidian-markdown/references/ subdirectory. These files modularize specific feature documentation for easier maintenance and reference.

• references/PROPERTIES.md — Documents front-matter properties and YAML metadata supported by Obsidian
• references/EMBEDS.md — Covers embed syntax for images, PDFs, notes, and other transclusion methods
• references/CALLOUTS.md — Lists available callout types, icons, and customization options

Using the Skill Definition in Workflows

Developers can reference this skill definition in automation workflows such as Instagit to generate or manipulate Obsidian content programmatically.

Instagit Prompt Example

To invoke the skill within an Instagit workflow, reference the skill identifier in your prompt:

%instagit run obsidian-markdown
Create a new note titled **Project Overview** with the following front‑matter:

---
title: Project Overview
date: 2024-04-01
tags:
  - project
  - overview
aliases:
  - Overview Note
---

Add a wikilink to the note `[[Roadmap]]` and embed an image `![[diagram.png|400]]`.

Linking to Reference Files

When extending documentation or creating derivative templates, link to specific reference files using relative paths:

For a complete list of supported properties, see the reference file:
[PROPERTIES.md](references/PROPERTIES.md)

Summary

• The Obsidian Markdown skill definition resides at skills/obsidian-markdown/SKILL.md in the kepano/obsidian-skills repository.
• The file contains YAML frontmatter metadata identifying the skill as obsidian-markdown and describing its purpose.
• Supporting reference materials live in skills/obsidian-markdown/references/ covering properties, embeds, and callouts.
• The skill can be invoked in automation workflows using the identifier obsidian-markdown.

Frequently Asked Questions

What is the exact file path for the Obsidian Markdown skill definition?

The skill definition is located at skills/obsidian-markdown/SKILL.md relative to the repository root. This file serves as the primary manifest containing both metadata and usage documentation for Obsidian Flavored Markdown.

What reference files accompany the Obsidian Markdown skill?

The skill includes three main reference files in the references/ subdirectory: PROPERTIES.md for front-matter documentation, EMBEDS.md for transclusion syntax, and CALLOUTS.md for callout formatting options.

How do I use the Obsidian Markdown skill in an Instagit workflow?

Reference the skill by name in your prompt using the syntax %instagit run obsidian-markdown followed by your specific instructions. The workflow will apply the patterns defined in SKILL.md to generate or edit content.

Does the skill definition include syntax examples?

Yes, the SKILL.md file provides usage guides and links to dedicated reference files that contain detailed syntax examples for wikilinks, embeds, callouts, and YAML frontmatter properties according to the repository structure.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}