# Encapsulate Paired Ops

> Encapsulate Paired Ops is an Agent Skill for development published in the kubernetes-sigs/kueue repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Review that paired operations and fields that always appear together are encapsulated in a helper or nested struct.

- Skill name: `encapsulate-paired-ops`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/kubernetes-sigs/kueue/blob/HEAD/cmd/experimental/skills/reviewer/encapsulate-paired-ops/SKILL.md
- Repository: kubernetes-sigs/kueue (2,719 GitHub stars when collected)

## SKILL.md

# Skill: Encapsulate Paired Operations and Fields

**Flag (operations):** Two function calls that always appear together (e.g., `subtractPendingResources` + `inadmissibleWorkloads.delete`, or `addPendingResources` + `inadmissibleWorkloads.insert`).

**Ask:** Wrap them in a single helper so callers cannot forget one half. The invariant should be enforced by the API, not by convention.

**Flag (fields):** Two struct fields that must always be set and cleared together (e.g., `inflight` + `inflightResources`).

**Ask:** Encapsulate them in a nested struct so they are updated atomically. This eliminates the "what if field A is nil but field B is not" inconsistency.

---

Source: https://www.openparable.com/skill/development/encapsulate-paired-ops (OpenParable). Cite the canonical URL above.
