file-naming
Propose meaningful filenames from file contents and context. Use for renaming documents or creative files, or standardizing a folder’s filenames.
- Installs
- 80
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/nweii/agent-stuff --skill file-naming- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads file-naming automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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.
FAQ
What does the file-naming skill do?
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 file-naming?
Run npx skills add https://github.com/nweii/agent-stuff --skill file-naming in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/file-naming/ (personal) or .claude/skills/file-naming/ (project).
Which AI agents can use file-naming?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is file-naming safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains file-naming?
It is published by nweii in nweii/agent-stuff. It has 80 recorded installs.
More from nweii/agent-stuff
suggest-lucide-icons
nweii/agent-stuff
Pick Lucide icons for a concept, UI placement, or vault note. Searches the full Lucide catalog for real, verified icon names. Use when the user says 'what icon for X', 'suggest a Lucide icon', 'pick an icon', or needs an icon for note frontmatter, a button, or a section header.
obsidian-templater
nweii/agent-stuff
Open the skill to read its SKILL.md instructions.
validating-startup-ideas
nweii/agent-stuff
Find and validate startup ideas by mining user complaints, crafting premises, and navigating the idea maze. Use when discovering product opportunities, validating ideas, shaping solutions, researching user pain points, or exploring what to build.
culinary-assistant
nweii/agent-stuff
Culinary guidance for cooking, recipes, and meal planning. Use for kitchen techniques, substitutions, and format conversion (Mela, Schema.org). Handles recipe parsing and improvements.
Popular media & creative skills
hyperframes
heygen-com/hyperframes
Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
media-use
heygen-com/hyperframes
Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
hyperframes-registry
heygen-com/hyperframes
About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.
hyperframes-creative
heygen-com/hyperframes
Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.
ai-video-generation
101-skills/superpowers
Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse
ai-image-generation
101-skills/superpowers
Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image