kb-prepare-batch

Stage source files into library/raw/ and convert non-markdown formats to Markdown.

41|6|Updated Jul 12, 2025
One-click install
npx skills add https://github.com/SteveGJones/ai-first-sdlc-practices --skill kb-prepare-batch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kb-prepare-batch
Source: https://github.com/SteveGJones/ai-first-sdlc-practices/tree/main/plugins/sdlc-knowledge-base/skills/kb-prepare-batch
Command: npx skills add https://github.com/SteveGJones/ai-first-sdlc-practices --skill kb-prepare-batch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Stage source files into library/raw/ and convert non-markdown formats to Markdown-ready content, adding provenance frontmatter for traceability.

Core Features & Use Cases

  • Batch file staging: Converts non-markdown formats to Markdown and writes them to library/raw/ with provenance metadata.
  • Format conversion support: Uses markitdown for PDF/DOCX/PPTX/HTML/CSV and pandoc for TeX/EPUB/RST/ORG.
  • Provenance & auditability: Attaches provenance frontmatter to staged items to support traceability and reproducibility.

Quick Start

Provide a list of source files and optional flags to stage them into library/raw/ and specify conversion behavior with optional flags.

Frequently Asked Questions about kb-prepare-batch

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

FAQPage Schema
How do I batch convert PDF and DOCX files to Markdown for a knowledge base?

To batch convert PDF and DOCX files to Markdown, stage source files into library/raw/ using markitdown. The process converts non-markdown formats and adds provenance frontmatter for traceability.

Can I convert EPUB and TeX documents to Markdown-ready content?

Yes, you can convert EPUB and TeX documents to Markdown-ready content. The staging process uses pandoc specifically for TeX, EPUB, RST, and ORG formats, while markitdown handles other common types.

How does provenance metadata improve knowledge base ingestion?

Provenance metadata improves knowledge base ingestion by attaching traceability frontmatter to staged items. This records the source file origin and conversion details, supporting auditability and reproducibility for downstream use.

What is the best way to stage source files into a raw library directory?

The best way to stage source files into a raw library directory is to provide a list of source paths and optional flags. The process writes converted Markdown to library/raw/ while preserving or moving the original files.

Do I need pandoc and markitdown installed to batch convert documents?

Yes, you need pandoc and markitdown installed to batch convert documents. The staging process relies on markitdown for PDF, DOCX, PPTX, HTML, and CSV formats, and depends on pandoc for TeX, EPUB, RST, and ORG conversions.

Can I use a manifest to specify conversion behavior for batch file staging?

Yes, you can use an optional manifest to specify conversion behavior for batch file staging. Providing a manifest allows you to define how source files are processed, copied, or moved into the library/raw/ directory.