Agent skill

Rename Pdfs

by realspqrk in realspqrk/autorename-pdf

[Dev] Rename PDF files using AI (Python, requires venv). An agent skill from realspqrk/autorename-pdf.

MITAuto-check passedDocuments & Office

Install Rename Pdfs

skills CLI
$ npx skills add realspqrk/autorename-pdf --skill rename-pdfs -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install realspqrk/autorename-pdf rename-pdfs --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/realspqrk/autorename-pdf.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/rename-pdfs .claude/skills/rename-pdfs && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
rename-pdfs
GitHub stars
122
Token cost
~541 tokens
SKILL.md length
183 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

[Dev] Rename PDF files using AI (Python, requires venv). An agent skill from realspqrk/autorename-pdf.

  • Works in 5 steps: Activate the venv before running any… → Always dry-run first to preview changes → Review the output — check that company… → …
  • Tasks that involve PDF
  • SKILL.md covers Workflow, Options, Undo and Config, plus 2 more sections
  • Calls python

What it does

Rename Pdfs is an agent skill from realspqrk/autorename-pdf. [Dev] Rename PDF files using AI (Python, requires venv). For development and cross-platform (macOS/Linux) use.

Its SKILL.md is about 540 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering PDF and File organization. It works with Python, Linux and macOS. The repository describes itself as: autorename-pdf is a highly efficient tool designed to automatically rename and archive PDF documents based on their content. The licence is MIT.

When your agent uses it

  • Tasks that involve PDF
  • Tasks that involve File organization

Example prompts

  • “/rename-pdfs”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Bash(python *), Bash(source *)

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Activate the venv before running any commands
  2. Always dry-run first to preview changes
  3. Review the output — check that company names, dates, and document types look correct.
  4. If the user confirms, run without dry-run
  5. Report results — show renamed count, any failures, and new filenames.

What it can do on your machine

Read from SKILL.md and the folder at commit 2ff1907. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(python *)
    • Bash(source *)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Rename Pdfs loads about 541 tokens when it runs. Until then it costs about 31 tokens; SKILL.md has 183 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~31
When it runs · the whole SKILL.md, loaded when a task matches
~541

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from realspqrk/autorename-pdf at commit 2ff1907, republished under its MIT licence (© realspqrk). 183 words, ~541 tokens.

Download SKILL.mdSave it as .claude/skills/rename-pdfs/SKILL.md (or your agent's skills folder).
name
rename-pdfs
description
[Dev] Rename PDF files using AI (Python, requires venv). For development and cross-platform (macOS/Linux) use.
allowed-tools
Bash(python *), Bash(source *)
user-invocable
true
argument-hint
[path_to_pdfs]

Rename PDFs (Development / Cross-Platform)

Rename PDF files using autorename-pdf from source. Requires the Python venv to be active.

Workflow

  1. Activate the venv before running any commands:

    source venv/Scripts/activate   # Windows
    source venv/bin/activate       # macOS / Linux
  2. Always dry-run first to preview changes:

    python autorename-pdf.py rename $ARGUMENTS --dry-run --output json
  3. Review the output — check that company names, dates, and document types look correct.

  4. If the user confirms, run without dry-run:

    python autorename-pdf.py rename $ARGUMENTS --output json
  5. Report results — show renamed count, any failures, and new filenames.

Options

Pass these after the path:

  • --recursive or -r — process subfolders
  • --provider <name> — override AI provider (openai/anthropic/gemini/xai/ollama)
  • --model <name> — override AI model
  • --vision — force vision mode (send page images to LLM)
  • --text-only — text extraction only, no OCR/vision
  • --ocr — force PaddleOCR

Undo

python autorename-pdf.py undo --output json

Config

python autorename-pdf.py config show --output json

Company Name Harmonization

harmonized-company-names.yaml maps company name variations to standardized names (e.g., "MSFT", "Microsoft Corp." → "Microsoft"). Uses fuzzy matching (Jaro-Winkler) so OCR typos are handled automatically.

If the dry-run output shows inconsistent or wrong company names, suggest the user add mappings:

yaml
StandardName:
  - "Variation 1"
  - "Variation 2"

Notes

  • Config file: config.yaml in project root (never commit — contains API keys)
  • Company names file: harmonized-company-names.yaml in project root (copy from .example)
  • Output format: YYYYMMDD COMPANY DOCTYPE.pdf
  • Providers: openai, anthropic, gemini, xai, ollama

© realspqrk, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/rename-pdfs of realspqrk/autorename-pdf.

Open the folder on GitHubat commit 2ff1907

Compare with similar skills

Rename Pdfs next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Rename Pdfs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Rename Pdfs this skillrealspqrk/autorename-pdf122—~541Automated safety check: PassMIT
Scanned PDF To Epublonghaiqwe/scanned-pdf-to-epub161—~1.9kAutomated safety check: PassMIT
Editaplotliushunqi8-hash/editaplot2026128—~5.8kAutomated safety check: PassApache-2.0
Setupmarketcalls/vectorbt-backtesting-skills208—~2kAutomated safety check: NotesNone
Ppt CompressorLeoYeAI/openclaw-master-skills2.2k—~3.9kAutomated safety check: PassMIT
Tdoc DOCXLeoYeAI/openclaw-master-skills2.2k—~3.6kAutomated safety check: NotesMIT

Similar skills

  • Scanned PDF To Epub

    longhaiqwe/scanned-pdf-to-epub

    A skill your agent uses when scanned Chinese PDFs or image-only books need text EPUB conversion on macOS, Windows, or Linux, especially when OCR text, original underlined proper names, 专名号, or…

    161 GitHub stars~1.9k tokensUpdated 26 days ago
    Documents & OfficeAuto-check passed
  • Editaplot

    liushunqi8-hash/editaplot2026

    Analyze local scientific CSV, TXT, XLS, or XLSX data; recommend publication-informed charts and Chinese scientific palettes; freeze a reproducible plan; and automate editable figures through a…

    128 GitHub stars~5.8k tokensUpdated 20 days ago
    Documents & OfficeAuto-check passed
  • Setup

    marketcalls/vectorbt-backtesting-skills

    Set up the Python backtesting environment. An agent skill from marketcalls/vectorbt-backtesting-skills.

    208 GitHub stars~2k tokensUpdated 3 mo ago
    Business, Finance & HRAuto-check: notes
  • Ppt Compressor

    LeoYeAI/openclaw-master-skills

    This skill should be used when the user wants to compress a PowerPoint (.pptx) file by reducing the size of embedded videos and large images.

    2.2k GitHub stars~3.9k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Tdoc DOCX

    LeoYeAI/openclaw-master-skills

    Word 文档全能处理技能 | Complete Word Document Processing Skill. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~3.6k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check: notes
  • Apple Container Test Runner

    RustPython/RustPython

    Runs RustPython tests inside a Linux container built with Apple's container CLI, so macOS users can compare Linux results with their local ones.

    22k GitHub stars~467 tokensUpdated today
    Testing & QAAuto-check passed

More from realspqrk/autorename-pdf

  • Rename Pdfs Exe

    realspqrk/autorename-pdf

    [Production] Rename PDF files using the compiled autorename-pdf-cli.exe.

    122 GitHub stars~529 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Rename Pdfs

What does Rename Pdfs do?

[Dev] Rename PDF files using AI (Python, requires venv). An agent skill from realspqrk/autorename-pdf. Rename Pdfs is an agent skill from realspqrk/autorename-pdf. [Dev] Rename PDF files using AI (Python, requires venv).

When should I use Rename Pdfs?

Rename Pdfs fits situations like: tasks that involve PDF; tasks that involve File organization.

How do I install Rename Pdfs in Claude Code?

Run `npx skills add realspqrk/autorename-pdf --skill rename-pdfs -a claude-code`. Or copy the skill folder (.claude/skills/rename-pdfs in realspqrk/autorename-pdf) into .claude/skills/rename-pdfs in your project. Claude Code loads it when a task matches its description.

How do I install Rename Pdfs in Codex?

Run `npx skills add realspqrk/autorename-pdf --skill rename-pdfs -a codex`. Or copy the skill folder (.claude/skills/rename-pdfs in realspqrk/autorename-pdf) into .agents/skills/rename-pdfs in your project. Codex loads it when a task matches its description.

Can I use Rename Pdfs in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add realspqrk/autorename-pdf --skill rename-pdfs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/rename-pdfs, .gemini/skills/rename-pdfs, .github/skills/rename-pdfs and .opencode/skills/rename-pdfs in your project.

What does Rename Pdfs need to run?

Going by SKILL.md and its folder, Rename Pdfs needs the command-line tools its instructions call (python). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Bash(python *), Bash(source *).

Does Rename Pdfs access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Rename Pdfs safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Rename Pdfs use?

Rename Pdfs is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Rename Pdfs use?

About 541 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Rename Pdfs?

Skills that share tags, products or a category with Rename Pdfs: Scanned PDF To Epub (longhaiqwe/scanned-pdf-to-epub, 161 stars), Editaplot (liushunqi8-hash/editaplot2026, 128 stars), Setup (marketcalls/vectorbt-backtesting-skills, 208 stars) and Ppt Compressor (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Rename Pdfs?

realspqrk (a GitHub user) maintains it in realspqrk/autorename-pdf, which has 122 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on September 10, 2026.

Source: realspqrk/autorename-pdf on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.