One-click install
npx skills add https://github.com/zhongjjm-design/claude-skills --skill disk-to-obsidian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: disk-to-obsidian
Source: https://github.com/zhongjjm-design/claude-skills/tree/main/disk-to-obsidian
Command: npx skills add https://github.com/zhongjjm-design/claude-skills --skill disk-to-obsidian

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mammoth, and includes scripts (resource) components.

What problem does it solve?

Users with large collections of Microsoft Word documents stored on external hard drives face tedious manual work when migrating these files to Obsidian, as they need to individually copy files and manually convert .docx formats to Markdown, which is time-consuming and error-prone for large file volumes.

Core Features & Use Cases

  • Automatic Drive Detection: Identifies mounted external hard drives on macOS without requiring manual path input, and confirms the target drive with the user before proceeding.
  • Batch Format Conversion: Converts all .docx files in a selected folder to Markdown in one go, preserving core formatting including headings, lists, bold/italic text, and links.
  • Source-Tracked Organization: Saves imported files to a dedicated subfolder named after the original drive folder, making it easy to trace the origin of each document.
  • Use Case: If you have 300+ research notes stored as Word files on a portable drive, use this skill to import and convert the entire folder to Obsidian in minutes, with a clear report of successful and failed conversions.

Quick Start

Use the disk-to-obsidian skill to import all Word documents from your connected external drive's "Research Notes 2024" folder to your Obsidian vault's "Academic Work" folder.

Frequently Asked Questions about disk-to-obsidian

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I batch convert Word documents from an external drive to Obsidian Markdown?

Batch convert Word documents from an external drive to Obsidian Markdown by automatically detecting mounted drives and processing all .docx files in a selected folder. This preserves headings, lists, and text styling while saving files to source-tracked subfolders.

Does mammoth preserve formatting when converting docx to Markdown?

Mammoth preserves core formatting when converting docx to Markdown, retaining structural elements like headings, lists, bold and italic text, and links. It parses .docx binary content to ensure core document structures remain intact during the migration process.

Can I migrate 300+ Word files from a portable drive to macOS Obsidian without manual processing?

You can migrate 300+ Word files from a portable drive to macOS Obsidian without manual per-file processing. The tool confirms the target drive and batch converts the entire folder automatically, providing a clear report of successful and failed conversions.

What is the best way to import legacy Word documents into an Obsidian knowledge base?

The best way to import legacy Word documents into an Obsidian knowledge base is using automated drive detection to identify source folders, then batch converting .docx files to Markdown. This organizes imported files into dedicated subfolders named after original folders for easy tracing.

Do I need Python to convert Word docs to Markdown on macOS?

You need Python 3.x and the mammoth library to convert Word docs to Markdown on macOS. These dependencies are required to parse .docx binary content and execute the automated bulk import from external hard drives.

Why does my Word document migration to Obsidian fail on macOS?

Word document migration to Obsidian on macOS fails if Python 3.x or the mammoth library is not installed, or if the external hard drive is not properly mounted. The tool generates a report detailing specific failed conversions for troubleshooting.