file-naming
Propose meaningful filenames from file contents and context. Use for renaming documents or creative files, or standardizing a folder’s filenames.
How do I install this agent skill?
npx skills add https://github.com/nweii/agent-stuff --skill file-namingIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill renames files by analyzing their content. It is functional and follows safe file-handling practices like no-clobber and user confirmation, but it possesses an indirect prompt injection surface due to processing untrusted file data.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
- Runlayerpass
1/3 files flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Rename Files
Analyze files and propose intelligent renames based on content type and metadata. Provide: a single file path, list of file paths, or folder path.
Naming Conventions
Transactional/Periodic Documents
Repetitive transactions (orders, receipts, invoices, appointments):
- Format:
YYYY-MM-DD Category Type - Details.extension - Example:
2025-06-13 Amazon Order 123-456 - USB Cable.pdf - Include: dates, entity names, order/invoice numbers, item descriptions
Periodic documents (statements, bills, forms):
- Format:
YYYY-MM Type - Entity.extension - Example:
2025-06 Bank Statement - Chase Checking.pdf - Example:
2023-12 W2 - Acme Corp.pdf
Ongoing agreements (contracts, policies):
- Format:
YYYY-MM Type - Entity.extension - Example:
2025-01 Service Agreement - Internet Provider.pdf
Appointments/visits:
- Format:
YYYY-MM-DD Type - Provider/Location.extension - Example:
2025-06-13 Dental Visit - Dr Johnson.pdf
Creative/Project Files
Date as supplementary (photos, projects, creative work):
- Format:
Description - Date.extensionorDescription - Context Date.extension - Example:
Vacation Photos - Hawaii 2025.jpg - Example:
Website Redesign - Draft 2025-06.pdf - Example:
Company Logo 2025.png
Evergreen content (manuals, references):
- Format:
Type - Name/Description.extension - Example:
Product Manual - Widget Pro.pdf
Key Principles
- ISO 8601 dates: YYYY-MM-DD (specific dates) or YYYY-MM (monthly/annual)
- Date placement: Start for time-critical sorting; end for contextual info
- Remove: Technical metadata (1080p, WEB-DL), problematic characters (
:*?"<>|#%&) - Keep: Scannable and sortable filenames
Process
- Analyze files using OCR, text extraction, vision analysis, filename patterns
- Build the complete rename plan before taking any action
- Validate the plan: if any file cannot be mapped to a destination name, stop and report — do not proceed with partial results
- Validate the plan: confirm no two files share a destination name — if any collision exists, stop and report
- Present preview table: "Original Filename" | "New Filename" (show up to 15 files if many present; note any that couldn't be analyzed)
- Wait for confirmation before executing
- Execute using no-clobber semantics — never overwrite an existing file; if a collision occurs at execution time, halt immediately
If content unclear: make best guess from filename, clean up existing name, or leave unchanged with note.
For TV show files, see references/tv-episodes.md for Plex/media manager naming conventions.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/nweii/agent-stuff/file-naming">View file-naming on skillZs</a>