refactor-semantic-noise
Audit semantic noise and namespace integrity.Produces a severity-grouped report with namespace/rename suggestions.
When & Why to Use This Skill
This Claude skill specializes in auditing codebases for semantic noise and namespace integrity. It automatically identifies redundant naming conventions, such as repetitive prefixes or suffixes, and detects 'import stutter' where taxonomy is unnecessarily crammed into identifiers. By generating a severity-grouped report with specific renaming suggestions, it helps developers maintain clean, readable, and well-structured code, ensuring that naming boundaries align with the underlying software architecture.
Use Cases
- Legacy Code Cleanup: Identifying and removing redundant prefixes or suffixes in older projects to modernize naming conventions and improve readability.
- Automated Code Audits: Checking for namespace integrity and 'import stutter' during the code review process to ensure identifiers remain concise and meaningful.
- Architectural Alignment: Detecting missing structural boundaries by analyzing naming clusters and suggesting renames that better reflect the system's taxonomy and boundaries.
| name | refactor-semantic-noise |
|---|---|
| license | MIT |
| description | | |
| author | Jordan Godau |
Instructions
Read all references in references/ before using this skill.
Signals
- Reviewing naming for redundant prefixes/suffixes
- Import stutter or taxonomy crammed into identifiers
- Missing structural boundaries indicated by naming clusters
- The user asks to "audit naming" or "check namespace integrity"
References
Directory: references/
01_GOAL.md02_DEFINITIONS.md03_INVARIANTS.md04_SCOPE.md05_CHECKS.md06_OUTPUT.md