skills.rest
rmanzoku
rmanzokuCOMMUNITY
Explore all skills by this author →
Website𝕏@rmanzokuGitHub

chezmoi-knowledge

Explain chezmoi source and target mapping, prefixes, ignore rules, and symlink behavior.

1|1|Updated Jul 24, 2014
Search Tags:#dotfiles#knowledge base#chezmoi#semantics#decision rules
One-click install
npx skills add https://github.com/rmanzoku/dotfiles --skill chezmoi-knowledge
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: chezmoi-knowledge
Source: https://github.com/rmanzoku/dotfiles/tree/main/.claude/skills/chezmoi-knowledge
Command: npx skills add https://github.com/rmanzoku/dotfiles --skill chezmoi-knowledge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a repository-specific knowledge base for chezmoi semantics and decision rules, preventing common misunderstandings and ensuring correct usage of chezmoi-managed files.

Core Features & Use Cases

  • Semantic Understanding: Offers insights into how dot_*, private_*, symlink_*, and other chezmoi features work.
  • Decision Rules: Provides rules for interpreting files and directories within the repository.
  • Pre-edit Checks: Assists in pre-edit checks before making changes to chezmoi-managed files to avoid mistakes.

Quick Start

Consult the chezmoi-knowledge skill to understand the implications of renaming a dot_foo file in this repository.

Frequently Asked Questions about chezmoi-knowledge

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

FAQPage Schema
How do chezmoi prefixes like dot_ and private_ map to target files?▼

Chezmoi prefixes like dot_, private_, and symlink_ define semantic rules that map source files to their target states, controlling attributes like visibility and link behavior. This knowledge base interprets those mappings to prevent misconfiguration.

How do I check chezmoi ignore rules before editing managed dotfiles?▼

To check chezmoi ignore rules before editing, consult this knowledge base to understand decision rules and source/target mapping. It provides pre-edit mental model correction to ensure changes align with repository-specific ignore behavior.

What does the symlink_ prefix do in a chezmoi dotfiles repository?▼

The symlink_ prefix in chezmoi dictates that the target file should be managed as a symbolic link rather than a copied file. Understanding this semantics prevents accidental data loss during dotfiles synchronization.

Why does renaming a dot_ file in chezmoi break my target configuration?▼

Renaming a dot_ file breaks target configuration because chezmoi relies on strict source naming conventions to map to the target state. This knowledge base clarifies these decision rules to avoid incorrect file path resolution.

Are there limitations to relying on chezmoi semantics for dotfiles management?▼

A limitation of chezmoi semantics is the potential for misunderstanding complex prefix combinations and ignore rules. This knowledge base mitigates that by providing strict decision rules for pre-edit checks and target mapping.

Related Skills

Explore More Software Engineering Skills→
huangeddiehuangeddie
1

chezmoi

Map deployed dotfiles to chezmoi source paths and apply changes.

Community
Intermediate
temple-slopetemple-slope

chezmoi

Edit, diff, and apply home directory dotfiles with chezmoi.

Community
Intermediate
vemolistavemolista

editing-dotfiles

Manage dotfiles across machines with chezmoi-backed source control.

Community
Intermediate
einverneeinverne
119

dotfiles-manager

Organize, sync, and deploy dotfiles across macOS, Linux, and Windows.

Community
Advanced