Menu
Use when linking generated Black Atom themes to Nik's dotfiles via theme-link.sh, or after adding a new adapter that needs dotfile integration.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Monitor app conventions — routing, queries, components, core/monitor boundary. Load when working in monitor/.
Use when navigating the core codebase, understanding component structure, theme definitions, color utilities, or the type system.
Use when creating a new adapter for a platform to support Black Atom themes. Covers research, token mapping, template creation, and verification.
Use when creating a new theme in an existing collection. Covers collaborative design, palette extraction, core definition, adapter configs, and generation.
Use when renaming a theme across all repositories. Handles core type updates, adapter configs, file renames, generation, and coordinated commits.
Use when developing new theme concepts, researching color inspiration, or refining existing themes. Covers color research, palette development, and collection fit assessment.
| name | nik-link-themes-to-dots |
| description | Use when linking generated Black Atom themes to Nik's dotfiles via theme-link.sh, or after adding a new adapter that needs dotfile integration. |
After generating themes with Black Atom adapters, link them to your dotfiles for use.
Dotfiles repo: ~/repos/nikbrunner/dots
Theme linker: ~/repos/nikbrunner/dots/scripts/theme-link.sh
The script creates relative symlinks, not absolute ones. This is critical because:
Example symlink structure:
dots/arch/.config/waybar/themes/black-atom-terra-winter-night.css
-> ../../../../../black-atom-industries/waybar/themes/black-atom-terra-winter-night.css
| Adapter | Extension | Dots Target |
|---|---|---|
| ghostty | conf | common/.config/ghostty/themes |
| wezterm | toml | common/.config/wezterm/colors |
| zed | json | common/.config/zed/themes |
| niri | kdl | arch/.config/niri/themes |
| waybar | css | arch/.config/waybar/themes |
Dry run (preview changes):
~/repos/nikbrunner/dots/scripts/theme-link.sh --dry-run
Apply symlinks:
~/repos/nikbrunner/dots/scripts/theme-link.sh
When a new Black Atom adapter is created, update theme-link.sh:
~/repos/nikbrunner/dots/scripts/theme-link.shprocess_adapter call at the end:
process_adapter "<adapter-name>" "<file-extension>" "<dots-target-path>"
--dry-run to verifyls -la ~/repos/nikbrunner/dots/<target-path>/