# self-documenting-code

> Use descriptive names for functions, variables, and classes that explain their purpose Use when documenting code and APIs. Documentation category skill.

- Author: OmniaffixDave
- Repository: OmniaffixDave/SessionGuardian
- Version: 20260205125233
- Stars: 0
- Forks: 1
- Last Updated: 2026-02-08
- Source: https://github.com/OmniaffixDave/SessionGuardian
- Web: https://mule.run/skillshub/@@OmniaffixDave/SessionGuardian~self-documenting-code:20260205125233

---

---
name: self-documenting-code
description: Use descriptive names for functions, variables, and classes that explain their purpose Use when documenting code and APIs. Documentation category skill.
metadata:
  category: Documentation
  priority: high
  is-built-in: true
  session-guardian-id: builtin_self_documenting_code
---

# Self-Documenting Code

Use descriptive names for functions, variables, and classes that explain their purpose. Extract complex expressions into well-named variables. Break complex functions into smaller, named functions. Choose clear names over abbreviations. If you need to write a comment explaining what code does, first try to rewrite the code to be clearer. Reserve comments for explaining why, not what.