Skip to content

gpsaggese/helpers / .claude/skills/coding.improve_code_for_humans

coding.improve_code_for_humans

Verified

Make the code more readable and debuggable

FileKindSize
SKILL.mdskill md827 B
---
description: Make the code more readable and debuggable
model: haiku
---

# Goal
The user will pass you one or more files `<FILES>` and you will make the code
more readable and debuggable for humans.

# Workflow

## Add Comments
- Improve code readability by adding concise comments.
- Follow the section `# Comments` from the file `.claude/skills/coding.rules.md`

## Add Debug Logging for Function Entry, Execution, and Results
- Track function execution by adding `_LOG.debug` statements.
- Follow the section `# Logging` from the file `.claude/skills/coding.rules.md`

# Conventions
- Do not change the behavior of the code in any way
- You must follow the rules in `.claude/skills/coding.rules.md`

# Verification
- [ ] Confirm the code's behavior is unchanged
- [ ] Run the file's unit tests to confirm nothing broke
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall