concise-code

Concise Code - Clean Code Quick Reference

A standardized OpenClaw Skill providing quick reference for "Clean Code" by Robert C. Martin (Uncle Bob).

Overview

This skill helps developers write clean, maintainable code by providing guidelines and checklists for:

• Meaningful naming
• Function design
• Comments strategy
• Code formatting
• Unit testing
• Code smells detection

Installation

For OpenClaw/QClaw Users

Copy the skill to your OpenClaw skills directory:

# Windows
xcopy /E /I concise-code %USERPROFILE%\.qclaw\workspace\skills\concise-code\

# Or manually copy SKILL.md to:
# D:\software\QClaw\resources\openclaw\config\skills\concise-code\

For SkillHub

skillhub install concise-code

Usage

Trigger this skill with keywords:

• clean code
• naming rules
• function design
• code smells
• refactoring
• best practices

Core Principles

The Boy Scout Rule

Leave the campground cleaner than you found it.

Simple Design Rules (Priority Order)

1. Run all tests
2. Eliminate duplication (DRY)
3. Increase expressiveness
4. Minimize classes and methods

Quick Reference

Naming

Functions

• Small: < 20 lines
• Do one thing
• Arguments: 0 best, avoid 3+
• No side effects

Comments

• Write: Legal info, intent explanation, warnings, TODO
• Avoid: Redundant, misleading, commented-out code

Golden Rule: Use code to explain. Comments cannot beautify bad code.

File Structure

concise-code/
├── SKILL.md          # Main skill file (OpenClaw standard format)
└── README.md         # This file

Reference

• Book: Clean Code: A Handbook of Agile Software Craftsmanship
• Author: Robert C. Martin (Uncle Bob)
• Publisher: Prentice Hall, 2008

License

MIT License - Feel free to use and distribute.

Contributing

Pull requests welcome! Please maintain the OpenClaw skill format.