Agent skill
code-over-comments
If you need a comment to explain what code does, first try to rewrite the code to be self-explana... Use when enforcing code quality standards. Quality category skill.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/code-over-comments
Metadata
Additional technical details for this skill
- category
- Quality
- priority
- medium
- is built in
- YES
- session guardian id
- builtin_code_over_comments
SKILL.md
Code Over Comments
If you need a comment to explain what code does, first try to rewrite the code to be self-explanatory. Extract complex expressions into well-named variables. Split complex functions into smaller ones with descriptive names. Comments are valuable for explaining WHY something is done (business context, non-obvious constraints), but WHAT the code does should be clear from the code itself.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?