« 목차로 돌아가기

18. 사전 준비와 설치

ywc-* Skill 을 안정적으로 쓰려면 몇 가지 Tool 이 미리 준비되어 있어야 합니다. Plugin marketplace 나 Codex plugin 으로 설치하면 파일 복사와 등록은 자동으로 처리되지만, Skill 을 실제로 실행할 때는 아래 Tool 들이 System 에 있어야 정상 동작합니다. 순서는 다음과 같습니다 — ① 필수 Tool 설치 → ② ywc-agent-toolkit 자체 설치 (Claude Code / Codex) → 그 아래는 상황에 따라 준비하면 되는 선택 Tool 입니다.

#필수 Tool

이 중 uv 만 Claude Code 전용이고, 나머지는 Claude Code 와 Codex 모두에 공통으로 필요합니다.

gh 는 설치만으로는 부족하고, 인증까지 끝나야 PR 을 다루는 Skill(ywc-create-pr, ywc-handle-pr-reviews, ywc-merge-dependabot 등)이 정상 동작합니다.

$gh auth login
gh auth setup-git
gh auth status

환경 변수 (필요할 때만)

기본값으로도 대부분 동작하며, 아래는 위치나 동작을 바꾸고 싶을 때만 설정하는 선택 항목입니다.

#ywc-agent-toolkit 설치

사용 중인 Tool 탭을 선택하세요. 두 경로 모두 사전 요구사항이 없습니다.

방법 1 — Plugin 마켓플레이스 (권장)

/plugin marketplace add yongwoon/ywc-agent-toolkit

/plugin install ywc-agent-toolkit@ywc-agent-toolkit

$codex plugin marketplace add yongwoon/ywc-agent-toolkit

$codex plugin add ywc-agent-toolkit@ywc-agent-toolkit

첫 번째 명령이 marketplace source 를 등록하고, 두 번째 명령이 ywc-agent-toolkit 을 실제로 설치합니다. Codex 에서 이미 marketplace 를 추가한 상태라면 codex plugin marketplace upgrade ywc-agent-toolkit 으로 최신 snapshot 을 받아올 수 있습니다.

방법 2 — Bash 스크립트 fallback

Plugin marketplace 설치가 어려운 환경에서는 repository 를 clone 한 뒤 fallback script 를 사용합니다. 설치 가능한 skill/agent 목록은 아래로 확인할 수 있습니다.

$bash scripts/install.sh --list

$bash scripts/install.sh --cc

$bash scripts/install.sh --cc-agents

$bash scripts/install.sh --codex

$bash scripts/install.sh --codex-agents

Claude Code 와 Codex 를 모두 쓴다면 한 번에 설치할 수 있습니다.

$bash scripts/install.sh --all

#선택 Tool — 로컬 CI 수준 검증 (기여자 · maintainer 권장)

PR 을 열기 전에 GitHub Actions 와 같은 수준으로 로컬에서 미리 검증하고 싶다면 아래를 추가로 설치합니다. Skill 사용 자체에는 필수가 아닙니다.

$brew install shellcheck
npm install -g markdownlint-cli2

node, npm, npx 는 markdownlint-cli2, Playwright, JS/TS cleanup Tool 실행에 필요합니다 — version manager(nvm, volta 등)로 설치하는 편이 관리가 쉽습니다.

$node --version
npm --version
npx --version
shellcheck --version
markdownlint-cli2 --version

#선택 Tool — 디자인 관련 Skill 준비

디자인 관련 Skill 을 자주 쓸 계획이라면 impeccable 을 미리 설치해 두는 것을 권장합니다. 특히 ywc-design-renew, ywc-ui-ux-review 처럼 UI 품질을 다루는 Skill 은 프로젝트의 디자인 컨텍스트와 anti-pattern 검출 기준이 준비되어 있을수록 결과가 안정적입니다.

$npx impeccable install

설치 후 Claude Code 또는 Codex 를 다시 열고, 새 프로젝트에서는 /impeccable init 으로 디자인 컨텍스트를 먼저 만들어 두면 이후 디자인 관련 Skill 이 그 기준을 참고할 수 있습니다.

#선택 Tool — 상황별 Language/도메인 Tool

아래 Tool 은 모든 project 에 전역 설치할 필요는 없습니다. 해당 language 나 Skill 을 자주 쓸 때만 준비하면 됩니다.

$npx knip
npx depcheck
npx ts-prune
ruff check .
mypy .
pyright
go install golang.org/x/tools/cmd/deadcode@latest
npx playwright install --with-deps chromium

#설치 확인 Command

Skill 을 처음 실행하기 전에, 아래로 필수 Tool 이 제대로 잡히는지 한 번에 확인할 수 있습니다.

$git --version
bash --version
jq --version
python3 --version
gh auth status
curl --version
uv --version
rg --version

PR 기반 Skill 을 다룰 예정이라면 gh 상태를 별도로 한 번 더 확인해 두면 좋습니다.

$gh auth status
gh repo view --json nameWithOwner --jq .nameWithOwner
gh pr checks --watch

← 이전: 17. 전체 Skill 레퍼런스 · 목차로 돌아가기 »