kreuzberg

Visión general de la skill kreuzberg

Qué hace kreuzberg

La kreuzberg skill te ayuda a usar Kreuzberg para extraer texto, tablas, metadatos, imágenes y contenido respaldado por OCR de más de 91 formatos de documento, con compatibilidad nativa para Python, Node.js/TypeScript, Rust y una CLI. Es ideal para quienes necesitan código fiable de procesamiento documental, no solo un prompt puntual que intente adivinar el parsing.

Quién debería instalarla

Instala kreuzberg si tu tarea es convertir PDFs, archivos de Office, imágenes, HTML, correo electrónico, archivos comprimidos o documentos académicos en salida estructurada, especialmente cuando importan la calidad del escaneo, las ejecuciones por lotes o el OCR específico por idioma. Encaja muy bien en pipelines de ingesta, búsqueda documental, preparación para RAG y tooling de extracción.

Por qué es diferente

El valor principal de la kreuzberg skill es que está orientada a la implementación: cubre rutas de instalación, modos de extracción, configuración, procesamiento por lotes, manejo de errores y plugins en varios runtimes. Eso la hace mucho más útil que un prompt genérico de “analiza este documento” cuando necesitas código que realmente puedas ejecutar.

Cómo usar la skill kreuzberg

Instala y confirma el runtime de destino

Para una kreuzberg install rápida, parte del runtime que de verdad vas a desplegar:

pip install kreuzberg
npm install @kreuzberg/node
cargo install kreuzberg-cli

Después, lee primero la referencia de API que corresponda: references/python-api.md, references/nodejs-api.md o references/rust-api.md. Si vas a usar la CLI, empieza por references/cli-reference.md. La skill funciona mejor cuando eliges primero un runtime y un tipo de documento, en lugar de pedirlo todo a la vez.

Convierte una petición vaga en un prompt útil

Un buen prompt de kreuzberg usage nombra el tipo de archivo, el objetivo de extracción, el runtime y las restricciones. Por ejemplo: “Usa kreuzberg en Python para extraer texto de facturas, tablas y OCR de PDFs escaneados, conserva los saltos de línea y devuelve JSON apto para parsing posterior”. Eso es mejor que “extrae datos de PDFs”, porque le indica a la skill si debe optimizar tablas, OCR o texto limpio.

Lee primero estos archivos

Para trabajar de forma práctica con la kreuzberg guide, lee en este orden: SKILL.md, references/configuration.md, el archivo de API del runtime y references/supported-formats.md. Después abre references/advanced-features.md si necesitas plugins, ajuste de OCR o comportamiento por lotes. Ese orden deja a la vista las decisiones que más influyen en la adopción: forma de instalación, entradas compatibles y valores predeterminados de configuración.

Usa el flujo que encaje con tu trabajo

Si vas a procesar un solo archivo, empieza con una llamada simple extract_file o con extract en la CLI, y añade pistas de MIME o configuración solo si la salida es incorrecta. Si vas a procesar muchos archivos, revisa pronto las ayudas para batch y el manejo de errores. Para kreuzberg for PDF Processing, los ajustes de OCR y el formato de salida suelen importar más que la llamada base de extracción, así que valida eso antes de escalar.

Preguntas frecuentes sobre la skill kreuzberg

¿kreuzberg es solo para PDFs?

No. El PDF es un caso de uso principal, pero la skill también cubre documentos de Office, imágenes, HTML, correo, archivos comprimidos y formatos académicos. Si tu carga de trabajo combina varios formatos, kreuzberg encaja mejor que una herramienta solo para PDF.

¿Necesito conocer la biblioteca antes de usar la skill?

No, pero sí necesitas saber cuál es tu runtime de destino y cuál es tu objetivo de salida. La kreuzberg skill es fácil de usar si puedes describir el tipo de documento, si hace falta OCR y si quieres texto plano, markdown, JSON o metadatos estructurados.

¿Cuándo no debería usar kreuzberg?

Evita kreuzberg si tu tarea es principalmente de resumen semántico y no de extracción, o si solo necesitas un prompt manual rápido para un único documento sin generar código. También puede ser excesivo si tu pipeline no necesita OCR, tablas ni compatibilidad con varios formatos.

¿En qué se diferencia de un prompt normal?

Un prompt normal puede describir la tarea, pero kreuzberg usage se centra en obtener la instalación correcta, la llamada a la API adecuada, la configuración y el manejo de fallos para la extracción de documentos. Eso la hace mejor cuando la calidad de salida depende de la configuración del runtime, de la elección del backend OCR o de detalles del procesamiento por lotes.

Cómo mejorar la skill kreuzberg

Indica desde el principio la forma de entrada

Los mejores resultados de la kreuzberg skill salen de prompts que especifican el tipo de archivo, la calidad de la fuente y la salida deseada. Incluye detalles como “PDF escaneado”, “PDF digital”, “tablas de facturas”, “adjuntos de correo” o “conservar encabezados”. Esos detalles cambian si el valor predeterminado debe ser OCR, chunking o extracción simple.

Señala el modo de fallo que quieres evitar

Si la primera salida no es buena, dile a la skill qué salió mal: tablas faltantes, saltos de línea rotos, OCR lento, mala detección de idioma o imágenes con ruido. Para kreuzberg for PDF Processing, esto ayuda a acotar si hay que ajustar el backend OCR, la configuración o el formato de salida, en lugar de reescribir todo el flujo.

Itera con ejemplos concretos

Un ciclo de mejora más sólido consiste en pegar la descripción de un archivo que falla y un resultado objetivo, por ejemplo: “Esta factura escaneada debería producir número de factura, total, proveedor y líneas de detalle en JSON”. Eso es mucho más útil que pedir que “sea más precisa”, porque la skill puede afinar las recomendaciones de extracción según el esquema y el tipo de documento reales.

Empieza con algo acotado y luego amplía

Comienza con un runtime, un formato y un modo de extracción. Cuando la kreuzberg install base y la ruta de extracción ya funcionen, añade procesamiento por lotes, plugins o configuración avanzada. Así reduces la confusión y te resulta más fácil verificar si el problema está en la instalación, el OCR o el parsing posterior.