skills.rest
VictorHueni
VictorHueniCOMMUNITY
Explore all skills by this author →
GitHub

util-toolkit-doctor

Diagnose and repair Claude Code setup issues with chezmoi, dotfiles, and symlinks.

Updated Apr 8, 2026
Search Tags:#claude code#system health#setup diagnosis#dotfiles management#symlink integrity
One-click install
npx skills add https://github.com/VictorHueni/homemade-claude-kit --skill util-toolkit-doctor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: util-toolkit-doctor
Source: https://github.com/VictorHueni/homemade-claude-kit/tree/main/skills/util-toolkit-doctor
Command: npx skills add https://github.com/VictorHueni/homemade-claude-kit --skill util-toolkit-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires chezmoi, git, gh, ssh, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

The util-toolkit-doctor Skill unit identifies and resolves common issues with Claude Code setups, including chezmoi state, dotfiles synchronization, and symlink integrity.

Core Features & Use Cases

  • Setup Health Check: Identifies discrepancies in dotfiles and kit repo states.
  • Symlink Integrity: Verifies the correctness of symlinks to the Claude setup.
  • Auto-Fixing: Corrects minor drifts without user intervention, such as symlink repairs and chezmoi apply actions.
  • User Confirmation Required: Stops and seeks user input for critical issues like uncommitted changes or local commits ahead of origin.

Quick Start

Run the diagnostic to check your Claude setup with the command:

~/projects/homemade-claude-kit/util-toolkit-doctor/scripts/gather-state.sh

Frequently Asked Questions about util-toolkit-doctor

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

FAQPage Schema
How do I diagnose Claude Code setup health and check dotfiles synchronization?▼

To diagnose Claude Code setup health, run the gather-state.sh script to identify discrepancies in dotfiles and kit repositories. The health check verifies chezmoi states and symlink integrity to detect configuration drift.

What is symlink integrity verification in a chezmoi dotfiles environment?▼

Symlink integrity verification checks the correctness of symlinks pointing to your Claude setup. It identifies broken or misconfigured links between your source dotfiles and target directories to prevent setup drift.

Do I need GitHub SSH authentication and chezmoi installed to run setup diagnosis?▼

Yes, setup diagnosis requires access to chezmoi, git, gh, and SSH authentication to GitHub. These dependencies are necessary to inspect repository states, verify remote connections, and apply dotfile configurations.

Can I auto-fix chezmoi state drift and broken symlinks without manual intervention?▼

Yes, the diagnostic tool offers auto-fixing for minor drifts like symlink repairs and chezmoi apply actions without user intervention. It only stops for critical issues requiring user confirmation.

Why does the setup diagnosis stop when I have uncommitted changes or local commits ahead of origin?▼

The diagnosis stops on uncommitted changes or local commits ahead of origin to prevent data loss. These critical user-related actions require explicit confirmation before the tool attempts any state modifications.

Related Skills

Explore More Software Engineering Skills→
austinprayaustinpray

gh-auth

Authenticates gh CLI using token from repository root's .gh-txt file.

Community
Basic
carlkiblercarlkibler
3

chezmoi-drift

Detect configuration drift, unmanaged files, and broken symlinks in chezmoi setups.

Community
Intermediate
ruchernchongruchernchong
12

sync-checker

Verify dotfile symlinks and report synchronization issues with remediation guidance.

Community
Basic
MasonRhodesDevMasonRhodesDev
2

chezmoi

Track and manage dotfiles with chezmoi while preventing destructive commands.

Community
Intermediate