Reusable AI agent skills for Obsidian and Markdown workflows with Claude Code, Gemini CLI, and other AI assistants.
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.
| Skill | Description |
|---|---|
| ai4pkm-helper | AI4PKM helper for onboarding guidance, quick help, and seamless handoff to DDA for daily use |
| gobi-onboarding | Gobi Desktop 3.0 voice-based onboarding guide with 4-step flow |
| 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) |
| 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 |
| 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 |
| Skill | Description |
|---|---|
| gemini-image-skill | Generate AI images using Google Gemini API with multiple models and aspect ratios |
- 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.
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.
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 --remoteBenefits:
- 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-repoSome 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 |
# 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"Use the obsidian-links skill to check and fix broken wiki links in my vault
Use obsidian-yaml-frontmatter to ensure consistent properties across my notes
Use obsidian-mermaid to create a flowchart for this process
Use obsidian-canvas to create a knowledge map for this topic
Use markdown-slides to convert this document into a Deckset presentation
Use markdown-video to create a narrated video from my slides
Use video-cleaning to remove silent pauses from this video
Each skill follows a consistent structure:
skill-name/
├── SKILL.md # Main skill definition and documentation
├── reference/ # Reference materials (optional)
└── examples/ # Usage examples (optional)
The SKILL.md file contains:
- Skill metadata (name, description, allowed tools)
- When to use the skill
- Core rules and guidelines
- Step-by-step workflows
- Quality checklists
We welcome contributions! Here's how you can help:
- Report bugs - Open an issue describing the problem
- Suggest improvements - Share ideas for enhancing existing skills
- Add new skills - Create skills for other PKM workflows
- Improve documentation - Help clarify usage and examples
- Create a folder in the repo root with your skill name
- Add a
SKILL.mdwith:- Frontmatter (name, description, allowed-tools, license)
- Clear "When to Use" section
- Step-by-step process documentation
- Quality checklist
- Test the skill with Claude Code or your preferred assistant
- Submit a pull request
- AI4PKM - Full PKM automation framework
- AI4PKM Docs - Documentation and guides
- Discord Community - Join the discussion
These skills are part of the AI4PKM framework for AI-powered personal knowledge management. For the complete automation system including workflows, templates, and integrations, check out the main project.
MIT License - see LICENSE for details.
Made with AI assistance for AI assistance.