CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

chezmoi-assistant

Expert assistant for chezmoi dotfiles management. Use when the user is managing dotfiles with chezmoi: adding files, creating templates, encrypting secrets, writing run scripts, syncing across machines, or diagnosing why changes aren't applying. Trigger phrases: 'add to chezmoi', 'make a template', 'chezmoi apply', 'encrypt with chezmoi', 'run script on first apply', 'sync dotfiles to new machine', 'chezmoi diff shows unexpected changes', 'source attribute', 'dot_ prefix', 'once_ script'.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

76%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A dense, highly actionable chezmoi reference with excellent command coverage, concrete anti-pattern guidance, and a well-executed one-level reference split. It is weakened by implicit rather than explicit pre-apply validation in its batch/destructive apply workflows, five dead eval-scenario links, and minor redundant passages.

Suggestions

Make apply-workflow validation explicit: sequence 'run chezmoi diff / chezmoi status and review the output before chezmoi apply' as a checkpoint step in the Daily Workflow and Multi-Machine Setup sections, rather than leaving diff/status as unsequenced table rows.

Fix the Eval Scenarios links — evals/scenario-1 through scenario-5 task.md files do not exist in the bundle; either ship them or remove the section.

Trim redundancy: drop the 'You are an expert in chezmoi' opener, merge the two Mindset paragraphs, and collapse each Anti-Pattern's 'Consequence' paragraph into its 'WHY' where they overlap.

DimensionReasoningScore

Conciseness

The body is dense and chezmoi-specific (attribute tables, template syntax, command examples) with no padding about concepts Claude already knows. Minor trim opportunities remain: the 'You are an expert in chezmoi, the multi-machine dotfiles manager' opener, the Mindset's second paragraph restating the source→target direction already established in the first, and Anti-Pattern 'Consequence' paragraphs that partly restate their 'WHY' (e.g. the secrets consequence re-explaining git-history exposure). Fits the 4 anchor 'Efficient; minor instances of over-explanation that could be trimmed', not 5's 'every token earns its place'.

4 / 5

Actionability

Every section provides copy-paste-ready guidance: the Daily Workflow table ('chezmoi edit --apply ~/.zshrc'), executable template snippets, 'chezmoi execute-template < ~/.local/share/chezmoi/dot_zshrc.tmpl', 'chezmoi init --apply $GITHUB_USERNAME', and concrete ❌BAD/✅GOOD pairs ('chezmoi chattr template dot_bashrc'). Fully executable and covers the common cases — the 5 anchor.

5 / 5

Workflow Clarity

Sequences exist (the numbered Troubleshooting Workflow '1. chezmoi doctor ... 2. chezmoi diff ... 5. chezmoi data'; Multi-Machine bootstrap → update → push), but the workflows around the batch, destructive operation 'chezmoi apply' lack explicit pre-apply validation checkpoints: 'Preview changes | chezmoi diff' and 'Check what would change | chezmoi status' appear as unsequenced lookup-table rows rather than mandated verify-before-apply steps, and the Multi-Machine 'chezmoi update' (git pull + apply) sequence has no review checkpoint at all. Per the rubric's cap for batch/destructive workflows without validation steps, workflow clarity tops out at 3.

3 / 5

Progressive Disclosure

The body appropriately keeps summary tables inline and defers full detail to three real, one-level-deep, well-signaled files ('See [references/source-attrs.md] for the full table', plus a References section describing commands.md, source-attrs.md, and templates.md — all present in the bundle). However, the five 'Eval Scenarios' links point to evals/scenario-1..5/task.md, which do not exist in the bundle, a navigation gap that fits the 4 anchor's 'minor organization gaps' rather than 5's 'easy navigation'.

4 / 5

Total

16

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description explicitly answers both what the skill does and when to use it, enumerates six concrete capabilities, and supplies ten natural trigger phrases spanning user requests, commands, failure-mode statements, and tool-specific identifiers. It is concise, third-person, and has no overlap risk with neighboring skills.

DimensionReasoningScore

Specificity

The description enumerates six concrete actions — 'adding files, creating templates, encrypting secrets, writing run scripts, syncing across machines, or diagnosing why changes aren't applying' — which span the skill's full surface. This matches the 'multiple specific concrete actions; comprehensive coverage' anchor, not the 4 anchor's 'minor gaps in coverage'.

5 / 5

Completeness

'Expert assistant for chezmoi dotfiles management' plus the six-action list explicitly answers 'what', and 'Use when the user is managing dotfiles with chezmoi' plus the explicit trigger-phrase list answers 'when'. Both are present with concrete trigger phrases, matching the 5 anchor exactly ('clearly and explicitly answers both what AND when').

5 / 5

Trigger Term Quality

Ten trigger phrases cover natural requests ('add to chezmoi', 'make a template', 'sync dotfiles to new machine'), command invocations ('chezmoi apply', 'chezmoi diff shows unexpected changes'), and tool-specific identifiers ('source attribute', 'dot_ prefix', 'once_ script'). This is comprehensive natural-term coverage including synonyms and tool-specific vocabulary, matching the 5 anchor rather than the 4 anchor's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

The niche is a single named tool ('chezmoi dotfiles management') with tool-specific triggers ('chezmoi apply', 'dot_ prefix', 'once_ script') that no generic dotfile or shell-config skill would fire on. This matches the 5 anchor ('clear niche with distinct triggers; minimal conflict risk').

5 / 5

Total

20

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 5 missing, 5 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

pantheon-org/tekhne

Path

skills/specialized/chezmoi/chezmoi-assistant/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.