meaningful-identifiers

Naming guidance for callback parameters and local variables in TypeScript. Use when writing or refactoring loops, array callbacks (map/filter/find/reduce), or local accumulators.

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

100%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.

An exemplar of a tight, single-purpose naming skill: concrete code patterns, no padding, and well-organized sections that fit comfortably in the SKILL.md body without external references.

Dimension	Reasoning	Score
Conciseness	Lean and efficient with no over-explanation of concepts Claude already knows; every line delivers a concrete rule or example and assumes Claude's competence.	5 / 5
Actionability	Provides concrete, executable code patterns (batches.map((batch) => …), sum/total, (left, right) => left - right, (column) => column.key) that cover the common naming cases directly.	5 / 5
Workflow Clarity	As a simple single-purpose skill the guidance is unambiguous: apply the naming rules and leave the listed correct uses untouched, with no destructive or batch operations requiring validation checkpoints.	5 / 5
Progressive Disclosure	Under 50 lines with no need for external references, organized into clear sections (Rules, Leave correct uses untouched) that make navigation trivial.	5 / 5
	Total	20 / 20 Passed

Description

87%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.

A concise, well-targeted description that clearly answers both what the skill does and when to apply it, with concrete trigger constructs. The only minor weakness is keyword coverage that omits natural synonyms like "rename" and "variable name".

Suggestions

Add natural synonyms such as "rename" or "variable name" to the description to broaden trigger-term coverage beyond the metadata keywords.

Consider naming the action more concretely (e.g., "Name or rename callback parameters...") so the verb reads as a distinct action rather than abstract "guidance".

Dimension	Reasoning	Score
Specificity	Names the domain (TypeScript callback parameter and local variable naming) and concrete constructs like map/filter/find/reduce and accumulators, listing several specific contexts with only minor coverage gaps.	4 / 5
Completeness	Explicitly states what it does ("Naming guidance for callback parameters and local variables in TypeScript") and when to use it via a concrete "Use when..." clause covering loops, array callbacks, and local accumulators.	5 / 5
Trigger Term Quality	Includes natural terms users would say (loops, array callbacks, map/filter/find/reduce, refactoring, accumulators), though synonyms like "rename" or "variable name" that appear in the metadata keywords are absent from the description.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (TS callback/variable naming) with distinct triggers tied to specific array methods, giving it minimal overlap risk with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

87%

Warnings & errors only

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

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
metadata_field	'metadata' should map string keys to string values	Warning

	Total	14 / 16 Passed

Repository: hashintel/hash
Path: .agents/skills/meaningful-identifiers/SKILL.md
Commit: a6f5727

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.