Agent-Skills.md

Agent Skills: News Articles Rename

>

UncategorizedID: christopheryeo/claude-skills/news-articles-rename

Repository

christopheryeo/claude-skills
christopheryeo

Install this agent skill to your local

pnpm dlx add-skill https://github.com/christopheryeo/claude-skills/tree/HEAD/news-articles-rename

Skill Files

Browse the full folder contents for news-articles-rename.

Download Skill

Loading file tree…

news-articles-rename/SKILL.md

Skill Metadata

Name
news-articles-rename
Description
>

News Articles Rename

Purpose

Newspaper articles saved as PDFs or images typically arrive with unhelpful filenames like Image 2026-02-25 15-52-38.pdf. This skill extracts the main headline from each file using OCR and renames it to Article Title.pdf — making the News folder instantly browsable.

Target Folder

The default target is always:

Vivien (PA)/News/

Supported File Types

Process any file with these extensions: .pdf, .png, .jpg, .jpeg

Skip hidden files (starting with .) and any file that doesn't match these extensions.

How It Works

Run the bundled script scripts/rename_articles.py which handles the full pipeline:

python3 <skill-path>/scripts/rename_articles.py "<news-folder-path>"

The script will:

  1. Scan the folder for all supported files
  2. For each file, extract the first page as an image (300 DPI)
  3. Run Tesseract OCR on the image
  4. Identify the headline using heuristics (skip metadata, collect first substantial text block)
  5. Apply common OCR corrections (e.g. "Al" → "AI")
  6. Sanitise the headline for use as a filename
  7. Rename the file, handling duplicates by appending a number
  8. Print a summary table of old → new filenames

The script also handles mounted filesystem lock issues automatically by copying files to a temp directory for OCR processing when direct reads fail.

After Running

Present the results as a clear summary table showing what was renamed:

| # | Original Filename | New Filename | Status | |---|---|---|---| | 1 | Image 2026-02-25 15-52-38.pdf | Headline Goes Here.pdf | ✅ Renamed | | 2 | Image 2026-02-25 15-53-03.pdf | Another Article.pdf | ✅ Renamed | | 3 | some-file.png | some-file.png | ⚠️ No title found |

Flag any files that couldn't be processed and explain why. Note that minor OCR artefacts in headlines (e.g. misread characters) are expected from Tesseract — only flag files where no headline could be extracted at all.

Important Notes

  • Always process every file in the folder. Do not leave any file out.
  • If OCR is uncertain about a headline, prefer keeping the original name over guessing wrong.
  • The script handles both single-page and multi-page PDFs — only the first page is used for title extraction.
  • For image files (.png, .jpg, .jpeg), OCR is run directly on the image.