setup-machine

Orchestrates ordered installation of agent environment components on new machines with conflict management.

1|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/psw7205/skills --skill setup-machine-psw7205
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup-machine
Source: https://github.com/psw7205/skills/tree/main/skills/setup-machine
Command: npx skills add https://github.com/psw7205/skills --skill setup-machine-psw7205

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new machine or account with a working AI agent environment requires installing many interdependent pieces (dotfiles, global instructions, safety hooks, session logs, statusline, herdr config) in the right order, and doing it manually leads to missed prerequisites, conflicting settings.json writes, and silent skips. ## Core Features & Use Cases - Ordered orchestration: Delegates each setup item to its owning sub-skill (setup-dotfiles, setup-global-config, setup-hooks, session-log, statusline, setup-herdr) while owning only sequencing, prerequisites, and conflict management. - Single-pass settings.json writes: Collects changes from hooks, session-log, and statusline into one read-modify-write so sequential edits do not overwrite each other. - Profile detection and audit mode: Detects OS and tool availability (python3, jq, herdr, codex), distinguishes prerequisite-missing from already-installed skips, and supports a read-only inspection mode that reports what is missing without changing anything. - Use Case: You get a new laptop and say "set up this machine" — the skill installs sub-skills if missing, runs each component in dependency order, and ends with a per-item installed/skipped/failed report plus the manual steps you still need to do. ## Quick Start Set up this new machine with the full agent environment and give me a report of what was installed or skipped.

Frequently Asked Questions about setup-machine

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

FAQPage Schema
How do I set up a new machine for Claude Code or Codex development?▼

Use an orchestration approach that installs components in dependency order: dotfiles baseline first, then global agent instructions, safety hooks, session logging, statusline, and herdr config. Each component is owned by a dedicated sub-skill so procedures are not duplicated.

What order should I install dotfiles, hooks, and agent settings?▼

Install dotfiles first because package managers like Brewfile install python3, jq, and herdr that later components depend on. Global instructions come next, then safety hooks so mistakes during remaining steps are already blocked.

Why do multiple tools editing settings.json overwrite each other?▼

Sequential read-modify-write cycles cause earlier additions to be lost when a later step writes the file. Collect all key changes from hooks, session-log, and statusline, then apply them in a single write pass.

Can I audit my machine setup without changing anything?▼

Yes, inspection mode runs detection and reporting only, without executing install commands or writing config files. It reports each item as installed, skipped with reason, or failed with reason.

What happens if python3 or jq is missing during environment setup?▼

Items with unmet prerequisites are skipped individually while the rest of the setup completes. Tool detection re-runs after the dotfiles step because Brewfile may have just installed those tools.