[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CC603KB0TT7JPCEQP6PZX4":3,"skill-same:01M6CC603KB0TT7JPCEQP6PZX4":90},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":38,"linkOnly":39,"markdownContent":40,"markdownBody":41,"frontMatter":42,"refName":43,"commitSha":44,"skillDirectory":45,"forksCount":46,"repositoryHtmlUrl":47,"repositoryHomepageUrl":6,"ownerHtmlUrl":48,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":49,"install":50,"resources":63},"01M6CC603KB0TT7JPCEQP6PZX4","chezmoi-config",null,"This skill should be used when the user asks about chezmoi dotfile management, creating, modifying, or maintaining dotfile templates, configuration files, scripts, and external resources. Use when the user asks to \"create a chezmoi template\", \"add a .tmpl file\", \"write Go template syntax\", \"manage .chezmoi.toml.tmpl\", \"configure .chezmoiexternal\", \"write run_once\u002Frun_onchange scripts\", \"integrate 1Password with chezmoi\", \"add password manager to dotfiles\", \"manage cross-platform configs\", or \"add OS-conditional logic\". Also use when editing .chezmoidata files or working with chezmoi template variables.","ray-manaloto\u002Fmacos-development-environment","ray-manaloto","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F227192835?v=4","01M6CBR7J13ZA01X5YB1A1QRJP","01M6CBR7P0S3NS8ZV81JYNST14",1,"MIT","https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fchezmoi-toolkit\u002Fskills\u002Fchezmoi-config\u002FSKILL.md",[],[18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37],"chezmoi config","config","chezmoi","template","files","integrate","use","management","write","editing","syntax","password","go","configure","dotfiles","templates","file","run","create","1password","2026-11-10 10:12:30",false,"---\nname: chezmoi-config\ndescription: >\n  This skill should be used when the user asks about chezmoi dotfile management,\n  creating, modifying, or maintaining dotfile templates, configuration files, scripts, and external\n  resources. Use when the user asks to \"create a chezmoi template\", \"add a .tmpl\n  file\", \"write Go template syntax\", \"manage .chezmoi.toml.tmpl\", \"configure\n  .chezmoiexternal\", \"write run_once\u002Frun_onchange scripts\", \"integrate 1Password\n  with chezmoi\", \"add password manager to dotfiles\", \"manage cross-platform\n  configs\", or \"add OS-conditional logic\". Also use when editing .chezmoidata\n  files or working with chezmoi template variables.\n---\n\n# Chezmoi Configuration Management\n\nComprehensive guide for managing chezmoi dotfiles with templates, scripts, external resources, and advanced configurations.\n\n## ⚠️ Safety Constraints\n\n**This skill is READ-ONLY and validation-only. It MUST NOT modify your actual environment.**\n\n### Forbidden Operations\n\nNEVER execute these commands - they will modify your system:\n- `chezmoi apply` - Applies changes to your home directory\n- `chezmoi apply --force` - Forcefully applies changes\n- `chezmoi update` - Updates source state and may change managed files\n- Any operations that directly execute scripts (scripts run automatically during `chezmoi apply`)\n\n### Allowed Safe Operations\n\nONLY use these read-only validation commands:\n- `chezmoi diff` - Preview what would change (safe)\n- `chezmoi apply --dry-run` - Simulate changes without applying (safe)\n- `chezmoi doctor` - Check configuration validity (safe)\n- `chezmoi data` - Display template data variables (safe)\n- `chezmoi managed` - List files currently managed by chezmoi (read-only, safe)\n- `chezmoi unmanaged` - List files currently unmanaged by chezmoi (read-only, safe)\n- `chezmoi ignored` - List files ignored by chezmoi (read-only, safe)\n- `chezmoi execute-template \u003C file.tmpl` - Preview expanded template output (safe)\n- `chezmoi state dump` - View script execution state (safe)\n- `chezmoi verify` - Verify source state integrity (safe)\n- `chezmoi cd` - Enter source directory (safe)\n- `chezmoi source-path` - Show source directory path (safe)\n\n### User Responsibility\n\nThis skill helps you **create and validate** chezmoi configurations. To apply changes, **you must manually run** `chezmoi apply` in your terminal after reviewing the output.\n\n## Quick Start\n\n### Creating a New Template\n\n1. **Add existing file as template:**\n   ```bash\n   chezmoi add --template ~\u002F.gitconfig\n   ```\n\n2. **Or create manually:**\n   ```bash\n   chezmoi cd\n   $EDITOR dot_gitconfig.tmpl\n   ```\n\n3. **Use Go template syntax:**\n   ```go\n   [user]\n       name = {{ .name }}\n   {{- if eq .chezmoi.os \"darwin\" }}\n   [credential]\n       helper = osxkeychain\n   {{- end }}\n   ```\n\n### Managing External Resources\n\nCreate `.chezmoiexternal.toml.tmpl`:\n\n```toml\n[\".oh-my-zsh\"]\n    type = \"archive\"\n    url = \"https:\u002F\u002Fgithub.com\u002Fohmyzsh\u002Fohmyzsh\u002Farchive\u002Fmaster.tar.gz\"\n    exact = true\n    stripComponents = 1\n```\n\n### Writing Scripts\n\nCreate `run_onchange_install-packages.sh.tmpl`:\n\n```bash\n{{ if eq .chezmoi.os \"darwin\" -}}\n#!\u002Fbin\u002Fbash\nbrew install git vim ripgrep\n{{ end -}}\n```\n\n## Reference Documentation\n\nThis skill includes comprehensive reference documentation. Consult these guides for detailed information:\n\n- **[template-syntax.md](references\u002Ftemplate-syntax.md)** - Go template syntax, variables, conditionals, loops, and examples\n- **[external-files.md](references\u002Fexternal-files.md)** - .chezmoiexternal configuration for files, archives, and git repositories\n- **[ignore-files.md](references\u002Fignore-files.md)** - .chezmoiignore\u002F.chezmoiignore.tmpl patterns, templates, and scope\n- **[password-managers.md](references\u002Fpassword-managers.md)** - Integrating 20+ password managers (1Password, Bitwarden, Vault, etc.)\n- **[scripts.md](references\u002Fscripts.md)** - run_once, run_onchange, run_before, run_after scripts\n- **[advanced-configuration.md](references\u002Fadvanced-configuration.md)** - .chezmoi.toml, prompting, encryption, and advanced features\n\n## Common Tasks\n\n### 1. Create Platform-Specific Configuration\n\n**Template file (dot_gitconfig.tmpl):**\n```go\n[user]\n    name = {{ .name }}\n    email = {{ .email }}\n\n{{- if eq .chezmoi.os \"darwin\" }}\n[credential]\n    helper = osxkeychain\n{{- else if eq .chezmoi.os \"linux\" }}\n[credential]\n    helper = cache\n{{- end }}\n```\n\n**Configuration (chezmoi.toml):**\n```toml\n[data]\n    name = \"John Doe\"\n    email = \"john@example.com\"\n```\n\n### 2. Manage Secrets with Password Managers\n\n```go\n{{- if (bitwarden \"github\") }}\n[github]\n    token = {{ (bitwarden \"github\").login.password }}\n{{- end }}\n```\n\n### 3. Install Packages Conditionally\n\n**run_onchange_install-packages.sh.tmpl:**\n```bash\n{{ if eq .chezmoi.os \"darwin\" -}}\n#!\u002Fbin\u002Fbash\nbrew bundle --file=\u002Fdev\u002Fstdin \u003C\u003CEOF\n{{ range .packages.darwin.brews -}}\nbrew \"{{ . }}\"\n{{ end -}}\nEOF\n{{ else if eq .chezmoi.os \"linux\" -}}\n#!\u002Fbin\u002Fbash\nsudo apt install -y {{ range .packages.linux }}{{ . }} {{ end }}\n{{ end -}}\n```\n\n**.chezmoidata\u002Fpackages.yaml:**\n```yaml\ndarwin:\n  brews:\n    - git\n    - vim\n    - ripgrep\n\nlinux:\n  - git\n  - vim\n  - ripgrep\n  - fd-find\n```\n\n### 4. Include External Resources\n\n**.chezmoiexternal.toml.tmpl:**\n```toml\n[\".vim\u002Fautoload\u002Fplug.vim\"]\n    type = \"file\"\n    url = \"https:\u002F\u002Fraw.githubusercontent.com\u002Fjunegunn\u002Fvim-plug\u002Fmaster\u002Fplug.vim\"\n\n[\".oh-my-zsh\"]\n    type = \"archive\"\n    url = \"https:\u002F\u002Fgithub.com\u002Fohmyzsh\u002Fohmyzsh\u002Farchive\u002Fmaster.tar.gz\"\n    exact = true\n    stripComponents = 1\n    refreshPeriod = \"168h\"\n\n[\".local\u002Fbin\u002Fage\"]\n    type = \"archive-file\"\n    url = \"https:\u002F\u002Fgithub.com\u002FFiloSottile\u002Fage\u002Freleases\u002Fdownload\u002Fv1.1.1\u002Fage-v1.1.1-{{ .chezmoi.os }}-{{ .chezmoi.arch }}.tar.gz\"\n    path = \"age\u002Fage\"\n    executable = true\n```\n\n### 5. Configure Interactive Prompts\n\n**.chezmoi.toml.tmpl:**\n```toml\n{{- $editor := promptChoice \"favorite editor\" [\"vim\" \"neovim\" \"vscode\"] -}}\n[data]\n    name = \"{{ promptString \"your name\" }}\"\n    email = \"{{ promptString \"your email\" }}\"\n    editor = {{ $editor }}\n\n{{ if promptBool \"enable work config?\" -}}\n[data.work]\n    enabled = true\n    work_email = \"{{ promptString \"work email\" }}\"\n{{ end }}\n```\n\n### 6. Ignore Files Conditionally\n\n**.chezmoiignore (template-aware):**\n```text\nREADME.md\n*.log\n\n{{- if ne .chezmoi.hostname \"work-laptop\" }}\n.work\n{{- end }}\n\n{{- if eq .chezmoi.os \"windows\" }}\nDocuments\u002F*\n!Documents\u002F*PowerShell\u002F\n{{- end }}\n```\n\n### 7. Interpret `chezmoi managed` \u002F `chezmoi unmanaged` Output (Config Files)\n\nWhen reviewing `chezmoi unmanaged`, note that the *destination* config file is `~\u002F.config\u002Fchezmoi\u002Fchezmoi.toml`, while the *source* is typically managed as a template such as `dot_config\u002Fchezmoi\u002Fchezmoi.toml.tmpl` (or `private_dot_config\u002Fchezmoi\u002Fchezmoi.toml.tmpl`) in the chezmoi source state.\n\nIf `~\u002F.config\u002Fchezmoi` appears as unmanaged:\n- First check `chezmoi managed` to confirm whether the config file is already managed in source.\n- If it is not managed, add it as a template and manage it in source (recommended when you maintain machine-specific values in `chezmoi.toml`).\n\n### 8. Manage run_once Scripts\n\n**run_once_000-bootstrap.sh.tmpl:**\n```bash\n#!\u002Fbin\u002Fbash\n{{ if eq .chezmoi.os \"darwin\" -}}\nif ! command -v brew &> \u002Fdev\u002Fnull; then\n    \u002Fbin\u002Fbash -c \"$(curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FHomebrew\u002Finstall\u002FHEAD\u002Finstall.sh)\"\nfi\n{{ end -}}\n```\n\n**Reset run_once state:**\n```bash\n# Clear all run_once script state\nchezmoi state delete-bucket --bucket=scriptState\n```\n\n## Built-in Variables\n\nCommonly used chezmoi variables available in all templates:\n\n| Variable | Description | Example |\n|----------|-------------|---------|\n| `.chezmoi.os` | Operating system | `linux`, `darwin`, `windows` |\n| `.chezmoi.arch` | Architecture | `amd64`, `arm64` |\n| `.chezmoi.hostname` | Machine hostname | `my-laptop` |\n| `.chezmoi.username` | Current user | `john` |\n| `.chezmoi.homeDir` | Home directory | `\u002Fhome\u002Fjohn` |\n| `.chezmoi.sourceDir` | Source state directory | `\u002Fhome\u002Fjohn\u002F.local\u002Fshare\u002Fchezmoi` |\n| `.chezmoi.env.VAR` | Environment variables | `.chezmoi.env.EDITOR` |\n\n## Template Syntax Reference\n\n### Conditionals\n\n```go\n{{ if eq .chezmoi.os \"darwin\" }}\n# macOS-specific\n{{ else if eq .chezmoi.os \"linux\" }}\n# Linux-specific\n{{ end }}\n```\n\n### Loops\n\n```go\n{{ range .packages.darwin.brews -}}\nbrew \"{{ . }}\"\n{{ end -}}\n```\n\n### String Operations\n\n```go\n{{ .name | quote }}          # Add quotes\n{{ .chezmoi.homeDir }}        # No trimming\n{{- \"content\" -}}            # Trim whitespace\n```\n\n## Best Practices\n\n1. **Use templates for cross-platform configs** - Leverage `.chezmoi.os`, `.chezmoi.arch`\n2. **Store secrets in password managers** - Never hardcode sensitive data\n3. **Make scripts idempotent** - Safe to run multiple times\n4. **Use descriptive filenames** - `run_once_000-bootstrap.sh.tmpl`\n5. **Test templates locally** - Use `chezmoi execute-template \u003C file.tmpl`\n6. **Organize .chezmoidata** - Separate concerns into multiple files\n7. **Document dependencies** - Comment complex configurations\n8. **Use appropriate refresh periods** - Balance freshness and bandwidth\n\n## Consulting Latest Documentation\n\nThis skill can consult the latest chezmoi documentation via Context7 to ensure accuracy:\n\n```bash\n# When in doubt, ask for the latest docs\n\"Check the chezmoi documentation for [topic]\"\n```\n\nIf the question involves `.tmpl` behavior (especially `.chezmoiignore{,.tmpl}`), prefer checking the official docs first.\n\n## Useful Commands\n\n```bash\n# ⚠️ FORBIDDEN - Apply all changes (must run manually)\nchezmoi apply\n\n# Dry run (preview changes) - SAFE\nchezmoi apply --dry-run\n\n# ⚠️ FORBIDDEN - Update source state (may change managed files)\nchezmoi update\n\n# Edit source state - SAFE\nchezmoi cd\n\n# Add file as template - SAFE\nchezmoi add --template ~\u002F.config\u002Ffile\n\n# Verify configuration - SAFE\nchezmoi doctor\n\n# View all template data - SAFE\nchezmoi data\n\n# List ignored files - SAFE\nchezmoi ignored\n\n# Test template (preview output) - SAFE\nchezmoi execute-template \u003C ~\u002F.local\u002Fshare\u002Fchezmoi\u002Fdot_file.tmpl\n\n# View run_once state - SAFE\nchezmoi state dump\n\n# Clear run_once script state (use with caution) - SAFE\nchezmoi state delete-bucket --bucket=scriptState\n\n# Clear run_onchange script state (use with caution) - SAFE\nchezmoi state delete-bucket --bucket=entryState\n\n# See what would change - SAFE\nchezmoi diff\n\n# Verify files match expected state - SAFE\nchezmoi verify\n```\n\n## File Structure\n\nStandard chezmoi source state structure:\n\n```\n~\u002F.local\u002Fshare\u002Fchezmoi\u002F\n├── .chezmoi.toml.tmpl          # Main configuration (optional)\n├── .chezmoiexternal.toml.tmpl   # External resources (optional)\n├── .chezmoiignore.tmpl          # Ignore rules (template-aware, optional)\n├── .chezmoidata\u002F\n│   ├── packages.yaml            # Custom data\n│   └── work.yaml\n├── dot_gitconfig.tmpl           # Regular templates\n├── dot_zshrc.tmpl\n├── run_once_000-bootstrap.sh.tmpl\n├── run_onchange_install-packages.sh.tmpl\n└── run_after_dot_vimrc.sh.tmpl\n```\n\n## Debugging\n\n**注意：调试时也不要执行 `chezmoi update`，如需检查变更请用 `chezmoi diff` 或 `chezmoi apply --dry-run`。**\n\n**Verbose output:**\n```bash\nchezmoi apply --verbose\n```\n\n**Check what would change:**\n```bash\nchezmoi diff\n```\n\n**Validate configuration:**\n```bash\nchezmoi doctor\n```\n\n**See expanded template:**\n```bash\nchezmoi execute-template \u003C template-file\n```\n\n## When to Use This Skill\n\nUse this skill whenever you're:\n- Creating new chezmoi templates with Go syntax\n- Modifying existing .chezmoi configuration files\n- Managing .chezmoiignore\u002F.chezmoiignore.tmpl rules\n- Setting up .chezmoiexternal for external resources\n- Writing run_once\u002Frun_onchange scripts\n- Integrating password managers for secrets\n- Managing cross-platform dotfiles\n- Debugging template issues\n- Organizing .chezmoidata files\n\nFor specific concerns, refer to the detailed reference documentation listed above.\n\n## Related Skills\n\n- **chezmoi-workflows** — Apply templates, sync across machines, daily operations\n- **chezmoi-troubleshooting** — Debug template rendering, doctor interpretation\n- **chezmoi-advanced-config** — Encryption, monorepo, git automation\n- **chezmoi-agent-config** — AI agent config templating with chezmoi\n- **chezmoi-migration** — First-time setup and migration from other tools\n","# Chezmoi Configuration Management\n\nComprehensive guide for managing chezmoi dotfiles with templates, scripts, external resources, and advanced configurations.\n\n## ⚠️ Safety Constraints\n\n**This skill is READ-ONLY and validation-only. It MUST NOT modify your actual environment.**\n\n### Forbidden Operations\n\nNEVER execute these commands - they will modify your system:\n- `chezmoi apply` - Applies changes to your home directory\n- `chezmoi apply --force` - Forcefully applies changes\n- `chezmoi update` - Updates source state and may change managed files\n- Any operations that directly execute scripts (scripts run automatically during `chezmoi apply`)\n\n### Allowed Safe Operations\n\nONLY use these read-only validation commands:\n- `chezmoi diff` - Preview what would change (safe)\n- `chezmoi apply --dry-run` - Simulate changes without applying (safe)\n- `chezmoi doctor` - Check configuration validity (safe)\n- `chezmoi data` - Display template data variables (safe)\n- `chezmoi managed` - List files currently managed by chezmoi (read-only, safe)\n- `chezmoi unmanaged` - List files currently unmanaged by chezmoi (read-only, safe)\n- `chezmoi ignored` - List files ignored by chezmoi (read-only, safe)\n- `chezmoi execute-template \u003C file.tmpl` - Preview expanded template output (safe)\n- `chezmoi state dump` - View script execution state (safe)\n- `chezmoi verify` - Verify source state integrity (safe)\n- `chezmoi cd` - Enter source directory (safe)\n- `chezmoi source-path` - Show source directory path (safe)\n\n### User Responsibility\n\nThis skill helps you **create and validate** chezmoi configurations. To apply changes, **you must manually run** `chezmoi apply` in your terminal after reviewing the output.\n\n## Quick Start\n\n### Creating a New Template\n\n1. **Add existing file as template:**\n   ```bash\n   chezmoi add --template ~\u002F.gitconfig\n   ```\n\n2. **Or create manually:**\n   ```bash\n   chezmoi cd\n   $EDITOR dot_gitconfig.tmpl\n   ```\n\n3. **Use Go template syntax:**\n   ```go\n   [user]\n       name = {{ .name }}\n   {{- if eq .chezmoi.os \"darwin\" }}\n   [credential]\n       helper = osxkeychain\n   {{- end }}\n   ```\n\n### Managing External Resources\n\nCreate `.chezmoiexternal.toml.tmpl`:\n\n```toml\n[\".oh-my-zsh\"]\n    type = \"archive\"\n    url = \"https:\u002F\u002Fgithub.com\u002Fohmyzsh\u002Fohmyzsh\u002Farchive\u002Fmaster.tar.gz\"\n    exact = true\n    stripComponents = 1\n```\n\n### Writing Scripts\n\nCreate `run_onchange_install-packages.sh.tmpl`:\n\n```bash\n{{ if eq .chezmoi.os \"darwin\" -}}\n#!\u002Fbin\u002Fbash\nbrew install git vim ripgrep\n{{ end -}}\n```\n\n## Reference Documentation\n\nThis skill includes comprehensive reference documentation. Consult these guides for detailed information:\n\n- **[template-syntax.md](references\u002Ftemplate-syntax.md)** - Go template syntax, variables, conditionals, loops, and examples\n- **[external-files.md](references\u002Fexternal-files.md)** - .chezmoiexternal configuration for files, archives, and git repositories\n- **[ignore-files.md](references\u002Fignore-files.md)** - .chezmoiignore\u002F.chezmoiignore.tmpl patterns, templates, and scope\n- **[password-managers.md](references\u002Fpassword-managers.md)** - Integrating 20+ password managers (1Password, Bitwarden, Vault, etc.)\n- **[scripts.md](references\u002Fscripts.md)** - run_once, run_onchange, run_before, run_after scripts\n- **[advanced-configuration.md](references\u002Fadvanced-configuration.md)** - .chezmoi.toml, prompting, encryption, and advanced features\n\n## Common Tasks\n\n### 1. Create Platform-Specific Configuration\n\n**Template file (dot_gitconfig.tmpl):**\n```go\n[user]\n    name = {{ .name }}\n    email = {{ .email }}\n\n{{- if eq .chezmoi.os \"darwin\" }}\n[credential]\n    helper = osxkeychain\n{{- else if eq .chezmoi.os \"linux\" }}\n[credential]\n    helper = cache\n{{- end }}\n```\n\n**Configuration (chezmoi.toml):**\n```toml\n[data]\n    name = \"John Doe\"\n    email = \"john@example.com\"\n```\n\n### 2. Manage Secrets with Password Managers\n\n```go\n{{- if (bitwarden \"github\") }}\n[github]\n    token = {{ (bitwarden \"github\").login.password }}\n{{- end }}\n```\n\n### 3. Install Packages Conditionally\n\n**run_onchange_install-packages.sh.tmpl:**\n```bash\n{{ if eq .chezmoi.os \"darwin\" -}}\n#!\u002Fbin\u002Fbash\nbrew bundle --file=\u002Fdev\u002Fstdin \u003C\u003CEOF\n{{ range .packages.darwin.brews -}}\nbrew \"{{ . }}\"\n{{ end -}}\nEOF\n{{ else if eq .chezmoi.os \"linux\" -}}\n#!\u002Fbin\u002Fbash\nsudo apt install -y {{ range .packages.linux }}{{ . }} {{ end }}\n{{ end -}}\n```\n\n**.chezmoidata\u002Fpackages.yaml:**\n```yaml\ndarwin:\n  brews:\n    - git\n    - vim\n    - ripgrep\n\nlinux:\n  - git\n  - vim\n  - ripgrep\n  - fd-find\n```\n\n### 4. Include External Resources\n\n**.chezmoiexternal.toml.tmpl:**\n```toml\n[\".vim\u002Fautoload\u002Fplug.vim\"]\n    type = \"file\"\n    url = \"https:\u002F\u002Fraw.githubusercontent.com\u002Fjunegunn\u002Fvim-plug\u002Fmaster\u002Fplug.vim\"\n\n[\".oh-my-zsh\"]\n    type = \"archive\"\n    url = \"https:\u002F\u002Fgithub.com\u002Fohmyzsh\u002Fohmyzsh\u002Farchive\u002Fmaster.tar.gz\"\n    exact = true\n    stripComponents = 1\n    refreshPeriod = \"168h\"\n\n[\".local\u002Fbin\u002Fage\"]\n    type = \"archive-file\"\n    url = \"https:\u002F\u002Fgithub.com\u002FFiloSottile\u002Fage\u002Freleases\u002Fdownload\u002Fv1.1.1\u002Fage-v1.1.1-{{ .chezmoi.os }}-{{ .chezmoi.arch }}.tar.gz\"\n    path = \"age\u002Fage\"\n    executable = true\n```\n\n### 5. Configure Interactive Prompts\n\n**.chezmoi.toml.tmpl:**\n```toml\n{{- $editor := promptChoice \"favorite editor\" [\"vim\" \"neovim\" \"vscode\"] -}}\n[data]\n    name = \"{{ promptString \"your name\" }}\"\n    email = \"{{ promptString \"your email\" }}\"\n    editor = {{ $editor }}\n\n{{ if promptBool \"enable work config?\" -}}\n[data.work]\n    enabled = true\n    work_email = \"{{ promptString \"work email\" }}\"\n{{ end }}\n```\n\n### 6. Ignore Files Conditionally\n\n**.chezmoiignore (template-aware):**\n```text\nREADME.md\n*.log\n\n{{- if ne .chezmoi.hostname \"work-laptop\" }}\n.work\n{{- end }}\n\n{{- if eq .chezmoi.os \"windows\" }}\nDocuments\u002F*\n!Documents\u002F*PowerShell\u002F\n{{- end }}\n```\n\n### 7. Interpret `chezmoi managed` \u002F `chezmoi unmanaged` Output (Config Files)\n\nWhen reviewing `chezmoi unmanaged`, note that the *destination* config file is `~\u002F.config\u002Fchezmoi\u002Fchezmoi.toml`, while the *source* is typically managed as a template such as `dot_config\u002Fchezmoi\u002Fchezmoi.toml.tmpl` (or `private_dot_config\u002Fchezmoi\u002Fchezmoi.toml.tmpl`) in the chezmoi source state.\n\nIf `~\u002F.config\u002Fchezmoi` appears as unmanaged:\n- First check `chezmoi managed` to confirm whether the config file is already managed in source.\n- If it is not managed, add it as a template and manage it in source (recommended when you maintain machine-specific values in `chezmoi.toml`).\n\n### 8. Manage run_once Scripts\n\n**run_once_000-bootstrap.sh.tmpl:**\n```bash\n#!\u002Fbin\u002Fbash\n{{ if eq .chezmoi.os \"darwin\" -}}\nif ! command -v brew &> \u002Fdev\u002Fnull; then\n    \u002Fbin\u002Fbash -c \"$(curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FHomebrew\u002Finstall\u002FHEAD\u002Finstall.sh)\"\nfi\n{{ end -}}\n```\n\n**Reset run_once state:**\n```bash\n# Clear all run_once script state\nchezmoi state delete-bucket --bucket=scriptState\n```\n\n## Built-in Variables\n\nCommonly used chezmoi variables available in all templates:\n\n| Variable | Description | Example |\n|----------|-------------|---------|\n| `.chezmoi.os` | Operating system | `linux`, `darwin`, `windows` |\n| `.chezmoi.arch` | Architecture | `amd64`, `arm64` |\n| `.chezmoi.hostname` | Machine hostname | `my-laptop` |\n| `.chezmoi.username` | Current user | `john` |\n| `.chezmoi.homeDir` | Home directory | `\u002Fhome\u002Fjohn` |\n| `.chezmoi.sourceDir` | Source state directory | `\u002Fhome\u002Fjohn\u002F.local\u002Fshare\u002Fchezmoi` |\n| `.chezmoi.env.VAR` | Environment variables | `.chezmoi.env.EDITOR` |\n\n## Template Syntax Reference\n\n### Conditionals\n\n```go\n{{ if eq .chezmoi.os \"darwin\" }}\n# macOS-specific\n{{ else if eq .chezmoi.os \"linux\" }}\n# Linux-specific\n{{ end }}\n```\n\n### Loops\n\n```go\n{{ range .packages.darwin.brews -}}\nbrew \"{{ . }}\"\n{{ end -}}\n```\n\n### String Operations\n\n```go\n{{ .name | quote }}          # Add quotes\n{{ .chezmoi.homeDir }}        # No trimming\n{{- \"content\" -}}            # Trim whitespace\n```\n\n## Best Practices\n\n1. **Use templates for cross-platform configs** - Leverage `.chezmoi.os`, `.chezmoi.arch`\n2. **Store secrets in password managers** - Never hardcode sensitive data\n3. **Make scripts idempotent** - Safe to run multiple times\n4. **Use descriptive filenames** - `run_once_000-bootstrap.sh.tmpl`\n5. **Test templates locally** - Use `chezmoi execute-template \u003C file.tmpl`\n6. **Organize .chezmoidata** - Separate concerns into multiple files\n7. **Document dependencies** - Comment complex configurations\n8. **Use appropriate refresh periods** - Balance freshness and bandwidth\n\n## Consulting Latest Documentation\n\nThis skill can consult the latest chezmoi documentation via Context7 to ensure accuracy:\n\n```bash\n# When in doubt, ask for the latest docs\n\"Check the chezmoi documentation for [topic]\"\n```\n\nIf the question involves `.tmpl` behavior (especially `.chezmoiignore{,.tmpl}`), prefer checking the official docs first.\n\n## Useful Commands\n\n```bash\n# ⚠️ FORBIDDEN - Apply all changes (must run manually)\nchezmoi apply\n\n# Dry run (preview changes) - SAFE\nchezmoi apply --dry-run\n\n# ⚠️ FORBIDDEN - Update source state (may change managed files)\nchezmoi update\n\n# Edit source state - SAFE\nchezmoi cd\n\n# Add file as template - SAFE\nchezmoi add --template ~\u002F.config\u002Ffile\n\n# Verify configuration - SAFE\nchezmoi doctor\n\n# View all template data - SAFE\nchezmoi data\n\n# List ignored files - SAFE\nchezmoi ignored\n\n# Test template (preview output) - SAFE\nchezmoi execute-template \u003C ~\u002F.local\u002Fshare\u002Fchezmoi\u002Fdot_file.tmpl\n\n# View run_once state - SAFE\nchezmoi state dump\n\n# Clear run_once script state (use with caution) - SAFE\nchezmoi state delete-bucket --bucket=scriptState\n\n# Clear run_onchange script state (use with caution) - SAFE\nchezmoi state delete-bucket --bucket=entryState\n\n# See what would change - SAFE\nchezmoi diff\n\n# Verify files match expected state - SAFE\nchezmoi verify\n```\n\n## File Structure\n\nStandard chezmoi source state structure:\n\n```\n~\u002F.local\u002Fshare\u002Fchezmoi\u002F\n├── .chezmoi.toml.tmpl          # Main configuration (optional)\n├── .chezmoiexternal.toml.tmpl   # External resources (optional)\n├── .chezmoiignore.tmpl          # Ignore rules (template-aware, optional)\n├── .chezmoidata\u002F\n│   ├── packages.yaml            # Custom data\n│   └── work.yaml\n├── dot_gitconfig.tmpl           # Regular templates\n├── dot_zshrc.tmpl\n├── run_once_000-bootstrap.sh.tmpl\n├── run_onchange_install-packages.sh.tmpl\n└── run_after_dot_vimrc.sh.tmpl\n```\n\n## Debugging\n\n**注意：调试时也不要执行 `chezmoi update`，如需检查变更请用 `chezmoi diff` 或 `chezmoi apply --dry-run`。**\n\n**Verbose output:**\n```bash\nchezmoi apply --verbose\n```\n\n**Check what would change:**\n```bash\nchezmoi diff\n```\n\n**Validate configuration:**\n```bash\nchezmoi doctor\n```\n\n**See expanded template:**\n```bash\nchezmoi execute-template \u003C template-file\n```\n\n## When to Use This Skill\n\nUse this skill whenever you're:\n- Creating new chezmoi templates with Go syntax\n- Modifying existing .chezmoi configuration files\n- Managing .chezmoiignore\u002F.chezmoiignore.tmpl rules\n- Setting up .chezmoiexternal for external resources\n- Writing run_once\u002Frun_onchange scripts\n- Integrating password managers for secrets\n- Managing cross-platform dotfiles\n- Debugging template issues\n- Organizing .chezmoidata files\n\nFor specific concerns, refer to the detailed reference documentation listed above.\n\n## Related Skills\n\n- **chezmoi-workflows** — Apply templates, sync across machines, daily operations\n- **chezmoi-troubleshooting** — Debug template rendering, doctor interpretation\n- **chezmoi-advanced-config** — Encryption, monorepo, git automation\n- **chezmoi-agent-config** — AI agent config templating with chezmoi\n- **chezmoi-migration** — First-time setup and migration from other tools\n",{"name":5,"description":7},"main","716b17df3ef6719d88aeac180015008b7ddfff6f","rsm-subagents\u002Fplugins\u002Fchezmoi-toolkit\u002Fskills\u002Fchezmoi-config",0,"https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment","https:\u002F\u002Fgithub.com\u002Fray-manaloto","2026-08-03 16:55:50",{"source":8,"skillName":5,"commands":51,"prompt":61,"zipAvailable":62},[52,55,58],{"tool":53,"command":54},"npx","npx skills add ray-manaloto\u002Fmacos-development-environment --skill chezmoi-config",{"tool":56,"command":57},"bunx","bunx skills add ray-manaloto\u002Fmacos-development-environment --skill chezmoi-config",{"tool":59,"command":60},"pnpm","pnpm dlx skills add ray-manaloto\u002Fmacos-development-environment --skill chezmoi-config","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fchezmoi-toolkit\u002Fskills\u002Fchezmoi-config\u002FSKILL.md",true,[64,70,74,78,82,86],{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"references\u002Fadvanced-configuration.md","REFERENCE","参考文档",8120,"https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fchezmoi-toolkit\u002Fskills\u002Fchezmoi-config\u002Freferences\u002Fadvanced-configuration.md",{"path":71,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":72,"sourceHtmlUrl":73},"references\u002Fexternal-files.md",5859,"https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fchezmoi-toolkit\u002Fskills\u002Fchezmoi-config\u002Freferences\u002Fexternal-files.md",{"path":75,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":76,"sourceHtmlUrl":77},"references\u002Fignore-files.md",1556,"https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fchezmoi-toolkit\u002Fskills\u002Fchezmoi-config\u002Freferences\u002Fignore-files.md",{"path":79,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":80,"sourceHtmlUrl":81},"references\u002Fpassword-managers.md",6412,"https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fchezmoi-toolkit\u002Fskills\u002Fchezmoi-config\u002Freferences\u002Fpassword-managers.md",{"path":83,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":84,"sourceHtmlUrl":85},"references\u002Fscripts.md",8611,"https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fchezmoi-toolkit\u002Fskills\u002Fchezmoi-config\u002Freferences\u002Fscripts.md",{"path":87,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":88,"sourceHtmlUrl":89},"references\u002Ftemplate-syntax.md",3932,"https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fchezmoi-toolkit\u002Fskills\u002Fchezmoi-config\u002Freferences\u002Ftemplate-syntax.md",[91,113,130,148,168,182],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":102,"publishedAt":38},"01M6CC8DXNJ39YWERYTWCGGCGG","next-workflow-step","Use this skill when the user wants to transition to the next workflow step, wrap up a session cleanly, prepare a handoff, or says things like \"next step\", \"continue the workflow\", \"wrap up\", \"hand off\", \"move to the next phase\", \"what's next in embrace\", or \"prepare for \u002Fclear\". Also triggers when the current octo:embrace phase appears complete and no explicit next action is set.","https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fworkflow-toolkit\u002Fskills\u002Fnext-workflow-step\u002FSKILL.md",[97],{"categoryNo":98,"categoryName":99,"taxonomyType":100,"taxonomyTypeDesc":101},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[103,104,105,24,106,107,108,109,110,111,112],"next workflow step","workflow","up","session","user","wrap up","continue","handoff","prepare","SET",{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":117,"categories":118,"keywords":119,"publishedAt":38},"01M6CC8BRZBQHEBXGMKPDM422P","source-discovery","This skill should be used when the user asks to \"find sources\", \"discover URLs\", \"catalog a source\", \"classify a URL\", \"search for libraries\", \"check what exists\", or mentions source discovery, URL cataloging, source classification, or research source management.","https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fresearch-review-toolkit\u002Fskills\u002Fsource-discovery\u002FSKILL.md",[],[120,121,122,123,124,125,126,127,25,107,128,129],"discovery","source discovery","research","libraries","search","classification","find","check","catalog","find sources",{"skillNo":131,"name":132,"nameZh":6,"description":133,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":134,"categories":135,"keywords":136,"publishedAt":38},"01M6CC89CGJP69A0PS22G2H1FV","review-synthesis","This skill should be used when the user asks to \"summarize review findings\", \"prioritize fixes\", \"rank review issues\", \"combine reviewer feedback\", \"create action items from review\", or mentions review synthesis, finding prioritization, severity ranking, or review result summarization.","https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fresearch-review-toolkit\u002Fskills\u002Freview-synthesis\u002FSKILL.md",[],[137,138,139,140,141,142,143,107,144,145,36,146,147],"review","review synthesis","Synthesis","prioritize","create action","feedback","reviewer","summarize","prioritization","issues","severity",{"skillNo":149,"name":150,"nameZh":6,"description":151,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":152,"categories":153,"keywords":157,"publishedAt":38},"01M6CC872EZ9GRJY0HRCG0RT2M","research-scoring","This skill should be used when the user asks to \"score research\", \"check research quality\", \"evaluate coverage\", \"measure improvement\", \"assess research completeness\", or mentions research scoring, quality metrics, coverage gaps, improvement baseline, or research pipeline status.","https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fresearch-review-toolkit\u002Fskills\u002Fresearch-scoring\u002FSKILL.md",[154],{"categoryNo":155,"categoryName":156,"taxonomyType":100,"taxonomyTypeDesc":101},"01JBSEEDCAT000000000000021","资料检索与研究",[158,122,159,160,161,162,163,164,127,107,165,166,167],"research scoring","status","coverage gaps","metrics","pipeline","baseline","quality","coverage","pipeline status","research quality",{"skillNo":169,"name":170,"nameZh":6,"description":171,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":172,"categories":173,"keywords":174,"publishedAt":38},"01M6CC852HSDS1FE4EJAT0RHGR","notebooklm-integration","This skill should be used when the user asks to \"ingest into NotebookLM\", \"query NotebookLM\", \"add sources to notebook\", \"cross-source synthesis\", \"check stale sources\", or mentions NotebookLM, notebook integration, source ingestion, or knowledge consolidation.","https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fresearch-review-toolkit\u002Fskills\u002Fnotebooklm-integration\u002FSKILL.md",[],[175,176,177,178,127,107,179,180,181,139],"notebooklm integration","notebooklm","integration","knowledge","ingestion","ingest","stale",{"skillNo":183,"name":184,"nameZh":6,"description":185,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":186,"categories":187,"keywords":189,"publishedAt":38},"01M6CC82Z4V3205KCJWQZPS2VG","evidence-synthesis","This skill should be used when the user asks to \"synthesize findings\", \"combine research\", \"cross-reference sources\", \"summarize evidence\", \"write a deep review\", or mentions evidence synthesis, finding consolidation, cross-source analysis, or research summarization.","https:\u002F\u002Fgithub.com\u002Fray-manaloto\u002Fmacos-development-environment\u002Fblob\u002Fmain\u002Frsm-subagents\u002Fplugins\u002Fresearch-review-toolkit\u002Fskills\u002Fevidence-synthesis\u002FSKILL.md",[188],{"categoryNo":155,"categoryName":156,"taxonomyType":100,"taxonomyTypeDesc":101},[190,139,191,144,122,192,193,26,107,194,137],"evidence synthesis","evidence","deep review","analysis","reference"]