audit-dotfiles

Audit dotfiles-managed shell aliases, Claude Code assets, Brewfile entries, symlinks, and secrets for broken or obsolete definitions.

Updated Dec 25, 2021
One-click install
npx skills add https://github.com/kotahashihama/dotfiles --skill audit-dotfiles-kotahashihama
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-dotfiles
Source: https://github.com/kotahashihama/dotfiles/tree/main/.claude/skills/audit-dotfiles
Command: npx skills add https://github.com/kotahashihama/dotfiles --skill audit-dotfiles-kotahashihama

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Dotfiles-managed configurations fail silently: aliases point to uninstalled tools, symlinks break, hooks reference missing scripts, and obsolete definitions linger after tool migrations. This Skill systematically audits each category and surfaces what is broken or no longer used so you can decide to fix, remove, or reinstall. ## Core Features & Use Cases - Shell audit: Resolves aliases and functions from a live zsh session, follows nested references, and classifies each as alive, missing, or undeterminable, plus PATH duplicate checks and startup time measurement. - Claude Code asset audit: Checks cross-references between rules and skills, hook script paths in settings.json, duplicate skills across public/private locations, and orphaned assets. - Brewfile, symlink, and secrets audits: Runs brew bundle check in both directions, detects broken or missing symlinks and public/private name collisions, and verifies secrets variable names match the example file. - Use Case: After migrating to a new Mac, run a full audit to find aliases referencing tools that were never reinstalled (e.g., asdf after moving to mise) and get a reasoned recommendation for each before deciding to remove or reinstall. ## Quick Start Ask the assistant to audit your dotfiles, optionally narrowing scope with a category such as shell, claude, brew, links, or secrets.

Frequently Asked Questions about audit-dotfiles

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

FAQPage Schema
How do I audit shell aliases for broken references in zsh?

Resolve aliases from a live shell with zsh -ic 'alias' rather than grepping files, then follow each alias body to its target command, skipping prefixes like sudo, command, and nocorrect. Classify each as alive, missing, or undeterminable.

How to check if Brewfile matches installed Homebrew packages?

Run brew bundle check to verify everything in the Brewfile is installed, then check the reverse direction for installed packages missing from the Brewfile, since those would be lost on the next machine.

Why does grepping config files miss broken aliases?

File-based grep misses nested aliases and functions defined by plugins or chained through other aliases. Resolving from a live interactive shell captures the actual runtime definitions and their true reference targets.

Can this audit detect obsolete tool definitions after migration?

Yes, it cross-references missing references against current setup signals such as successor tools being installed, absence from the Brewfile, and undefined targets, then presents a reasoned recommendation before any removal.

Does the audit modify or delete my dotfiles automatically?

No, it never deletes definitions or installs tools without confirmation. Each actionable finding is presented with an assessment, and you choose whether to install, remove, or defer via a prompt.