setup-tester

Tests dotfiles setup via pre-validation, execution, and post-verification workflows.

12|3|Updated Jun 5, 2017
One-click install
npx skills add https://github.com/ruchernchong/dotfiles --skill setup-tester
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-tester
Source: https://github.com/ruchernchong/dotfiles/tree/main/.claude/skills/setup-tester
Command: npx skills add https://github.com/ruchernchong/dotfiles --skill setup-tester

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the tedious, manual, and error-prone process of setting up dotfiles, which often leads to broken configurations and wasted time. It ensures your development environment is consistently and correctly deployed.

Core Features & Use Cases

  • Pre-Setup Validation: Automatically checks for missing files, incorrect permissions, and syntax errors before any installation begins, preventing common failures.
  • Setup Process Testing: Systematically executes and monitors your dotfiles setup script, capturing errors and stopping on critical failures for immediate troubleshooting.
  • Post-Setup Verification: Confirms that all symlinks are correctly established, shell configurations load without issues, and Homebrew packages are properly installed and resolvable.
  • Use Case: Before deploying your dotfiles to a new machine or after a major system update, use this Skill to automatically run a full diagnostic, ensuring a smooth, error-free setup and saving you hours of manual verification.

Quick Start

Test my dotfiles setup for any issues and provide a detailed report.

Frequently Asked Questions about setup-tester

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

FAQPage Schema
How do I validate dotfiles setup before deploying to a new machine?

Dotfiles validation checks for missing files, incorrect permissions, and syntax errors before installation. This Skill automatically runs pre-setup diagnostics, detecting common failures like broken symlinks, invalid Brewfile entries, and shell configuration issues, preventing deployment failures and saving hours of manual verification.

Can I test my dotfiles setup script for errors without full installation?

Yes, this Skill systematically executes and monitors your dotfiles setup script step-by-step, capturing errors and stopping on critical failures. It validates file existence, executable permissions, shebangs, symlink establishment, and shell loading—giving you immediate feedback for troubleshooting before committing changes.

What dotfiles configuration issues can be automatically detected?

This Skill detects missing files, incorrect file permissions, syntax errors, invalid Brewfile formats, broken symlinks, shell loading failures, missing aliases, crontab misconfigurations, and Claude Code settings symlink problems—covering the full setup validation and post-deployment verification cycle.

How do I verify symlinks and shell configuration load correctly after setup?

Post-setup verification confirms all symlinks are correctly established, shell configurations load without errors, and Homebrew packages are properly installed and resolvable. This Skill provides a detailed report documenting each verification step and guiding remediation if issues are found.

Can this Skill help troubleshoot a broken dotfiles setup?

Yes, this Skill documents all setup progress, identifies where failures occur, and provides guidance for remediation and rollback steps. It validates required files, permissions, and syntax to pinpoint exactly what went wrong and how to fix it.

Do I need prior setup scripts or configuration files to use dotfiles validation?

This Skill works with existing dotfiles repositories and setup scripts. It requires your dotfiles directory structure and setup executable to be present; it validates and tests them without modifying or creating the initial setup configuration.