OpenParable
Skip to content
← Back to skills

Imprecise Names

Testing & Quality
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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/kubernetes-sigs/kueue/blob/HEAD/cmd/experimental/skills/reviewer/code-style/imprecise-names/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/imprecise-names, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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.