Agent skill · software engineering · bighardperson
clean-code
Pragmatic coding standards for writing clean, maintainable code — naming, functions, structure, anti-patterns, and pre-edit safety checks. Use when writing new code, refactoring existing code, reviewing code quality, or establishing coding standards.
Why this skill is useful
Codifies naming conventions and function structure standards that the AI could infer but now doesn't have to guess.
What it needs
Requires clawhub installed locally. About 6k tokens when loaded. Last updated 2026-04-26. 34 stars on the source repository.
What this skill does
Clean Code Be concise, direct, and solution-focused. Clean code reads like well-written prose — every name reveals intent, every function does one thing, and every abstraction earns its place. Installation OpenClaw / Moltbot / Clawbot --- Core Principles Principle Rule Practical Test ----------- ------ ---------------- SRP Single Responsibility — each function/class does ONE thing "Can I describe what this does without using 'and'?" DRY Don't Repeat Yourself — extract duplicates, reuse "Have I written this logic before?" KISS Keep It Simple — simplest solution that works "Is there a simpler way to achieve this?" YAGNI You Aren't Gonna Need It — don't build unused features "Does anyone need this right now?" Boy Scout Leave code cleaner than you found it "Is this file better after my change?" --- Naming Rules Names are the most important documentation. A good name eliminates the need for a comment. Element Convention Bad Good --------- ------------ ----- ------ Variables Reveal intent n, d, tmp userCount, elapsed, activeUsers Functions Verb + noun user(), calc() getUserById(), calculateTotal() Booleans Question form active, flag isActive, hasPermission, canEdit Constants SCREAMINGSNAKE max, timeout MAXRETRYCOUNT, REQUESTTIMEOUTMS Classes Noun, singular Manager, Data UserRepository, OrderService Enums PascalCase values 'pending' string Status.Pending Rule: If you need a comment to explain a name, rename it. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills bighardperson/clean-code-review