Descriptive Image Filenames Checker
Audits image filenames in a codebase and suggests clearer, SEO-friendly names with updated references.
- Repository
- thedaviddias/Front-End-Checklist
- Stars
- 74,632
- Licence
- MIT
- Files
- 2 files
What it does
When installed, the agent scans a project's image references (HTML img tags, CSS url() rules, imports and public asset folders) and flags filenames that are auto-generated like IMG_1234.jpg, generic like image1.jpg, contain spaces, use underscores, or mix upper and lower case. It then suggests descriptive lowercase hyphenated names, can update references to the renamed files, and can write a migration script for large renames. It also explains why descriptive names help image search and team maintenance.
Great for
- Front-end developers tidying up a website's image folders before launch
- Teams that want consistent asset naming for SEO and easier maintenance
- Anyone auditing a site's image SEO basics
Skip it if
- Projects where filenames are fixed by external systems or CDNs, since renaming can break links and cached URLs
- Large asset libraries renamed in bulk without testing, since a migration script can miss dynamically built paths and break images
Try asking
- “Scan this project for image files with generic names like IMG_ or image1 and list their paths”
- “Suggest better filenames for the images in public/assets and update the references in my HTML and CSS”
- “Write a script that renames my images to lowercase hyphenated names and updates all imports”
Install in 3 steps
- 1
Download the skill
The ZIP contains the 2 original files, the MIT licence and an attribution note.
filename-quality.zip - 2
Add it to your agent
Claude Code (all projects)
mkdir -p ~/.claude/skills && unzip filename-quality.zip -d ~/.claude/skills/Claude Code / Agent SDK (this project only)
mkdir -p .claude/skills && unzip filename-quality.zip -d .claude/skills/Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.
- 3
Ask for the task
No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.
Get better results
- Review proposed renames before applying them, especially for images referenced from a CMS or database.
- Ask the agent to search for dynamically built image paths too, since simple text search can miss them.
- Keep the rule's SEO claims in perspective: filenames are one small signal among many for image search.
What's inside
- references/rule.md
- SKILL.md
Redistributed unmodified from thedaviddias/Front-End-Checklist under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.