Desafíos al crear una paleta de colores personalizada

Esto es extremadamente confuso. En la guía de estilo, las variables CSS etiquetadas usan guiones:

Mientras que en este (y otros) esquemas de ejemplo tienen guiones bajos:

Admito que no soy el más listo de la clase para codificar, y estoy seguro de que a las personas que han trabajado en esto durante mucho tiempo les resulta más obvio e intuitivo… pero intentar descifrar esto me hace sentir un poco loco.

Es realmente difícil tener una comprensión intuitiva de toda la lógica de cómo se utilizan los colores del modo claro y oscuro. Entre la multitud de archivos SCSS y transformaciones, JSON, la GUI de administración, las paletas que son (¿un tanto?) independientes de los temas…

Disculpen mi divagación, solo estoy teniendo algunas dificultades.