PDFToMD/.codex/skills/fixture-evaluation/SKILL.md

name, description

name	description
fixture-evaluation	Plan local fixture-based quality checks for this MinerU PDF-to-Markdown converter using samples/ without committing sample PDFs. Use when Codex needs to define sample coverage, quality metrics, regression checks, JSON metadata assertions, or human-readable .report.md expectations.

Fixture Evaluation

Overview

Use this skill to turn local sample PDFs into a small, repeatable quality plan. Keep samples local and untracked unless the user explicitly asks to commit them.

Workflow

1. Read PLAN.md and PROGRESS.md first.
2. Inspect samples/ only enough to understand fixture categories and filenames.
3. Map each fixture to risks: math, tables, multi-column reading order, figures/assets, Korean filenames, and metadata coverage.
4. Separate fast checks using mocked MinerU outputs from optional checks that require MinerU models, GPU, or long execution.
5. Define metrics for both JSON metadata and <stem>.report.md.
6. Update PROGRESS.md with fixture coverage and gaps.

Guardrails

• Do not commit sample PDFs.
• Do not copy samples into tracked fixtures without explicit user permission.
• Do not make GPU/model-dependent checks mandatory for the default fast loop.
• Do not grade only plain-text edit distance; include math, tables, reading order, assets, metadata, and renderability.

Reference

Read references/evaluation-metrics.md when defining fixture coverage, regression criteria, or report fields.