teachingai/ocrmypdf-image
skills/ocrmypdf-skills/ocrmypdf-image/SKILL.md
OCRmyPDF image processing skill — deskew, rotate, clean, despeckle, remove border from scanned documents. Use when the user needs to improve scanned PDF quality, fix skewed pages, remove noise, or clean up scanned documents before OCR.
$ install --global
skillsauthnpx skillsauth add teachingai/agent-skills ocrmypdf-imageInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 10, 2026, 8:52 AM144.7s1 file scanned
SKILL.md
- name:
- ocrmypdf-image
- description:
- OCRmyPDF image processing skill — deskew, rotate, clean, despeckle, remove border from scanned documents. Use when the user needs to improve scanned PDF quality, fix skewed pages, remove noise, or clean up scanned documents before OCR.
OCRmyPDF — Image Processing Guide
Overview
OCRmyPDF includes powerful image processing capabilities to improve scan quality before OCR. These tools help fix skewed pages, remove noise, clean borders, and enhance readability.
For core OCR functionality, see the ocrmypdf skill. For optimization and PDF/A options, see ocrmypdf-optimize. For batch/Docker/scripting, see ocrmypdf-batch.
Deskew
Deskew corrects pages that are slightly rotated (e.g., from feed scanner skew).
# Auto deskew (recommended)
ocrmypdf --deskew input.pdf output.pdf
# Force deskew even if rotation is minimal
ocrmypdf --deskew --force-ocr input.pdf output.pdf
Rotation
Rotate pages to correct upside-down or sideways scans:
# Auto-rotate based on text orientation
ocrmypdf --rotate-pages input.pdf output.pdf
# Force rotate all pages
ocrmypdf --rotate-pages --force-ocr input.pdf output.pdf
Remove Borders / Cleaning
Remove unwanted borders, artifacts, and noise from scanned pages:
# Remove borders (dots, solid borders)
ocrmypdf --remove-bordering input.pdf output.pdf
# Combine with cleanup
ocrmypdf --remove-bordering --clean input.pdf output.pdf
Despeckle
Remove speckles and isolated noise pixels:
# Remove speckles
ocrmypdf --despeckle input.pdf output.pdf
# Aggressive despeckle for very noisy scans
ocrmypdf --despeckle --clean input.pdf output.pdf
Unpaper
unpaper provides advanced post-processing:
# Apply unpaper with default settings
ocrmypdf --unpaper input.pdf output.pdf
# Custom unpaper board options
ocrmypdf --unpaper-args "--board A4" input.pdf output.pdf
Oversampling
Increase image resolution before OCR for better accuracy:
# Oversample to 300 DPI before OCR
ocrmypdf --oversample 300 input.pdf output.pdf
# Common for low-resolution scans
ocrmypdf --oversample 400 input.pdf output.pdf
Combined Recipes
Fix a skewed scan
ocrmypdf --deskew --remove-bordering --despeckle scanned.pdf fixed.pdf
Clean up a very noisy scan
ocrmypdf --deskew --rotate-pages --despeckle --clean --oversample 300 noisy.pdf clean.pdf
Remove all artifacts
ocrmypdf --remove-bordering --unpaper --despeckle dirty.pdf clean.pdf
Quick Reference
| Task | Command |
|------|---------|
| Auto deskew | --deskew |
| Auto rotate | --rotate-pages |
| Remove borders | --remove-bordering |
| Remove speckles | --despeckle |
| Unpaper | --unpaper |
| Oversample DPI | --oversample N |
Troubleshooting
- Poor OCR after cleaning: Try
--oversample 300to increase input quality. - Artifacts remain: Use
--unpaperfor aggressive cleanup. - Over-cleaned image: Reduce cleaning options for preserve original quality.
Related Skills
teachingai/nextjs
development
VerifiedTrustedCommunity
Guidance for Next.js using the official docs at nextjs.org/docs. Use when the user needs Next.js concepts, configuration, routing, data fetching, or API reference details.
284SKILL.mdUpdated Apr 14, 2026
teachingai/flask
tools
VerifiedTrustedCommunity
Provides comprehensive guidance for Flask framework including routing, templates, forms, database integration, extensions, and deployment. Use when the user asks about Flask, needs to create web applications, implement routes, or build Python web services.
284SKILL.mdUpdated Apr 14, 2026
teachingai/fastapi
development
VerifiedTrustedCommunity
Provides comprehensive guidance for FastAPI framework including routing, request validation, dependency injection, async operations, OpenAPI documentation, and database integration. Use when the user asks about FastAPI, needs to create REST APIs, or build high-performance Python web services.
284SKILL.mdUpdated Apr 14, 2026
teachingai/django
development
VerifiedTrustedCommunity
Provides comprehensive guidance for Django framework including models, views, templates, forms, admin, REST framework, and deployment. Use when the user asks about Django, needs to create web applications, implement models and views, or build Django REST APIs.
284SKILL.mdUpdated Apr 14, 2026