dotfiles-verification-toolkit

Verify dotfiles configurations by executing proof recipes for symlinks, plugins, git identities, SSH keys, hooks, settings, snapshots, and worktrees.

Updated Jun 13, 2026
One-click install
npx skills add https://github.com/taloncjones/dotfiles --skill dotfiles-verification-toolkit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dotfiles-verification-toolkit
Source: https://github.com/taloncjones/dotfiles/tree/main/.claude/skills/dotfiles-verification-toolkit
Command: npx skills add https://github.com/taloncjones/dotfiles --skill dotfiles-verification-toolkit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses the challenge of verifying the integrity and correctness of dotfiles configurations, providing detailed proof recipes for various aspects of the dotfiles setup.

Core Features & Use Cases

  • Symlink Verification: Confirms the integrity of the symlink chain from the dotfiles repository to the user's configuration directory.
  • Plugin Installation Verification: Checks that plugins are actually installed and their skills are loaded.
  • Git Identity Resolution Verification: Ensures the correct git identity is used for commits in the dotfiles repository.
  • SSH Key Verification: Validates that the correct SSH key is used for host connections.
  • Hook Verification: Checks that hooks are registered and fire as expected.
  • Settings Merge Verification: Ensures that the live settings file contains all template keys.
  • Cloud Snapshot Verification: Verifies that the cloud snapshot carries the correct state.
  • Worktree Hydration Verification: Confirms that worktree hydration works correctly.
  • Use Case: Before claiming any install/link/config step in the dotfiles repository has succeeded, use this Skill to verify the actual state on disk.

Quick Start

Run the 'dotfiles-verification-toolkit' skill to verify the symlink chain for the 'claude' configuration directory.

Frequently Asked Questions about dotfiles-verification-toolkit

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

FAQPage Schema
How do I verify my dotfiles configuration integrity after running a setup script?

You can verify dotfiles configuration integrity by executing proof recipes that check symlink chains, plugin installations, git identities, SSH keys, and hooks to ensure the actual state on disk matches the expected configuration. The toolkit runs scripts to execute commands and validate outputs automatically.

What is the best way to check if my git identity and SSH keys are configured correctly in my dotfiles?

The best way to check git identity and SSH key configuration is to use verification recipes that ensure the correct git identity is used for commits and validate that the correct SSH key is used for host connections. This verifies the actual state on disk matches your expected configuration settings.

Can I verify that my git hooks are registered and fire as expected?

Yes, you can verify git hooks by running the toolkit to execute proof recipes that check whether hooks are properly registered and fire as expected. This ensures the actual hook state on disk matches your expected dotfiles configuration.

How do I confirm that worktree hydration and settings merges are applied correctly?

Confirm worktree hydration and settings merges by executing verification recipes that check worktree hydration works correctly and ensure the live settings file contains all template keys. This validates the actual state on disk matches the expected configuration.

Does the dotfiles verification toolkit require any external dependencies to run?

No, the dotfiles verification toolkit requires no external dependencies to run. It requires only scripts to execute commands and check outputs, ensuring the actual state on disk matches the expected dotfiles configuration.