Skip to main content

extractor

Extract one local document through the canonical Extractor application command. Use when the user says "extract this", "extract pdf", "convert to markdown", "parse this file", "process document", or provides a document.

Jump to install

Source facts

Repository
grahama1970/agent-skills
Last source activity
August 8, 2026 at 16:32
Detected SKILL.md language
English
Stars
5
Forks
2

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer
12 files

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
extractor
description
Extract one local document through the canonical Extractor application command. Use when the user says "extract this", "extract pdf", "convert to markdown", "parse this file", "process document", or provides a document.
allowed-tools
Bash, Read
triggers
["extract this","extract document","extract pdf","extract text","convert to markdown","convert to text","parse this file","process document","process pdf","get sections from","extract sections","run extractor","pdf to markdown","docx to markdown","document to json"]
metadata
{"short-description":"Thin wrapper for canonical Extractor file extraction","project-path":"${HOME}/workspace/experiments/extractor"}
provides
["document-extraction","pdf-extraction","html-extraction"]
composes
["agentic-evals"]
complies
["best-practices-skills","best-practices-python"]
taxonomy
["ingestion","extraction","precision"]
runtime_self_improvement
basic
disciplines
["extraction"]
# Extractor This skill is a thin, zero-choice wrapper over the Extractor project. Give it one supported file and it delegates route selection, PDF handling, provider choice, artifact validation, and terminal status to Extractor. ## Quick Start ```bash .pi/skills/extractor/run.sh paper.pdf .pi/skills/extractor/run.sh paper.pdf --out ./results .pi/skills/extractor/run.sh paper.pdf --offline .pi/skills/extractor/run.sh paper.pdf --format markdown ``` The command writes the canonical `extractor.result.v1` result to stdout for JSON output. Human progress and errors belong on stderr. ## Normal Flags | Flag | Purpose | | --- | --- | | `input` | Required local file path. | | `--out PATH` | Output directory for run artifacts. | | `--offline` | Disable network/model enrichment. | | `--format json` | Emit canonical JSON, the default. | | `--format markdown` | Emit Markdown presentation when available. | | `--json` | Compatibility alias for `--format json`. | | `--markdown` | Compatibility alias for `--format markdown`. | Do not choose engines, presets, providers, models, OCR strategy, or pipeline stages from this skill. Extractor owns those decisions behind its application facade and returns `extractor.result.v1` for JSON extraction results. ## Maintainer Commands ```bash .pi/skills/extractor/run.sh doctor .pi/skills/extractor/run.sh debug-routing paper.pdf .pi/skills/extractor/sanity.sh ``` `doctor` checks the declared Extractor project and installed command. `debug-routing` prints the canonical Extractor help and supported wrapper arguments; it does not perform extraction. Set `EXTRACTOR_ROOT` only when the Extractor checkout is not at `${HOME}/workspace/experiments/extractor`. Set `EXTRACTOR_COMMAND` to an installed executable path when testing a clean wheel install, for example `EXTRACTOR_COMMAND=/tmp/extractor-clean/bin/extractor`.
View on GitHub