documentador-rag

Convert unstructured inputs into RAG-ready Markdown documents with YAML metadata.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/joleques/northstar-ai --skill documentador-rag
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentador-rag
Source: https://github.com/joleques/northstar-ai/tree/main/.codex/skills/documentador
Command: npx skills add https://github.com/joleques/northstar-ai --skill documentador-rag

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts heterogeneous, unstructured inputs into deterministic, canonical Markdown documents explicitly prepared for vector-database ingestion and semantic chunking. It enforces fidelity to the original input, prevents undocumented summarization, and structures content so downstream pipelines can reliably separate theoretical and practical chunks.

Core Features & Use Cases

  • Deterministic Markdown output: Produces canonical .md files with a required YAML metadata block and rigid sectioning to support automated chunking.
  • Theory vs Practice separation: Marks content structurally as Teoria and Pratica so each chunk's role is explicit for retrieval and pipeline processing.
  • Broad input support: Designed for transcripts, meeting notes, Swagger/API specs, raw JSON, and technical documents to build knowledge bases and RAG corpora.
  • Quality rules: Enforces no summarization, per-section Summaries optimized for embeddings, and preservation of all technical details present in the input.

Quick Start

Use the documentador-rag skill to convert meeting-audio.mp3 into a deterministic Markdown document with required YAML metadata, separated theory and practice sections, and Summary blocks suitable for semantic chunking.

Frequently Asked Questions about documentador-rag

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

FAQPage Schema
How do I convert unstructured meeting transcripts into Markdown for RAG ingestion?

To convert unstructured meeting transcripts into Markdown for RAG ingestion, this Skill transforms raw inputs into deterministic .md files with YAML metadata and per-section Summary blocks optimized for semantic chunking and vector databases.

What is the best way to separate theory and practice content for semantic chunking?

Separating theory and practice content for semantic chunking requires structurally marking sections as Teoria and Pratica, ensuring each chunk's role is explicit for retrieval pipelines to process theoretical and practical information independently.

Can I use raw JSON and API specs as inputs for a knowledge base document generation pipeline?

Yes, you can use raw JSON and API specs as inputs for knowledge base document generation. The Skill supports broad input formats including Swagger specs and technical documents to build deterministic RAG corpora.

Why does my RAG pipeline retrieve incomplete technical details from summarized documents?

RAG pipelines retrieve incomplete technical details from summarized documents due to undocumented summarization. This Skill enforces strict fidelity to input content, preserving all technical details without summarization for accurate vector retrieval.

Do I need to manually add metadata to Markdown files before vector database ingestion?

No, you do not need to manually add metadata to Markdown files before vector database ingestion. This Skill automatically produces canonical .md files containing a required YAML metadata block optimized for automated chunking.

How do I format raw audio transcripts for semantic search?

To format raw audio transcripts for semantic search, this Skill converts unstructured inputs into hierarchical Markdown documents with per-section Summary blocks suitable for semantic chunking and vector ingestion.