dotstate
dotstate: Profile-Based Dotfile Manager
dotstate manages dotfiles by replacing them with symlinks to a Git repository, supporting multiple machine profiles and a common shared layer.
Navigation Rule
Use dotstate when:
- The user has a
~/.config/dotstate/directory - Files in
~are symlinks pointing to a dotstate storage directory - The user mentions syncing dotfiles across machines
Profile Rule
dotstate organizes files into profiles (per-machine, e.g., ubuntu, macos) and Common (shared across all profiles).
File classification:
- Common: files identical on all machines (e.g.,
gitconfig,zshenv,starship.toml) - Profile-specific: files with machine differences (e.g.,
zprofilewith CUDA paths on Ubuntu, Homebrew paths on macOS;npmrcwith OS-specific prefix paths)
More from fredericosantos/skills
astral-ruff
Guide for using ruff, the extremely fast Python linter and formatter. Use this when linting, formatting, or fixing Python code to maintain code quality and consistency.
35astral-uv
Guide for using uv, the extremely fast Python package and project manager. Use this when working with Python projects, scripts, packages, or tools to manage dependencies, environments, and project setup with universal lockfiles for reproducible builds.
18astral-ty
Guide for using ty, the extremely fast Python type checker and language server. Use this when type checking Python code or setting up type checking in Python projects.
17just-init
Navigate and document Python packages using __init__.py docstrings as living indexes: read them before exploring, update them after every file change.
12ghp
Guide for GitHub project management via `gh` CLI — issues, PRs, milestones, sub-issues, projects, and development workflow. Use this whenever you need to interact with GitHub issues, milestones, sub-issues, PRs, or projects. Also use when planning work, creating branches, structuring issues, or starting a development session on a repository.
2