read-special-images

Tiles oversized or text-dense images into overlapping crops for accurate OCR and reading.

1|Updated Jul 17, 2026
One-click install
npx skills add https://github.com/waiyanphyo999/telegram-bot-deploy --skill read-special-images-waiyanphyo999
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: read-special-images
Source: https://github.com/waiyanphyo999/telegram-bot-deploy/tree/main/skills/read-special-images
Command: npx skills add https://github.com/waiyanphyo999/telegram-bot-deploy --skill read-special-images-waiyanphyo999

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Pillow, and includes scripts (resource) components.

What problem does it solve? Whole-image previews of very tall, wide, high-resolution, or text-dense images get downscaled, making text unreadable and causing vision models to hallucinate content. This Skill inspects image dimensions, deterministically slices abnormal images into overlapping tiles with a reading-order manifest, and guides ordered extraction with overlap reconciliation so no content is invented or lost. ## Core Features & Use Cases - Dimension Inspection: Reads width, height, aspect ratio, and orientation from the original file before deciding whether tiling is needed. - Deterministic Tiling: Slices images in vertical, horizontal, or grid mode with configurable overlap, producing PNG tiles plus a manifest.json with reading order. - Overlap Reconciliation: Instructs how to merge tile extractions, deduplicate boundary content, and flag unreadable regions instead of guessing. - Use Case: A user shares a long scrolling chat screenshot whose preview text is illegible. The Skill detects the extreme aspect ratio, generates top-to-bottom tiles, and extracts the full conversation in order without inventing messages. ## Quick Start Use the read-special-images skill to extract all text from this long screenshot without guessing any unreadable parts.

Frequently Asked Questions about read-special-images

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read text from a very long screenshot?

Slice the screenshot into overlapping vertical tiles using the slice_image.py script, then read each tile in top-to-bottom manifest order. The overlap lets you reconcile boundary lines so no text is duplicated or dropped.

How to OCR a high-resolution image without losing detail?

Split the image into grid tiles with the slice_image.py script so each tile stays at a readable scale, then extract text per tile and merge results. Reading tiles individually avoids the downscaling that makes whole-image previews illegible.

When should an image be split into tiles for reading?

Tile when the longest side is at least twice the shortest, either side exceeds 4096 pixels, total pixels exceed 16 million, or text remains unreadable in the preview. Ordinary readable images should not be tiled.

Does the image tiling script require any Python libraries?

The slice_image.py script requires Pillow for opening, transposing, and cropping images. If Pillow is unavailable, the script exits with a message rather than installing dependencies automatically.

What are the limitations of tiling images for OCR?

Tiling cannot recover content that is unreadable in every tile, and the workflow forbids upscaling and guessing. If extraction remains impossible, only the verified portions are reported with unreadable regions flagged.