# Tika Eval Compare

Compare extracts from two Tika builds over a corpus to detect regressions in content...

- Repository: https://github.com/apache/tika (4119 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add apache/tika --skill tika-eval-compare -g -a claude-code -y`
Codex: `npx skills add apache/tika --skill tika-eval-compare -g -a codex -y`
Cursor: `npx skills add apache/tika --skill tika-eval-compare -g -a cursor -y`
Gemini CLI: `npx skills add apache/tika --skill tika-eval-compare -g -a gemini-cli -y`

## Description

Compare extracts from two Tika builds over a corpus to detect regressions in content, encoding, exceptions, and embedded-document handling. Use for "compare before/after extracts", "eval this change against the corpus".

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements.  See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License.  You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->

Local override: `$TIKA_SKILLS_LOCAL/tika-eval-compare/LOCAL.md` (default `~/.tika-skills`),
read after this file, wins on conflict.

# tika-eval: Compare Before/After Extracts

Compare the output of two versions of Tika against a corpus of files
to detect regressions in content extraction, encoding, exceptions, and
embedded document handling.

## Before You Start

Ask the user for:

1. **Working directory**, where to put builds, extracts, eval db, and
   reports (`<workdir>` below).  All artifacts go here.
2. **Number of threads** (`-n`), default is 2.  Use `-n 6` for faster
   runs when parse time comparison is not needed.  When comparing parse
   times between A and B, use the same `-n` for both.
3. **Run reports?**, whether to auto-generate the HTML/Excel reports
   and `summary.md` at the end (the `-r` flag on tika-eval Compare).

## Prerequisites

The rest: https://github.com/apache/tika/blob/HEAD/.skills/devs/tika-eval-compare/SKILL.md