dots-add

Add config files to a dots repository and update symlinks.yml mappings.

Updated Jun 17, 2025
One-click install
npx skills add https://github.com/nikbrunner/dots --skill dots-add
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dots-add
Source: https://github.com/nikbrunner/dots/tree/main/common/.agents/skills/dots-add
Command: npx skills add https://github.com/nikbrunner/dots --skill dots-add

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool helps you incorporate a new configuration file into the dots repository and map it into the centralized symlink management system, ensuring consistency across platforms.

Core Features & Use Cases

  • Config integration: Copy and place a new home-directory config into the appropriate section (common, arch, macos) inside the dots tree.
  • Symlink mapping: Automatically update symlinks.yml to reference the new config path.
  • Validation & safety: Validate the source path, prevent overwriting existing dotfiles, and prompt for dependencies if needed.

Quick Start

Provide the path to an existing config file to add it into the dots repository, align it with a target section, and run the link process.

Frequently Asked Questions about dots-add

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a config file to a dotfiles repository for symlink management?

Adding a config file to a dotfiles repository for symlink management involves providing the source path and target section. The tool validates the path, copies the config into the dots tree, and updates symlinks.yml automatically.

What is the best way to organize cross-platform config files in a centralized repository?

The best way to organize cross-platform config files in a centralized repository is by mirroring local home directories into per-section config trees like common, arch, and macos. This approach maintains consistency across different operating systems.

How does symlink validation work when integrating new dotfiles?

Symlink validation when integrating new dotfiles checks the input source path to ensure the file is not already an existing dotfile symlink. This safety measure prevents accidental overwrites and maintains mapping integrity within symlinks.yml.

Can I use this tool to manage configs across different operating systems like arch and macos?

Yes, you can use this tool to manage configs across different operating systems like arch and macos. It supports categorizing files into platform-specific sections within the dots repository and updating symlinks accordingly.

What happens if I try to add a config file that is already an existing dotfile symlink?

If you try to add a config file that is already an existing dotfile symlink, the validation process blocks the action. This safety mechanism prevents overwriting existing dotfiles and protects your current configuration mappings.

Do I need to manually update symlinks.yml when adding new configuration files?

You do not need to manually update symlinks.yml when adding new configuration files. The automation tool records the new mapping automatically after validating the input path and copying the config into the repository.