good-practices
Installation
SKILL.md
Naming Conventions
- camelCase for variables, functions, methods, and parameters
- PascalCase for classes, interfaces, types, and enums
- All code and comments must be in English
- Names must reveal intent:
getUserByIdinstead ofget,calculateTotalPriceinstead ofcalc - Boolean variables/methods use prefixes:
isActive,hasPermission,canEdit,shouldRetry - Avoid cryptic abbreviations:
transactioninstead oftx,configurationinstead ofcfg - Collections should be plural:
users,orderItems,activeConnections
Documentation
- Every method must have JSDoc comments including:
- Description of what the method does
@paramtags with types and descriptions for all parameters@returnstag with type and description of the return value@throwstag documenting any exceptions the method may throw
Example: