kreuzberg

kreuzberg 스킬 개요

kreuzberg가 하는 일

kreuzberg skill은 Kreuzberg를 사용해 91개 이상의 문서 형식에서 텍스트, 표, 메타데이터, 이미지, OCR 기반 콘텐츠를 추출하도록 도와줍니다. Python, Node.js/TypeScript, Rust, 그리고 CLI를 기본적으로 지원합니다. 단발성 프롬프트로 파싱을 추측하는 수준이 아니라, 실제로 믿고 쓸 수 있는 문서 처리 코드를 필요로 하는 사용자에게 가장 적합합니다.

누가 설치하면 좋은가

PDF, Office 파일, 이미지, HTML, 이메일, 아카이브, 학술 파일을 구조화된 결과로 바꿔야 한다면 kreuzberg를 설치하는 것이 좋습니다. 특히 스캔 품질, 배치 실행, 언어별 OCR이 중요한 작업에 잘 맞습니다. 수집 파이프라인, 문서 검색, RAG 준비, 추출 도구 구성에 강한 선택지입니다.

무엇이 다른가

kreuzberg skill의 핵심 가치는 구현 지향적이라는 점입니다. 여러 런타임에 걸쳐 설치 경로, 추출 모드, 설정, 배치 처리, 오류 처리, 플러그인까지 다룹니다. 그래서 단순히 “이 문서를 분석해줘”라는 일반 프롬프트보다, 실제로 실행 가능한 코드를 얻어야 할 때 훨씬 유용합니다.

kreuzberg 스킬 사용 방법

설치하고 대상 런타임부터 확인하기

빠르게 kreuzberg install을 진행하려면, 실제로 배포할 런타임부터 시작하세요:

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

그다음에는 맞는 API 문서를 먼저 읽는 것이 좋습니다: references/python-api.md, references/nodejs-api.md, references/rust-api.md. CLI를 쓴다면 references/cli-reference.md부터 보세요. 이 스킬은 모든 것을 한 번에 묻기보다, 하나의 런타임과 하나의 문서 유형부터 정하는 방식에서 가장 효과적입니다.

거친 요청을 실제로 쓸 수 있는 프롬프트로 바꾸기

좋은 kreuzberg usage 프롬프트는 파일 형식, 추출 목표, 런타임, 제약을 분명하게 적습니다. 예를 들어: “Python에서 kreuzberg를 사용해 스캔된 PDF에서 청구서 텍스트, 표, OCR을 추출하고, 줄바꿈은 유지한 채 후속 파싱에 적합한 JSON으로 반환해줘.”처럼 요청하는 것이 좋습니다. 단순히 “PDF에서 데이터를 추출해줘”라고 하는 것보다 훨씬 낫습니다. 왜냐하면 표, OCR, 깔끔한 텍스트 중 무엇을 우선해야 하는지 알려주기 때문입니다.

먼저 읽어야 할 파일

실용적인 kreuzberg guide 작업이라면 다음 순서로 읽으세요: SKILL.md, references/configuration.md, 해당 런타임의 API 파일, references/supported-formats.md. 플러그인, OCR 튜닝, 배치 동작이 필요할 때만 references/advanced-features.md를 여세요. 이 순서는 채택에 가장 큰 영향을 주는 결정들, 즉 설치 구조, 지원 입력, 기본 설정을 가장 먼저 드러내 줍니다.

작업에 맞는 워크플로를 사용하기

한 개의 파일만 처리한다면, 먼저 단순한 extract_file 호출이나 CLI extract로 시작한 뒤 출력이 잘못될 때만 MIME 힌트나 설정을 더하세요. 여러 파일을 처리한다면, 초기에 배치 헬퍼와 오류 처리를 확인해야 합니다. kreuzberg for PDF Processing에서는 기본 추출 호출보다 OCR 설정과 출력 형식이 더 중요한 경우가 많으니, 규모를 키우기 전에 그 부분부터 검증하는 것이 좋습니다.

kreuzberg 스킬 FAQ

kreuzberg는 PDF 전용인가요?

아닙니다. PDF가 중요한 사용 사례이긴 하지만, 이 스킬은 Office 문서, 이미지, HTML, 이메일, 아카이브, 학술 형식도 다룹니다. 형식이 섞인 수집 작업이라면 kreuzberg가 PDF 전용 도구보다 더 잘 맞습니다.

스킬을 쓰기 전에 라이브러리를 알아야 하나요?

아니요. 다만 대상 런타임과 출력 목표는 알고 있어야 합니다. 문서 유형, OCR 필요 여부, 그리고 일반 텍스트, 마크다운, JSON, 구조화된 메타데이터 중 무엇을 원하는지 설명할 수 있다면 kreuzberg skill은 초보자에게도 충분히 친화적입니다.

언제 kreuzberg를 쓰지 말아야 하나요?

작업의 핵심이 추출이 아니라 의미 요약이라면, 또는 코드 출력이 필요 없는 단일 문서를 빠르게 다루는 수동 프롬프트만 필요하다면 kreuzberg를 생략하세요. OCR, 표, 다중 형식 지원이 전혀 필요 없는 파이프라인이라면 과한 선택일 수도 있습니다.

일반 프롬프트와 무엇이 다른가요?

일반 프롬프트는 작업을 설명할 수는 있지만, kreuzberg usage는 문서 추출에 맞는 설치, API 호출, 설정, 실패 처리까지 제대로 맞추는 데 초점이 있습니다. 그래서 출력 품질이 런타임 설정, OCR 백엔드 선택, 배치 처리 세부사항에 좌우될 때 더 유리합니다.

kreuzberg 스킬 개선 방법

입력 형태를 처음부터 분명히 밝히기

가장 좋은 kreuzberg skill 결과는 파일 형식, 원본 품질, 원하는 출력이 명확한 프롬프트에서 나옵니다. “스캔된 PDF”, “디지털 PDF”, “청구서 표”, “이메일 첨부파일”, “헤딩 유지”처럼 구체적으로 적으세요. 이런 정보에 따라 OCR, 청킹, 단순 추출 중 무엇을 기본값으로 삼을지가 달라집니다.

피하고 싶은 실패 양상을 말하기

첫 결과가 만족스럽지 않다면, 무엇이 문제였는지 정확히 알려주세요: 표 누락, 줄바꿈 깨짐, 느린 OCR, 잘못된 언어 감지, 노이즈가 많은 이미지 등입니다. kreuzberg for PDF Processing에서는 이렇게 해야 OCR 백엔드, 설정, 출력 형식 중 무엇을 조정할지 좁혀지므로, 전체 워크플로를 다시 쓰지 않아도 됩니다.

구체적인 예시로 반복 개선하기

더 나은 개선 루프는 실패한 파일 설명 한 개와 목표 결과 한 개를 함께 제시하는 것입니다. 예를 들어: “이 스캔된 청구서는 청구서 번호, 총액, 공급업체, 항목별 내역을 JSON으로 만들어야 해.”라고 말하는 식입니다. “더 정확하게 해줘”보다 훨씬 유용합니다. 스킬이 실제 스키마와 문서 유형에 맞춰 추출 조언을 조정할 수 있기 때문입니다.

좁게 시작한 뒤 범위를 넓히기

처음에는 하나의 런타임, 하나의 형식, 하나의 추출 모드로 시작하세요. 기본 kreuzberg install과 추출 경로가 동작하면 그다음에 배치 처리, 플러그인, 고급 설정을 추가하면 됩니다. 이렇게 하면 혼란을 줄일 수 있고, 문제가 설치인지, OCR인지, 아니면 후속 파싱인지 확인하기도 쉬워집니다.