setup-guide

Validate the current repo environment against human/SETUP.md instructions.

8|2|Updated May 3, 2026
One-click install
npx skills add https://github.com/ejoongseok/claude-settings --skill setup-guide-ejoongseok
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-guide
Source: https://github.com/ejoongseok/claude-settings/tree/main/claude-code/skills/setup-guide
Command: npx skills add https://github.com/ejoongseok/claude-settings --skill setup-guide-ejoongseok

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill prevents onboarding and environment setup from drifting out of sync with the actual project by continuously checking, updating, and capturing the real setup knowledge.

Core Features & Use Cases

  • Environment verification (check): Compares the current runtime/build/MCP/hook state against human/SETUP.md to detect mismatches.
  • Safe synchronization (update): Detects changes from code/config sources and updates human/SETUP.md with user confirmation while preserving human-only sections.
  • Knowledge capture (capture): Adds implicit knowledge and troubleshooting outcomes based on user-provided text, with structured formatting and de-duplication.
  • Change review (diff): Shows only the proposed differences (for update) to decide whether to proceed.

Quick Start

Run setup-guide in check mode by telling the AI: "/setup-guide check".

Frequently Asked Questions about setup-guide

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

FAQPage Schema
How do I keep my developer onboarding documentation from becoming outdated?

Prevent onboarding documentation drift by validating the current repo environment against SETUP.md. The tool reads configuration sources, executes read-only version checks, and detects mismatches to keep setup instructions accurate.

How do I capture troubleshooting knowledge discovered during environment setup?

Capture troubleshooting knowledge by providing implicit setup outcomes as text input. The tool formats the knowledge structurally, de-duplicates it, and appends it to SETUP.md while preserving existing human-only sections.

Can I review proposed changes to my setup guide before applying them?

Review proposed setup guide changes by running the diff mode. The tool compares current runtime and configuration sources against SETUP.md, showing only the proposed differences so you can decide whether to proceed before applying modifications.

How do I verify my MCP and hook configurations match the documented environment setup?

Verify MCP and hook configurations by running the check mode. The tool compares the current runtime, build, and hook state against SETUP.md to detect mismatches, ensuring your documented environment setup remains synchronized with the actual project.

Does the setup-guide update process overwrite my custom notes in SETUP.md?

The update process does not overwrite custom notes because it preserves human-only sections in SETUP.md. It safely synchronizes detected dependency and configuration changes with your explicit confirmation before applying any modifications.

How do I track environment changes for dependencies and hooks in my repository?

Track environment changes by extracting runtime, build, and configuration sources from the project root. The tool detects dependency and hook modifications, validating them against SETUP.md to maintain accurate developer onboarding instructions.