# Generate ASCII PDF Layout Previews

PDF-to-HTML workflows lose layout context when extraction data is hard to inspect. This skill turns page images and rich text metadata into readable ASCII previews.

## Install

```bash
npx skillstore add abejitsu/ascii-preview-generate
```

## Metadata

- Status: approved
- Slug: abejitsu-ascii-preview-generate
- Skillstore revision: r1
- Version status: missing
- Tree hash: a6304af0cbf927910e567f85b7028b858fa58985b92c3d3d4357a51e1123837f
- Author: AbeJitsu
- GitHub username: AbeJitsu
- License: MIT
- Repository: https://github.com/AbeJitsu/Game-Settings-Panel/tree/main/.claude/skills/calypso/ascii-preview-generate
- Ref: 9f22d902a4190b1e33cced8a68441beb8e612f59
- 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
- Quality score: 78
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/abejitsu-ascii-preview-generate
- Manifest: https://skillstore.pages.dev/api/skills/abejitsu-ascii-preview-generate/manifest

## Capabilities

- Reads a PDF page image and rich extraction metadata as inputs.
- Produces a text preview that shows page boundaries and content order.
- Labels headings, paragraphs, lists, tables, and visual spacing in the preview.
- Adds summary statistics about detected page elements and confidence.
- Writes the ASCII preview to the expected page artifact path.

## Use Cases

- Review PDF Extraction Quality: Compare a generated ASCII preview with extraction metadata before creating HTML.
- Prepare HTML Generation Context: Create a structural text guide that helps an AI generator preserve page hierarchy.
- Debug Layout Differences: Inspect headings, paragraph flow, lists, and spacing without opening the original PDF page.

## Prompt Templates

### Create a Basic Preview

```
Generate an ASCII layout preview for this PDF page. Use the page image and rich extraction file. Save the result to the expected artifact path.
```

### Validate Content Structure

```
Create the ASCII preview and verify that all headings, paragraphs, lists, and tables from the extraction data are represented.
```

### Handle Missing Visual Input

```
Generate a text-only ASCII preview from the rich extraction data. Note that the image was unavailable and include confidence limits.
```

### Optimize for HTML Generation

```
Build a detailed ASCII preview for HTML generation. Emphasize hierarchy, reading order, layout spacing, and any ambiguous structures that need review.
```

## Limitations

- Output quality depends on the accuracy of the source image and extraction metadata.
- The skill describes a workflow and does not include executable conversion code.
- Complex tables or unusual layouts may need manual review.
- Sensitive documents should only be processed under approved privacy controls.

## Best Practices

- Use both the page image and extraction metadata when available.
- Review the ASCII preview before using it for HTML generation.
- Keep generated lines short enough for reliable human inspection.

## Anti Patterns

- Do not treat the preview as a pixel-perfect replacement for the page image.
- Do not process confidential PDFs without approved data handling controls.
- Do not ignore missing or incomplete extraction data before downstream generation.

## Security Audit

- Audited at: 2026-07-07T20:00:43.418\+00:00
- Summary: All static findings are false positives caused by Markdown inline code, fenced examples, and sample page text in SKILL.md. I found no executable scripts, command execution, reconnaissance behavior, or prompt injection content in the reviewed skill file.

## Stats

- Views: 227
- Downloads: 12
- Favorites: 0
- Popularity score: 0