Initial commit

skills/code-quality/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: code-quality
+description: Code quality guidelines. ALWAYS use skill for ANY code changes.
+---
+
+# 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