# Algorithm Comments

> Review that algorithm comments match the implementation. Use when a comment describes a formula or algorithm and you want to verify it matches what the code actually does.

- Skill: `kubernetes-sigs-kueue/algorithm-comments` (Agent Skill)
- Install (CLI): `npx get-skill add kubernetes-sigs-kueue/algorithm-comments`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kubernetes-sigs-kueue/algorithm-comments/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: Apache-2.0
- Author: kubernetes-sigs (https://skillmd.com/u/kubernetes-sigs-kueue)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/kubernetes-sigs-kueue/algorithm-comments

---


# Skill: Algorithm Comments Must Match the Implementation

**Flag:** A comment describing a mathematical formula or algorithm that doesn't match what the code actually does (e.g., comment says "ceiling" but code uses rounding via `int(x + 0.5)`).

**Ask:** Correct the comment to match the implementation, or fix the implementation to match the comment. A mismatch is a latent correctness bug — future maintainers will trust the comment over the code.

