CtrlK
BlogDocsLog inGet started
Tessl Logo

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'.

69

Quality

85%

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

75%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.

The body is highly actionable with concrete commands, corrective examples, and a genuine source-of-truth mental model, supported by well-organized reference files. Weaknesses are redundancy between the overview and the reference files, missing error-recovery guidance in the troubleshooting workflow, and five dead evals/ links.

Suggestions

Trim sections that duplicate the reference files — the Daily Workflow table overlaps references/commands.md and the template-variable listing overlaps references/templates.md; keep only the few commands that anchor the mental model and point to the references for the rest.

Remove or repair the Eval Scenarios links (evals/scenario-1..5/task.md) — none of these files exist in the bundle, so the section currently points users at dead paths.

Close the validation loop in the workflows: add an explicit 'if diff/doctor reveals X, do Y' recovery step to the Troubleshooting Workflow, and insert a `chezmoi diff` review before the `git add -A && git push` block since apply/push act on the whole source state.

DimensionReasoningScore

Conciseness

High-value sections like Mindset and the Anti-Patterns (why/consequence structure) earn their tokens, but the Daily Workflow command table and the template-variable listing largely duplicate content already in references/commands.md and references/templates.md — basic chezmoi knowledge Claude already has. This fits the 3 anchor ("mostly efficient but includes some unnecessary explanation or could be tightened"); it is not a 2 because there is no padded conceptual explanation, just redundancy with the bundle files.

3 / 5

Actionability

Nearly every section gives copy-paste-ready commands: a full command table, executable template snippets ({{ if eq .chezmoi.os "darwin" }}), bash blocks for bootstrap/sync, and anti-patterns pairing ❌ BAD examples with exact corrective commands ("chezmoi chattr template dot_bashrc"). This matches the 5 anchor — executable guidance covering the common cases with specific examples.

5 / 5

Workflow Clarity

The Troubleshooting Workflow is a clearly sequenced 5-step diagnostic ladder with checkpoint commands (doctor → diff → status → cat → data), and diff/status preview is woven into the daily workflow before destructive applies. It falls short of the 5 anchor because there is no error-recovery loop (what to do when a step reveals a problem) and the push-back block commits via "git add -A && git commit" without a validation step first — matching the 4 anchor's "minor validation gaps".

4 / 5

Progressive Disclosure

Structure is good: an overview with key tables inline, three real one-level-deep reference files clearly listed with descriptions, and an inline pointer at the point of use ("See references/source-attrs.md for the full table"). However, the Eval Scenarios section links to five files (evals/scenario-1..5/task.md) that do not exist in the bundle, a navigation defect that rules out the 5 anchor's "easy navigation"; the real references are well-organized, keeping this above the 3 anchor.

4 / 5

Total

16

/

20

Passed

Description

96%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.

A strong description that clearly states what the skill does and when to use it, with an unusually thorough set of natural trigger phrases. The only weakness is minor: a couple of trigger phrases are generic and could match non-chezmoi tasks in isolation.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — "adding files, creating templates, encrypting secrets, writing run scripts, syncing across machines, or diagnosing why changes aren't applying" — giving comprehensive coverage of the skill's capabilities. This matches the 5 anchor ("multiple specific concrete actions; comprehensive coverage") rather than 4, which requires minor gaps in coverage; no meaningful capability area is missing.

5 / 5

Completeness

It explicitly answers both questions: what ("Expert assistant for chezmoi dotfiles management" with an enumerated action list) and when ("Use when the user is managing dotfiles with chezmoi..." plus concrete trigger phrases). This mirrors the 5 anchor example's structure exactly; the 4 anchor applies only when the "when" is less explicit, and here it is fully explicit.

5 / 5

Trigger Term Quality

Ten explicit trigger phrases blend natural user speech ("sync dotfiles to new machine", "chezmoi diff shows unexpected changes", "make a template") with tool-specific jargon users actually utter once in chezmoi context ("dot_ prefix", "once_ script", "source attribute"). This exceeds the 4 anchor's "a few natural terms missing" — coverage spans add/apply/encrypt/sync/diagnose vocabulary with both synonyms and literal command names.

5 / 5

Distinctiveness Conflict Risk

The description is firmly niched to chezmoi — "chezmoi apply", "dot_ prefix", "once_ script" are unmistakable — but several trigger phrases ("make a template", "source attribute") are generic enough to overlap with non-chezmoi templating or config skills if uttered without chezmoi context. It sits between the 4 anchor ("minor overlap risk with closely related skills") and the 5 anchor ("clear niche with distinct triggers"), landing noticeably above the midpoint but short of fully distinct triggers.

4 / 5

Total

19

/

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.

Validation15 / 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
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.