Chezmoi Creator

This skill is an operating guide for creating and maintaining chezmoi-managed dotfile repositories.

Default assumption: the user wants a working source state, not a broad tutorial. Prefer producing or modifying concrete chezmoi files over explaining the tool abstractly.

Mandatory planning

Before creating or changing chezmoi-managed files, make a concise plan that covers:

• target platforms: Linux, macOS, Windows, Codespaces, or a subset
• target files and directories to manage
• whether each target should be a regular file, template, symlink, script, create file, modify file, or external
• whether secrets, encryption, or machine-specific data are involved
• whether hooks are needed, or whether a normal chezmoi script is sufficient

If secrets or sensitive data are involved, load references/security-practices.md before designing the source state.

Installation and local-project mode