import

Import local files into structured Markdown notes under the OneBrain resources folder.

23|2|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/onebrain-ai/onebrain --skill import-onebrain-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: import
Source: https://github.com/onebrain-ai/onebrain/tree/main/.claude/plugins/onebrain/skills/import
Command: npx skills add https://github.com/onebrain-ai/onebrain --skill import-onebrain-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires node, markitdown, python3, pipx, and includes references (resource) components.

What problem does it solve?

Importing local documents into a knowledge vault is usually slow, inconsistent, and requires manual organization, so your AI can’t reliably build on your latest materials.

Core Features & Use Cases

  • Local-to-vault ingestion: Brings PDFs, Office files, images, video, and scripts from a staging inbox folder or a specified path into structured Markdown notes under your resources folder.
  • Type-specific extraction: Uses dedicated handlers per file type (e.g., PDF parsing, Excel table extraction, image description, script summarization) to produce usable, permanent notes.
  • Optional attachment embedding: With --attach (where supported), copies the original file into an attachments folder and embeds it into the generated note for easy review.
  • Batch orchestration with safety guardrails: Prompts for confirmation in batch mode, skips unsupported types, and follows strict rules to avoid deleting inbox files when extraction fails.

Quick Start

Run /import --attach to scan your inbox import folder and convert supported files into structured notes in your vault.

Frequently Asked Questions about import

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

FAQPage Schema
How do I convert local PDFs and Office files into Markdown notes?

This Skill automates converting local PDFs and Office files into Markdown notes by importing files from a staging folder or path and applying type-specific extraction handlers to generate structured vault notes.

Can I batch import multiple documents into my vault at once?

Yes, you can batch import multiple documents by running the Skill in batch mode, which scans your inbox import folder and processes all supported files after prompting for user confirmation.

What is the best way to organize local files into a knowledge vault?

The best way to organize local files into a knowledge vault is using the inbox staging folder method, which scans supported files, extracts content per file type, and creates structured notes under your resources folder.

Does the import process support embedding original file attachments in Markdown?

Yes, the import process supports embedding attachments in Markdown by using the --attach option, which copies the original file into an attachments folder and links it within the generated note.

What happens to inbox files if document extraction fails during batch processing?

If document extraction fails during batch processing, the Skill applies conditional cleanup rules that skip unsupported types and preserve the original inbox files, deleting them only after successful note creation.

Do I need Python and Node to extract content from local documents and images?

Yes, you need Python3 and Node environments, along with pipx and markitdown, to run the extraction handlers that parse PDFs, Office files, images, and scripts into Markdown notes.