# Extract PDF Page Artifacts

PDF conversion often fails when text, layout, and images are extracted separately. This skill creates traceable page artifacts that combine text metadata, rendered images, and page mappings.

## Install

```bash
npx skillstore add abejitsu/pdf-page-extract
```

## Metadata

- Status: approved
- Slug: abejitsu-pdf-page-extract
- Skillstore revision: r1
- Version status: missing
- Tree hash: e7c014ac3ddbe2ca2f0e462d187d5f4d804e338537ed9d20e35de3ec6f4996e5
- Author: AbeJitsu
- GitHub username: AbeJitsu
- License: MIT
- Repository: https://github.com/AbeJitsu/Game-Settings-Panel/tree/main/.claude/skills/calypso/pdf-page-extract
- Ref: 1ffa7643651792ccb4bd3b15d924d2c97edff755
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, filesystem
- Quality score: 78
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/abejitsu-pdf-page-extract
- Manifest: https://skillstore.pages.dev/api/skills/abejitsu-pdf-page-extract/manifest

## Capabilities

- Extracts text spans with font, style, position, and color metadata.
- Builds PDF index to book page mappings from page footers.
- Renders selected PDF pages to high-resolution PNG images.
- Extracts embedded page images and related image metadata.
- Writes persistent JSON and PNG artifacts for later processing.
- Defines quality checks for extracted text, images, and mappings.

## Use Cases

- Prepare pages for HTML conversion: Generate text metadata and page images before transforming PDF pages into faithful HTML layouts.
- Audit extracted document content: Review saved JSON, PNG, and mapping artifacts to confirm extraction quality before downstream use.
- Create reproducible PDF processing inputs: Persist extraction parameters and artifacts so later processing steps can be repeated and debugged.

## Prompt Templates

### Extract one page

```
Use this skill to extract page 17 from my PDF. Create the text metadata, rendered PNG, and page mapping artifacts.
```

### Extract a chapter range

```
Extract chapter 2 from PDF indices 15 through 28. Save rich extraction data, page PNG files, embedded images, and mapping data.
```

### Validate existing artifacts

```
Review the extraction artifacts for chapter 2. Confirm that JSON files parse, PNG files render, and every page has text span data.
```

### Prepare downstream conversion inputs

```
Run the full extraction workflow for a chapter and organize the artifacts so another skill can generate HTML from the saved data.
```

## Limitations

- Requires local Python tools that are not included in this skill file.
- Assumes a Calypso project directory and specific output layout.
- Does not perform OCR for image-only pages.
- Examples use one source PDF name and must be adapted for other documents.

## Best Practices

- Validate the source PDF path and output directory before running commands.
- Keep page mapping files with the generated page artifacts.
- Check JSON validity and PNG readability before starting downstream conversion.

## Anti Patterns

- Do not run extraction against untrusted paths without reviewing the target directories.
- Do not assume page numbers match PDF indices without a mapping file.
- Do not treat image-only pages as text extraction failures without checking OCR needs.

## Security Audit

- Audited at: 2026-07-09T03:56:58.171\+00:00
- Summary: Static findings were reviewed against SKILL.md and appear to be documentation examples for a local PDF extraction workflow. The shell command and path traversal flags are false positives caused by Markdown code examples, inline file names, and fixed relative paths within the project layout. No prompt injection, data exfiltration intent, or malicious behavior was found.

## Stats

- Views: 179
- Downloads: 25
- Favorites: 0
- Popularity score: 0