# Imprecise Names

> Imprecise Names is an Agent Skill for testing & quality published in the kubernetes-sigs/kueue repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Flag identifiers whose name does not describe exactly what they contain — drift from package patterns, contradictory contents, misnamed feature gates, asymmetric mirror fields.

- Skill name: `imprecise-names`
- Category: [Testing & Quality](https://www.openparable.com/skill/testing-quality/1)
- Source: https://github.com/kubernetes-sigs/kueue/blob/HEAD/cmd/experimental/skills/reviewer/code-style/imprecise-names/SKILL.md
- Repository: kubernetes-sigs/kueue (2,719 GitHub stars when collected)

## SKILL.md

# Skill: Imprecise Names

**Imprecise names** — every new identifier must describe exactly what it contains. A
reader should not be able to mistake it for something broader or narrower.

- Builder/wrapper methods that drift from the package's existing pattern (e.g. adding
  `AddLabel(k, v)` when the rest of the package uses `Label(k, v)`).
- Variables whose contents contradict the name — e.g. a set called
  `noMoreBorrowingCohorts` that actually contains cohorts which *are* still borrowing.
- Feature gates whose name does not match what they actually gate. A gate named
  `SkipFinalizersForServingWorkloads` that controls a different condition is a hard
  naming violation.
- Asymmetric mirror fields on a CRD — if `excludeResourcePrefixes` exists, the
  complement must be `includeResourcePrefixes`, not a freshly invented name.

---

Source: https://www.openparable.com/skill/testing-quality/imprecise-names (OpenParable). Cite the canonical URL above.
