Data & Analysis document-extractionpdf-extractionoffice-xmlarchive-extractionstructured-dataemail-parsingocr

Format-Specific Document Extraction Workflows

Structured extraction workflows for Office XML, PDF, archives, structured text, and email with secure validation

FollowSkills review · FSRS-2.0
Use with care
66/ 100 5-point scale 3.3 / 5
1 2 3 4 5 6
1Trust21 / 25 · 4.2/5

The skill is well-integrated with the Xberg document-extraction framework, which explicitly acknowledges handling potentially untrusted user documents. The repository contains a detailed security policy, dedicated input validators (ZipBombValidator, DepthValidator, StringGrowthValidator etc.), and careful default security limits, all of which strongly support safe handling of untrusted input. However, at the skill level, there is no explicit mechanism for user confirmation or transparency of data flow; the skill documentation does not cover permissions, rollback, or user confirmation. The skill's functional scope is extraction, without external network calls, but some capabilities like OCR may depend on external services. Therefore, deduction for incomplete permission and confirmation guidance at the skill level.

2Reliability9 / 20 · 2.3/5

Instructions in the skill document are consistent, and the format-specific extraction workflows are clear. The repo demonstrates extensive test and CI infrastructure (e.g., Docker CI, benchmark workflows, e2e tests). However, for the selected skill path, no tests or reproducible execution evidence are available; the skill document only references source files, with no tests or verification results. The instructions are self-consistent and well-structured, but evidence for test coverage and edge-case handling is lacking. Given static review, the maximum is capped, and this score of 9 reflects that the happy path appears plausible, but error handling and failure feedback are not detailed.

3Adaptability12 / 15 · 4.0/5

The skill is well-targeted for clear scenarios: extracting content from various specific formats (Office, PDF, archives, structured text, email), which aligns with real needs. However, the non-fit range is not clearly defined; the skill's name and description suggest a general extraction capability, but it covers only format-specific aspects and does not explicitly state when it should not be used. Additionally, documentation mentions that complex content like macros or password-protected files may not be supported, but this is not described as a skill boundary. Regarding environment fit, there is no mention of China-relevant services or reachability from mainland-China networks; some capabilities like provider-hosted OCR or LLM may depend on services potentially inaccessible from China, but the skill's core is local processing. Deduction for insufficient evidence of boundaries and trigger conditions.

4Convention12 / 15 · 4.0/5

The skill document is well-organized, with clear heading hierarchy, diagrams, and source-code references, and follows progressive disclosure. The license is explicit (MIT). Installation and dependency notes are provided (indicating Cargo feature flags). Maintenance responsibility (regular CI and versioning) exists, but the skill itself is not versioned or changelogged, and it is unclear whether the skill will be regularly updated. Known limitations are not explicitly disclosed at the skill level. Deduction for lack of versioning and explicit maintenance responsibility, and hidden assumptions such as needing to build the project first.

5Effectiveness7 / 15 · 2.3/5

Public evidence indicates that the skill can accomplish the core task of extracting content from specified formats. The repository contains extensive benchmark efforts and tests across various formats, suggesting practical effectiveness. However, for the selected skill path, there is no directly usable output example or verification result. The skill document references implementation details but does not demonstrate output for key paths or provide representative results. The benefit compared to manual effort is unclear, and static review cannot verify output quality. Hence, capped at 7 due to lack of direct, verifiable evidence from static review.

6Verifiability5 / 10 · 2.5/5

The repository contains abundant auditable primary material: detailed CI workflows, benchmark configuration, test suites, and reproducible build configurations. These provide supporting evidence for the framework's capabilities, which underpin the skill. However, the specific skill path has no dedicated tests or verification; framework coverage is diffuse. There is no independent verification or cross-source corroboration. Given static read and no tests specifically for the skill path, capped at 5 for partial evidence.

Evidence confidence:Low Reviewed Aug 07, 2026 Reviewed revision fbdb9f18ca7c
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
Before you use it
  • The skill documentation does not include explicit security/permission guidance, nor does it mention user confirmation or data-flow transparency.
  • Some capabilities (e.g., provider-hosted OCR or LLM) may rely on external services potentially inaccessible from mainland China; evaluate reachability from Chinese networks.
  • The skill document does not define a clear non-fit range or trigger boundaries, which may lead to misuse.
  • The skill itself has no versioning or changelog, maintenance responsibility is unclear, and the update path is unknown.
See the full review method →

What does this skill do, and when should you use it?

This skill provides format-specific document extraction workflows for data extraction scenarios. It covers Office XML (DOCX/PPTX/ODT), PDF (with OCR fallback), archives (ZIP/TAR/7z/GZIP), structured text (JSON/YAML/TOML/XML), and email (EML/MSG). Each workflow includes security validation (e.g., ZipBombValidator), streaming XML parsing, and dedicated extractors for text, tables, and metadata. The skill is part of the Xberg monorepo with 5 skills; this skill focuses solely on format-specific extraction workflows.

It defines steps to extract document content from various formats. For Office XML, it validates the ZIP archive and parses XML to extract text, tables, and metadata. For PDFs, it uses pdf_oxide to extract per-page text with OCR fallback. For archives, it validates against zip bombs before extraction, extracts metadata, and only extracts plaintext files. For structured text, it detects MIME and parses/pretty-prints. For email, it parses headers and processes body and attachments. It also provides a guide for adding new formats, covering MIME mapping, extractor implementation, and registration.

  1. Extracting text and tables from DOCX, PPTX, or ODT files for document analysis.
  2. Extracting per-page text from PDFs, automatically using OCR for scanned documents with no searchable text.
  3. Safely parsing ZIP, TAR, 7z, or GZIP archives, avoiding zip bombs, to retrieve metadata and plaintext content.
  4. Formatting and converting JSON, YAML, TOML, and XML files into text for data pipelines.
  5. Parsing email bodies and attachments from EML or MSG files for information consolidation.
  6. Implementing support for new document formats within the Xberg framework, following the extractor guide.

What are this skill's strengths and limitations?

Pros
  • Security-first with built-in ZipBomb validation and depth/length validators
  • Covers a wide range of formats: Office, PDF, archives, structured data, and email
  • Clear guide for adding new formats with MIME registration and extractor implementation
  • OCR fallback for PDFs handles scanned documents
Limitations
  • Requires Rust environment and Xberg core library, adding dependencies
  • Skill does not provide a full end-to-end CLI/GUI; it only defines workflows
  • No mention of a test suite or platform-specific validation (e.g., Windows/macOS)
  • OCR dependency may require additional configuration

How do you install this skill?

This skill is part of the Xberg monorepo and requires installing and building the Xberg Rust core. Install the Xberg library (e.g., via cargo add xberg). The skill file is located at .ai-rulez/skills/format-specific-extraction/SKILL.md in the repository.

How do you use this skill?

Copy the skill file to your agent's skills directory. Then, use the skill in document processing tasks by following the workflows in SKILL.md. For example, request 'Extract text from example.docx' and the agent will follow the DOCX extraction workflow.

FAQ

Does this skill require external OCR tools?
It supports OCR fallback for PDFs but does not specify an OCR engine. It uses Xberg's OCR capabilities, which may rely on supported backends like Tesseract.
Can it extract from all archive formats?
It covers ZIP, TAR, 7z, and GZIP. However, it only extracts text from plaintext files, not binary content inside archives.
Is this skill usable in non-Rust projects?
The skill defines workflows using Rust APIs. It requires the Xberg Rust library, but Xberg offers bindings for multiple languages, provided the underlying engine is available.
Are the steps for adding new formats detailed?
Yes, the steps include MIME mapping, extractor implementation, registration, and feature gating, requiring Rust programming skills.

More skills from this repository

All from xberg-io/xberg

Related skills