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.
Source facts
- Repository
- hashintel/hash
- Last source activity
- September 1, 2026 at 07:54
- Detected SKILL.md language
- English
- Stars
- 1,666
- Forks
- 123
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- meaningful-identifiers
- description
- 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.
- license
- AGPL-3.0
- metadata
- {"triggers":{"type":"domain","enforcement":"suggest","priority":"low","keywords":["naming","rename","identifier","variable name"]}}
# Meaningful identifiers
Callback parameters and local variables must describe the value they hold.
## Rules
- Name array callback params after the element's domain type:
`batches.map((batch) => …)`, `bins.filter((bin) => …)`,
`checkpoints.find((checkpoint) => …)`. Never reuse `right`/`left`/`column`
for values that are not sort operands or table columns.
- Name `reduce` accumulators after what they accumulate: `sum`/`total` for a
running total, not `step`.
- Name percentile/ratio arguments for the quantity they represent
(`percentileRank`, `multiplier`), not an unrelated domain noun.
## Leave correct uses untouched
- Sort comparators: `(left, right) => left - right`.
- `(column) => column.key` over a real `.columns` array.
- `for (const row of …Rows)` where the items are genuinely rows.
View on GitHub