Agent skill
self-documenting-code
Use descriptive names for functions, variables, and classes that explain their purpose Use when documenting code and APIs. Documentation category skill.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/self-documenting-code
Metadata
Additional technical details for this skill
- category
- Documentation
- priority
- high
- is built in
- YES
- session guardian id
- builtin_self_documenting_code
SKILL.md
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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
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.
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.
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.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
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?