skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
nweii/agent-stuff80 installs

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-naming
view source ↗

Is 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.extension or Description - 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

  1. Analyze files using OCR, text extraction, vision analysis, filename patterns
  2. Build the complete rename plan before taking any action
  3. Validate the plan: if any file cannot be mapped to a destination name, stop and report — do not proceed with partial results
  4. Validate the plan: confirm no two files share a destination name — if any collision exists, stop and report
  5. Present preview table: "Original Filename" | "New Filename" (show up to 15 files if many present; note any that couldn't be analyzed)
  6. Wait for confirmation before executing
  7. 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.

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>