CtrlK
BlogDocsLog inGet started
Tessl Logo

filename-quality

Use when reviewing image assets, markup, and CDN or build transforms related to Use descriptive image filenames. Check encoded size, rendered size, loading strategy, and above-the-fold impact together.

49

Quality

53%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/filename-quality/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured, actionable overview with a clean one-level reference, but it is held back by a missing verification loop for what is explicitly a batch rename across a codebase, plus duplicated rationale between the intro and Explain sections (and again in the reference). Dropping the misfit sizing/loading boilerplate would tighten it further.

Suggestions

Add an explicit verification step after the batch rename and reference updates (e.g., grep for old filenames to catch stale references, then rebuild or run tests) so the destructive/batch workflow has a feedback loop.

De-duplicate the SEO rationale: the intro paragraph, the Explain section, and the reference's "Why It Matters" all carry the same Google-filename text — keep it in one place and point to the reference.

Rewrite the Code Review section's "format choice, sizing, or loading behavior" phrasing to filename-specific criteria (generic names, spaces, underscores, mixed case) so it matches the rule it enforces.

DimensionReasoningScore

Conciseness

The body is mostly efficient, but the intro paragraph ("Google explicitly recommends descriptive filenames... A file named red-leather-wallet.jpg gives search engines context") and the Explain section ("Google explicitly states it uses filename as a signal... product-red-leather-wallet.jpg gives Google context") repeat the same SEO rationale nearly verbatim, and Check and Code Review overlap in scope. The Code Review section also carries misfit boilerplate ("format choice, sizing, or loading behavior") that earns nothing for a filename-naming rule.

3 / 5

Actionability

Check gives concrete scan targets ("<img src>, CSS url(), import statements, and public/assets directories") and five enumerated problem patterns with examples; Fix gives five concrete steps with a worked example ("rename IMG_1234.jpg to blue-running-shoes-side-view.jpg") and says to provide a migration script. Minor gaps: no commands are shown inline (grep/sed/migration script live only in references/rule.md), and the migration script is mentioned but never instantiated — mostly executable guidance with small gaps, appropriate for an instruction-only skill.

4 / 5

Workflow Clarity

The Check → Fix → Explain → Code Review sequence is readable and each section's steps are enumerated, but Fix is a batch operation ("Rename image files... Update all references to the renamed file in HTML, CSS, and JavaScript") with no validation or feedback step — nothing like grepping for stale references or rebuilding/testing after the rename. Per the rubric, a batch/destructive workflow without validation is capped at 3.

3 / 5

Progressive Disclosure

The body is a concise ~30-line overview (Quick Reference, Check, Fix) with a clearly signaled, one-level-deep pointer — "see `references/rule.md`" — and that file exists, contains the implementation details (batch rename script, reference-updating sed commands, CMS sanitiser), with no nested references. Not a 5 because the intro/Explain rationale is duplicated verbatim in the reference's "Why It Matters" section and the thin Code Review section is boilerplate, so the split is not perfectly clean.

4 / 5

Total

14

/

20

Passed

Description

46%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description has an explicit trigger clause but its substance is template boilerplate for image-delivery review that misrepresents this filename-naming skill and would collide with sibling image skills. It needs a rewrite that states the actual capability and filename-specific trigger terms.

Suggestions

Rewrite to state the actual capability, e.g., "Flags generic or auto-generated image filenames (image1.jpg, IMG_4532.jpg) and renames them to descriptive, lowercase, hyphen-separated names, updating all HTML/CSS/JS references. Use when reviewing image assets, filenames, or image SEO."

Remove the misfit boilerplate ("Check encoded size, rendered size, loading strategy, and above-the-fold impact together") that describes a different skill's scope.

Add natural trigger synonyms such as "image SEO", "naming convention", and "rename images" so users' actual phrasing matches.

DimensionReasoningScore

Specificity

Concrete actions are named ("reviewing image assets, markup, and CDN or build transforms"; "Check encoded size, rendered size, loading strategy, and above-the-fold impact"), but the listed actions describe generic image-delivery optimization, not this skill's actual capability — flagging and renaming generic image filenames and updating references. The core action of the skill never appears as an action, only as an embedded rule name.

3 / 5

Completeness

An explicit trigger is present ("Use when reviewing image assets..."), but the stated "what" — "Check encoded size, rendered size, loading strategy, and above-the-fold impact together" — misdescribes what the skill actually does, and the clause "related to Use descriptive image filenames" is a garbled verbatim rule-name insertion. The when is explicit; the what is misleading rather than merely imprecise, which sits at the level of a clear-but-incomplete pairing rather than anchor 4's "both present, when could be more specific".

3 / 5

Trigger Term Quality

Relevant keywords are present ("image assets", "image filenames", "markup", "CDN"), but common natural variations are missing — "image SEO", "naming convention", "rename images" — and the boilerplate terms ("encoded size", "rendered size", "loading strategy", "above-the-fold") pull toward the wrong trigger set for a filename-naming skill.

3 / 5

Distinctiveness Conflict Risk

Nearly the entire description is shared image-optimization boilerplate ("image assets, markup, and CDN or build transforms... encoded size, rendered size, loading strategy, and above-the-fold impact") that would equally fire sibling image-delivery skills; only the awkwardly embedded rule name "Use descriptive image filenames" distinguishes it, giving high overlap risk with many similar skills.

2 / 5

Total

11

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
thedaviddias/Front-End-Checklist
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.