Code comments

SkillDocs & knowledge

Use while implementing or reviewing edge cases, failure paths, or unexpected behavior to document the non-obvious constraints in code. Also use when asked to add or improve code comments.

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Code comments skill

What this skill tells your AI

The instructions your AI receives, as published by bholmesdev/hubble.md in .agents/skills/code-comments/SKILL.md and read by ahel’s review.

When implementing edge cases, failure paths, or unexpected behavior, always document why that code was written.

  • Use the codebase's terms in plain English.
  • Skip comments when a clear name or small code change makes the behavior obvious.
  • Do not restate conditions, narrate the PR or conversation, or describe behavior that has not been verified.

Signals

GitHub stars
1k
Forks
95
Last commit
Sep 2026
Advanced
Item type
skill
Key
code-comments
Source
github.com/bholmesdev/hubble.md