Claude Obsidian Skills

Reusable AI agent skills for Obsidian and Markdown workflows with Claude Code, Gemini CLI, and other AI assistants.

Overview

Claude Obsidian Skills is a collection of AI agent skills designed to automate personal knowledge management (PKM) workflows. These skills work with Claude Code, Gemini CLI, and other AI assistants that support skill-based extensions.

Available Skills

PKM Management Skills

Skill	Description
ai4pkm-helper	AI4PKM helper for onboarding guidance, quick help, and seamless handoff to DDA for daily use

Obsidian Skills

Skill	Description
obsidian-canvas	Create and manage Obsidian Canvas files with automatic layout generation for knowledge maps and visual summaries
obsidian-links	Format, validate, and fix wiki links with proper filename, section, and folder conventions
obsidian-yaml-frontmatter	Standardize YAML frontmatter properties with consistent formatting and naming
obsidian-markdown-structure	Validate and enforce markdown document structure, heading hierarchy, and organization
obsidian-mermaid	Create Obsidian-compatible Mermaid diagrams avoiding common errors (markdown in labels, wide layouts)

Markdown Skills

Skill	Description
markdown-slides	Create Deckset/Marp compatible presentation slides from markdown content
interactive-writing-assistant	AI-powered writing companion with outline-prose co-evolution and PKM integration

Video Skills

Skill	Description
markdown-video	Convert markdown slides to MP4 video with TTS narration (with or without Deckset)
video-cleaning	Remove silent pauses from videos using AI-powered transcription and FFmpeg

Image Skills

Skill	Description
gemini-image-skill	Generate AI images using Google Gemini API with multiple models and aspect ratios

Installation

For Claude Code

Clone this repository or copy the skill folders:

git clone https://github.com/jykim/claude-obsidian-skills.git

Copy skills to your Claude Code skills directory:

cp -r claude-obsidian-skills/*-* ~/.claude/skills/

Claude Code will automatically detect and use the skills.

For Other AI Assistants

Copy the SKILL.md file from the desired skill folder to your assistant's skill directory. Each skill is self-contained and documented within its SKILL.md file.

Advanced: Git Submodule Integration

For vault maintainers who want to keep skills in sync with this repository while avoiding duplication:

Add as a submodule to your vault:

git submodule add https://github.com/jykim/claude-obsidian-skills.git path/to/skills/public-skills

Create symlinks for backward compatibility:

cd path/to/skills
ln -s public-skills/obsidian-canvas obsidian-canvas
ln -s public-skills/obsidian-links obsidian-links
ln -s public-skills/obsidian-yaml-frontmatter obsidian-yaml-frontmatter
ln -s public-skills/obsidian-markdown-structure obsidian-markdown-structure
ln -s public-skills/obsidian-mermaid obsidian-mermaid
ln -s public-skills/markdown-slides markdown-slides
ln -s public-skills/markdown-video markdown-video
ln -s public-skills/interactive-writing-assistant interactive-writing-assistant
ln -s public-skills/video-cleaning video-cleaning

Update skills when new versions are released:

git submodule update --remote

Benefits:

Single source of truth - edit in one place
Version control - pin to specific commits if needed
Easy updates via git submodule commands

Note: When cloning a vault with submodules, use --recursive:

git clone --recursive your-vault-repo

Requirements

Some skills require external dependencies. Install them before using:

Skill	Requirements
markdown-video	FFmpeg, OpenAI API key, Python 3.7+, Pillow
video-cleaning	FFmpeg, OpenAI API key, Python 3.7+
gemini-image-skill	Gemini API key, Python 3.7+, google-genai, Pillow
markdown-slides	None (markdown only)
obsidian-*	None (file operations only)
interactive-writing-assistant	None

Common Installation Commands

# FFmpeg (macOS)
brew install ffmpeg

# Python dependencies
pip install Pillow openai google-genai

# Set API keys
export OPENAI_API_KEY="sk-..."
export GEMINI_API_KEY="your-gemini-api-key"

Quick Start

Validate Wiki Links

Use the obsidian-links skill to check and fix broken wiki links in my vault

Standardize Frontmatter

...

jykim/claude-obsidian-skills

README