itda-skills

Appearance

itda-skills 설치 가이드 ​

이 문서는 Claude Code(AI 에이전트)가 읽고 실행하는 설치 지침입니다. 각 단계를 순서대로 실행하고, 조건 분기에 따라 적절한 경로를 선택하세요.

사전 확인: 기존 설치 감지 ​

먼저 itda-skills-go가 이미 설치되어 있는지 확인합니다.

  • macOS/Linux: Bash 도구로 which itda-skills-go 실행
  • Windows: 명령 프롬프트에서 where itda-skills-go 실행

IF 바이너리가 이미 존재하면: 업데이트 경로로 이동 IF 바이너리가 없으면: 아래 신규 설치를 진행합니다

신규 설치 ​

Step 1: 환경 감지 ​

OS와 아키텍처를 감지합니다.

  • macOS: Bash 도구로 uname -s → "Darwin" 반환
    • arm64: uname -m → "arm64"
    • amd64: uname -m → "x86_64"
  • Linux: Bash 도구로 uname -s → "Linux" 반환
    • arm64: uname -m → "aarch64" 또는 "arm64"
    • amd64: uname -m → "x86_64"
  • Windows: 명령 프롬프트에서 echo %PROCESSOR_ARCHITECTURE% 실행
    • arm64: "ARM64"
    • amd64: "AMD64" 또는 "x86"

Step 2: 최신 안정 버전 확인 ​

R2 CDN에서 최신 stable 버전을 가져옵니다.

WebFetch 도구로 다음 URL을 요청하세요:

https://pub-1a25dd5e883745498716e9e3a01c1657.r2.dev/skills.pub/channels/stable

응답 텍스트가 버전 문자열입니다 (예: v0.2.1). 이를 VERSION으로 저장합니다.

IF WebFetch 실패 시: VERSION을 v0.2.1로 설정하고 계속 진행합니다.

Step 3: 바이너리 다운로드 ​

Step 1에서 감지한 OS/아키텍처에 맞는 바이너리 URL을 결정합니다.

Go CLI 바이너리 URL 형식:

https://pub-1a25dd5e883745498716e9e3a01c1657.r2.dev/skills.pub/{VERSION}/itda-skills-go-{OS}-{ARCH}
OSARCH파일명
macOS (arm64)darwin-arm64itda-skills-go-darwin-arm64
macOS (amd64)darwin-amd64itda-skills-go-darwin-amd64
Linux (arm64)linux-arm64itda-skills-go-linux-arm64
Linux (amd64)linux-amd64itda-skills-go-linux-amd64
Windows (arm64)windows-arm64itda-skills-go-windows-arm64.exe
Windows (amd64)windows-amd64itda-skills-go-windows-amd64.exe

Bun CLI 바이너리 URL 형식:

https://pub-1a25dd5e883745498716e9e3a01c1657.r2.dev/skills.pub/{VERSION}/itda-skills-bun-{OS}-{ARCH}
OSARCH파일명
macOS (arm64)darwin-arm64itda-skills-bun-darwin-arm64
macOS (amd64)darwin-amd64itda-skills-bun-darwin-amd64
Linux (arm64)linux-arm64itda-skills-bun-linux-arm64
Linux (amd64)linux-amd64itda-skills-bun-linux-amd64
Windows (arm64)windows-arm64itda-skills-bun-windows-arm64.exe
Windows (amd64)windows-amd64itda-skills-bun-windows-amd64.exe

macOS/Linux 다운로드:

Bash 도구로 실행:

bash
curl -fSL "{GO_BINARY_URL}" -o /tmp/itda-skills-go
curl -fSL "{BUN_BINARY_URL}" -o /tmp/itda-skills-bun

Windows 다운로드:

PowerShell에서 실행:

powershell -Command "Invoke-WebRequest -Uri '{GO_BINARY_URL}' -OutFile '$env:TEMP\itda-skills-go.exe'"
powershell -Command "Invoke-WebRequest -Uri '{BUN_BINARY_URL}' -OutFile '$env:TEMP\itda-skills-bun.exe'"

IF 다운로드 실패 시: 네트워크 연결을 확인하고 URL이 정확한지 확인하세요. VERSION을 최신 버전으로 재시도합니다.

Step 4: 설치 및 PATH 설정 ​

macOS/Linux:

  1. 설치 디렉토리 생성: Bash 도구로 mkdir -p ~/.local/bin 실행
  2. 바이너리 이동:
    bash
    mv /tmp/itda-skills-go ~/.local/bin/itda-skills-go
mv /tmp/itda-skills-bun ~/.local/bin/itda-skills-bun
chmod +x ~/.local/bin/itda-skills-go
chmod +x ~/.local/bin/itda-skills-bun
  3. PATH 설정 확인: Bash 도구로 echo $PATH 실행
    • IF ~/.local/bin이 PATH에 없으면:
      • macOS (zsh): ~/.zshrc에 export PATH="$PATH:$HOME/.local/bin" 추가
      • Linux (bash): ~/.bashrc에 export PATH="$PATH:$HOME/.local/bin" 추가

Windows:

  1. 설치 디렉토리 생성: PowerShell에서 실행
    powershell -Command "New-Item -ItemType Directory -Force -Path '$env:USERPROFILE\AppData\Local\itda-skills'"
  2. 바이너리 이동:
    powershell -Command "Move-Item '$env:TEMP\itda-skills-go.exe' '$env:USERPROFILE\AppData\Local\itda-skills\itda-skills-go.exe' -Force"
powershell -Command "Move-Item '$env:TEMP\itda-skills-bun.exe' '$env:USERPROFILE\AppData\Local\itda-skills\itda-skills-bun.exe' -Force"
  3. PATH 설정:
    powershell -Command "[System.Environment]::SetEnvironmentVariable('Path', $env:Path + ';$env:USERPROFILE\AppData\Local\itda-skills', 'User')"

Step 5: 플러그인 등록 ​

Claude Code에 itda-skills 플러그인을 등록합니다.

Bash 도구로 실행:

bash
itda-skills-go setup

setup 명령은 Claude Code 설정 파일(~/.claude/settings.json)에 플러그인을 자동 등록합니다.

IF setup 명령 실패 시: 다음을 수동으로 실행하세요:

  • Bash 도구로 itda-skills-go setup --verbose 실행하여 오류 확인
  • ~/.claude/settings.json에 플러그인 경로가 올바른지 확인

Step 6: 환경 검증 ​

Bash 도구로 실행:

bash
itda-skills-go doctor

출력 확인:

  • [OK] itda-skills-go — Go CLI 정상
  • [OK] itda-skills-bun — Bun CLI 정상
  • [OK] Claude Code plugin — 플러그인 등록 완료

IF 문제 발생 시:

  • [WARN] PATH not set: Step 4의 PATH 설정을 다시 확인하세요
  • [WARN] Plugin not registered: Step 5를 다시 실행하세요

Step 7: 설치 완료 ​

설치가 완료되었습니다. 다음 스킬과 커맨드를 사용할 수 있습니다:

자동 트리거 스킬 (자연어로 사용):

  • 이메일·보고서·기안서 작성 → itda-doc-coach
  • 회의 준비·정리 → itda-meeting-partner
  • 나라장터 입찰 분석 → itda-g2b-coach

슬래시 커맨드:

  • /itda:email-draft — 이메일 즉시 작성
  • /itda:report-draft — 보고서 변환
  • /itda:doc-review — 문서 검토
  • /itda:meeting — 회의록 생성
  • /itda:slide-pptx — PPT 파일 생성
  • /itda:g2b — 나라장터 코칭

업데이트 경로 ​

기존 itda-skills-go가 설치된 경우:

Bash 도구로 실행:

bash
itda-skills-go update

최신 stable 버전으로 자동 업데이트됩니다.

IF update 명령이 없는 구버전이면: 신규 설치 경로(Step 1~7)를 따라 덮어쓰기 설치합니다.

설치 시나리오별 안내 ​

플러그인만 설치 (CLI 없이 스킬/커맨드만 등록) ​

바이너리 없이 스킬과 커맨드만 필요한 경우:

  1. WebFetch로 플러그인 릴리즈 URL 확인:
    https://pub-1a25dd5e883745498716e9e3a01c1657.r2.dev/skills.pub/channels/stable
  2. 플러그인 ZIP 다운로드:
    https://pub-1a25dd5e883745498716e9e3a01c1657.r2.dev/skills.pub/{VERSION}/itda-skills-{OS}-{ARCH}.plugin
  3. ZIP을 ~/.claude/plugins/itda-skills/에 압축 해제
  4. ~/.claude/settings.json에 플러그인 경로 추가

CLI만 설치 (PPT 생성 등 CLI 기능만 필요) ​

Step 1~4만 실행하고 Step 5(플러그인 등록)는 건너뜁니다.

Claude Code 플러그인

© 2026 itda-skills