# Code Quality

> Code quality guidelines. ALWAYS use skill for ANY code changes.

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

---


# Code Quality Guidelines

## Don't write forgiving code

- Don't permit multiple input formats
    - In TypeScript, this means avoiding Union Type (the `|` in types)
- Use preconditions
    - Use schema libraries
    - Assert that inputs match expected formats
    - When expectations are violated, throw, don't log
- Don't add defensive try/catch blocks
    - Usually we let exceptions propagate out
- Don't keep legacy code paths as fallbacks
    - Remove old code instead of keeping it around for compatibility

## Naming Conventions

- Don't use abbreviations or acronyms
    - Choose `number` instead of `num` and `greaterThan` instead of `gt`

## File Management

- Prefer editing an existing file to creating a new one
- Confirm with the user before creating any new markdown files

## Style

- Emoji and unicode characters are welcome
    - Use them at the beginning of comments, commit messages, and in headers in docs