documentador-rag-revisor

Validate Markdown documents for RAG ingestion conformance and report non-conformities.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Valida documentos Markdown produzidos para RAG, assegurando conformidade estrutural e semântica para ingestão confiável em Base Vetorial com chunking determinístico.

Core Features & Use Cases

  • Validação estrutural e semântica de Markdown para pipelines de ingestão em RAG
  • Verificação automática de frontmatter YAML obrigatório (name e description) e das seções de teoria/prática
  • Geração de relatório claro de não conformidades para integração em CI/CD e fluxos automatizados de validação
  • Suporte à validação independente do conteúdo, sem alteração do documento de entrada

Quick Start

Forneça o documento Markdown ao avaliador para iniciar a validação.

Frequently Asked Questions about documentador-rag-revisor

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

FAQPage Schema
How do I validate Markdown documents for RAG ingestion pipelines?

To validate Markdown documents for RAG ingestion, you can use a linter that checks structural and semantic conformance, verifying YAML frontmatter, section hierarchy, and theory/practice classifications to ensure reliable chunking in vector databases.

What is Markdown validation for RAG and why is it needed?

Markdown validation for RAG ensures documentation meets structural and semantic rules before vector ingestion. It enforces required YAML frontmatter, valid section hierarchies, and clean summaries, guaranteeing deterministic chunking and reliable retrieval.

How do I check if my Markdown has the correct YAML frontmatter for automated pipelines?

To check YAML frontmatter for automated pipelines, a validation tool verifies the presence of required fields like name and description. It reports non-conformities without altering the input document, ensuring seamless CI/CD integration.

Does Markdown linting for RAG check section hierarchy and summary content?

Yes, Markdown linting for RAG checks section hierarchy and summary content. It validates theory and practice classifications, enforces correct structural sections, and prohibits operational details in summaries to maintain semantic quality.

Can I use a Markdown validator in CI/CD without modifying my source files?

Yes, you can validate Markdown in CI/CD without modifying source files. The validator performs independent content checks and outputs a report of non-conformities, leaving the original document untouched for safe automated pipeline integration.

What are the limitations of automated Markdown validation for vector databases?

Limitations of automated Markdown validation include its strict focus on structural and semantic rules, meaning it enforces predefined section hierarchies and required YAML fields but does not evaluate the factual accuracy of the ingested content.