Desafios na criação de uma paleta de cores personalizada

Isso é extremamente confuso. No guia de estilo, as variáveis CSS rotuladas usam hifens:

Enquanto neste (e em outros) esquemas de exemplo eles têm underscores:

Admito que não sou o mais inteligente em codificação, e tenho certeza de que as pessoas que trabalharam nisso por muito tempo acham mais óbvio e intuitivo… mas tentar analisar isso parece que estou ficando um pouco louco.

É realmente difícil ter uma compreensão intuitiva de toda a lógica de como as cores dos modos claro e escuro são usadas. Entre a multiplicidade de arquivos SCSS e transformações, JSON, GUI de administração, paletas que são (um tanto?) independentes de temas…

Desculpe pelo meu desabafo, apenas estou tendo um pouco de dificuldade aqui.