Menu
Clean up PDF filenames by removing spaces, em dashes, and special characters
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when the user wants to convert a project's `paper/` directory into a git submodule pointing at a separate paper repo (typically for Overleaf linking). Handles removing any existing tracked `paper/` content, adding the submodule, writing a standardized README inside the submodule, and updating the parent repo's README.
Create BibTeX entries from PDF papers and add to main.bib
Create a new Python script following project best practices. $ARGUMENTS
Create markdown summaries for PDF papers (creates BibTeX first if needed)
Clean README.md files in the entire repository or specified directories. $ARGUMENTS
Use when updating or replacing the writing style configuration for the paper-writing pipeline, targeting a new venue, audience, or style preferences.
| name | cleanup-pdf-names |
| description | Clean up PDF filenames by removing spaces, em dashes, and special characters |
| argument-hint | <path/to/directory> |
| disable-model-invocation | false |
Clean up PDF filenames for filesystem compatibility and consistency.
$ARGUMENTS
If $ARGUMENTS empty: Ask user for path (e.g., lit_review/papers/ or lit_review/papers/00-background/).
If $ARGUMENTS provided: Use path; resolve relative paths from project root.
_)—) → hyphen (-)–) → hyphen (-)' ' " ") → regular quotes (' ")Example preview:
Files to be renamed:
1. Biswas - 2023 - Role of Chat GPT.pdf
→ Biswas_-_2023_-_Role_of_Chat_GPT.pdf
2. Mello — 2024 — Denial.pdf
→ Mello_-_2024_-_Denial.pdf
Total: 2 files will be renamed
Run the cleanup script:
.claude/skills/cleanup-pdf-names/scripts/cleanup_pdf_names.sh "{directory_path}"
Report the summary from the script output:
| Character | Replacement |
|---|---|
Space ( ) | Underscore (_) |
Em dash (—) | Hyphen (-) |
En dash (–) | Hyphen (-) |
Left single quote (') | Single quote (') |
Right single quote (') | Single quote (') |
Left double quote (") | Double quote (") |
Right double quote (") | Double quote (") |
| Accented chars (á, é, ñ, ü, etc.) | ASCII equivalents (a, e, n, u) |
Skip the file and report it. Do not overwrite existing files.
Report "No PDF files found in directory" and stop.
Report the specific file that failed and continue with remaining files.