# Dev Code Quality

> Code Quality Standards. Use it everytime you plan or implement any code.

- Skill: `majiayu000/dev-code-quality` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/dev-code-quality`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/dev-code-quality/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/dev-code-quality

---


# Universal Code Quality Standards

## Naming Conventions (adapt to language case style)

- Classes/Types: nouns that represent concepts
- Functions/Methods: verbs that describe actions
- Booleans: questions (is/has/can/should)
- Constants: descriptive, not abbreviated
- Avoid: abbreviations, single letters (except i,j for loops), mental mapping

## Function Design

- Single responsibility
- Maximum 3-4 parameters
- One level of abstraction
- No side effects unless name indicates
- Early returns for guard clauses
- Pure functions when possible

## Code Organization

- Group related code together
- Order: public before private
- Most important/high-level code first
- Dependencies at top

## Comments

- Why, not what (code explains what)
- Explain non-obvious business rules
- Document gotchas and workarounds
- Keep comments updated with code
- Prefer self-documenting code over comments

## Error Handling

- Fail fast, fail clearly
- Specific error types
- Include context in error messages
- Don't swallow exceptions
- Log appropriately

## Magic Numbers

- Extract to named constants
- Explain the meaning, not just the value