file-naming_skill

Overview

This skill analyzes file content and proposes context-aware, standardized filenames to make documents scannable and sortable. It applies date-first conventions for transactional and periodic files and content-first conventions for creative or evergreen items. The goal is cleaner downloads, consistent archives, and easier search and sorting. It presents safe, reversible rename suggestions and waits for confirmation before making changes.

How this skill works

The skill inspects file contents using OCR, text extraction, and basic vision analysis, and also considers existing filename patterns and metadata. It classifies files into transactional/periodic, creative/project, or evergreen categories and generates new names using ISO 8601 dates where appropriate. It returns a preview table mapping original names to proposed names, flags unanalyzable files, and limits previews to 15 items for large folders. It does not rename files until you confirm the suggested changes.

When to use it

• Organizing a messy Downloads or Desktop folder
• Standardizing company or personal document archives
• Preparing files for backup or migration
• Cleaning up receipts, invoices, and bank statements
• Renaming creative projects, photos, and design drafts

Best practices

• Prefer ISO 8601 dates (YYYY-MM-DD or YYYY-MM) for time-sensitive documents
• Start filenames with the date for transactional/periodic items to enable chronological sorting
• Use descriptive, content-first names for photos, drafts, and evergreen references
• Strip technical metadata tokens (1080p, WEB-DL) and problematic characters (:*?"<>|#%&)
• Review the preview table and confirm renames; keep originals until you’re satisfied

Example use cases

• Rename a folder of mixed bank statements, receipts, and invoices to YYYY-MM or YYYY-MM-DD formats
• Clean a downloads folder by turning vague names into content-first titles for creative files
• Standardize ongoing contracts and policies to YYYY-MM Type - Entity.extension
• Convert camera roll files into Description - Date.jpg for photo archives
• Prepare a project folder by renaming drafts and exports to clear, consistent labels