import-content

Import Markdown files into Kurt's database with YAML frontmatter parsing and indexing.

2|Updated Oct 23, 2025
One-click install
npx skills add https://github.com/boringdata/kurt-demo --skill import-content
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: import-content
Source: https://github.com/boringdata/kurt-demo/tree/main/.claude/skills/import-content-skill
Command: npx skills add https://github.com/boringdata/kurt-demo --skill import-content

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml.

What problem does it solve?

When web ingestion fails or you have local markdown files, manually adding them to your AI's knowledge base can be cumbersome. This skill provides a robust fallback for importing existing markdown content, ensuring all your data is indexed and searchable.

Core Features & Use Cases

  • Fix ERROR Records: Easily import content for documents that failed initial web fetching.
  • Bulk Import: Add multiple local markdown files to the Kurt database in one go.
  • Metadata Extraction: Automatically parse YAML frontmatter from your markdown files to enrich database records with titles, authors, and dates.
  • Use Case: After a website migration, you have a directory of markdown files that need to be added to Kurt. This skill allows you to bulk import these files, ensuring their metadata is correctly extracted and they become fully searchable within your knowledge base.

Quick Start

Import the markdown file 'sources/docs.getdbt.com/guides/fusion-quickstart.md' for document ID '5f403260'.

Frequently Asked Questions about import-content

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

FAQPage Schema
How do I import markdown files into my Kurt knowledge base?

Import markdown files by pointing the skill to your local directory or specific file paths. The skill parses YAML frontmatter to extract metadata (title, author, published date), maps files to Kurt database records, and indexes them for search. This enables bulk ingestion when web-based import fails.

Can I fix ERROR records by importing markdown content?

Yes. When documents fail initial web fetching, you can import their markdown equivalents to populate ERROR records. The skill reconciles failed ingestion attempts by extracting frontmatter metadata and creating searchable database entries from local files.

What metadata does the skill extract from markdown files?

The skill parses YAML frontmatter to extract title, description, author, and published_date or last_modified fields. This metadata enriches database records, ensuring imported content is properly attributed and indexed within your knowledge base.

When should I use markdown import instead of automatic web ingestion?

Use markdown import as a fallback when auto-import hooks fail, after website migrations produce local markdown files, or for bulk content that wasn't captured by automatic ingestion. It's a manual recovery workflow for gaps in automated pipelines.

Does the skill support bulk import of multiple markdown files at once?

Yes. The skill bulk imports multiple local markdown files from a source directory in one operation, applies consistent metadata extraction to each file, and performs post-import indexing and verification across all records simultaneously.

What's required to use this skill for importing markdown content?

Markdown files with YAML frontmatter containing metadata fields, a Kurt database instance to import into, and pyyaml for parsing frontmatter. The skill handles file-to-record mapping and automated indexing; no manual database configuration is needed.