Imprecise Names
Testing & Qualityimprecise-namesImprecise 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.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- 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 usesLabel(k, v)). - Variables whose contents contradict the name — e.g. a set called
noMoreBorrowingCohortsthat actually contains cohorts which are still borrowing. - Feature gates whose name does not match what they actually gate. A gate named
SkipFinalizersForServingWorkloadsthat controls a different condition is a hard naming violation. - Asymmetric mirror fields on a CRD — if
excludeResourcePrefixesexists, the complement must beincludeResourcePrefixes, not a freshly invented name.