# API Field Comments

> Review that new CRD fields have complete godoc comments with enum value descriptions.

- Skill: `kubernetes-sigs-kueue/api-field-comments` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kubernetes-sigs-kueue/api-field-comments`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kubernetes-sigs-kueue/api-field-comments/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- License: Apache-2.0
- Author: kubernetes-sigs (https://skillmd.com/u/kubernetes-sigs-kueue)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/kubernetes-sigs-kueue/api-field-comments

---


# Skill: New API Fields Need Complete Comments

**Flag:** A new CRD field in `apis/kueue/` is added with no godoc comment, a one-word comment, or a comment that references modes or values not yet implemented in this PR.

**Ask:**
- Every new field needs a comment explaining its purpose and effect.
- Enum-like string fields must explicitly list all valid values and their semantics: "Possible values are: X (does …), Y (does …)."
- Don't mention unsupported or planned-but-not-yet-implemented values — iterate the comment as values are added in future PRs to avoid misleading users about what the API currently supports.