How do I install the Gh Setup skill?

Run npx skillmds@latest add gyeolhwi/gh-setup in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Gh Setup safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gh Setup?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gh Setup free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gh Setup?

gyeolhwi (@gyeolhwi) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gh Setup by gyeolhwi — Agent Skill

Name: Gh Setup
Author: gyeolhwi

Gh Setup

GitHub CLI(`gh`)가 없거나 로그인되어 있지 않을 때 Windows·WSL·Linux·macOS 를 판별해 설치 경로를 정하고, 권한이 필요 없는 명령은 자동 실행하고 관리자 권한이 필요한 명령은 그대로 복사해 쓸 수 있게 안내한 뒤 `gh auth login` 까지 끌고 갑니다. 설정은 `~/.issue/settings.json` 에서 관리합니다. `/gh-setup`, "gh 설치", "gh 로그인", "GitHub CLI 설정" 요청과 gh 가 필요한 다른 스킬의 전제 확인 실패 시 사용합니다.

gyeolhwi 47664a2 8 files · 67.2 KB Updated Sep 17, 2026

File contents

없음. 이 스킬이 전제를 만드는 쪽이다

전체 흐름

flowchart TD
    A[/"gh 필요 · /gh-setup"/] --> B[detect: OS·터미널·다운로더·패키지매니저]
    B --> C[settings.json 생성 또는 갱신]
    C --> D[status: gh 설치·인증 확인]

    D -->|설치됨 + 로그인됨| Z[준비 완료 · 원래 작업으로 복귀]
    D -->|설치 안 됨| E[plan: OS별 설치 명령 생성]

    E --> F{권한 필요?}
    F -- 불필요 --> G[install: 자동 실행]
    F -- 필요 --> H[사용자가 실행할 명령 제시]
    H --> H1[사용자 실행 대기]

    G --> I[status 재확인]
    H1 --> I
    I -->|실패| E

    I -->|설치 확인| J{로그인됨?}
    D -->|설치됨 + 로그인 안 됨| J
    J -- 예 --> Z
    J -- 아니오 --> K[환경별 login 명령 안내]
    K --> K1[사용자 실행 대기] --> L[gh auth status 확인] --> Z

스크립트 경로

아래 중 존재하는 첫 번째 경로를 <skill> 로 쓴다.

.claude/skills/gh-setup      # 현재 프로젝트 (Claude Code)
.codex/skills/gh-setup       # 현재 프로젝트 (Codex)
~/.claude/skills/gh-setup    # 홈 설치
~/.codex/skills/gh-setup     # 홈 설치

런타임 라우팅

항상 라우터를 부른다. 라우터가 node → python 순으로 찾아 넘기고, 둘 다 없으면 자체 폴백으로 처리한다.

sh <skill>/scripts/gh-env.sh <서브커맨드>            # macOS / Linux / WSL
powershell -ExecutionPolicy Bypass -File <skill>/scripts/gh-env.ps1 <서브커맨드>   # Windows

출력의 RUNTIME= 으로 어느 구현이 돌았는지 알 수 있다 (node / python / sh / ps1). 폴백(sh / ps1)은 감지와 안내까지만 한다. install 자동 실행과 config set 은 지원하지 않는다.

서브커맨드

detect              감지 후 ~/.issue/settings.json 생성·갱신
status              gh 설치·인증 확인 후 settings.gh 갱신
plan                OS별 설치 명령 목록 ([auto] / [user] / [guide] 표시)
install [--dry-run] [auto] 표시된 명령만 실행
login               환경에 맞는 로그인 방법 안내
config get [key]    설정 읽기
config set <k> <v>  terminals / downloaders 순서 변경 (쉼표 구분)

실행 순서

1단계 — 감지와 상태 확인

sh <skill>/scripts/gh-env.sh detect
sh <skill>/scripts/gh-env.sh status

GH_INSTALLED=1 이고 GH_AUTHENTICATED=1 이면 여기서 끝이다. 바로 원래 작업으로 돌아간다.

2단계 — 설치

sh <skill>/scripts/gh-env.sh plan
sh <skill>/scripts/gh-env.sh install

install 은 [auto] 단계만 실행한다. [user] 로 남은 명령은 사용자에게 이렇게 전달한다.

아래 명령을 프롬프트에 그대로 붙여 실행해 주세요 (`!` 로 시작하면 이 세션에서 바로 돌아갑니다).

! sudo apt update && sudo apt install gh -y

세부 매트릭스는 references/install-matrix.md.

3단계 — 로그인

sh <skill>/scripts/gh-env.sh login

LOGIN_REQUIRED=1 이면 안내된 명령을 사용자가 실행할 때까지 기다린다. 세부는 references/auth-login.md.

4단계 — 확인과 복귀

sh <skill>/scripts/gh-env.sh status

GH_INSTALLED=1, GH_AUTHENTICATED=1 을 확인한 뒤 원래 작업을 이어간다.

마무리 보고

플랫폼    <os> / <arch> (<family>)
터미널    <선호 0번>
gh       <버전> · 로그인 <계정>
설정      ~/.issue/settings.json
다음      <원래 하려던 작업>

---name: gh-setupdescription: GitHub CLI(`gh`)가 없거나 로그인되어 있지 않을 때 Windows·WSL·Linux·macOS 를 판별해 설치 경로를 정하고, 권한이 필요 없는 명령은 자동 실행하고 관리자 권한이 필요한 명령은 그대로 복사해 쓸 수 있게 안내한 뒤 `gh auth login` 까지 끌고 갑니다. 설정은 `~/.issue/settings.json` 에서 관리합니다. `/gh-setup`, "gh 설치", "gh 로그인", "GitHub CLI 설정" 요청과 gh 가 필요한 다른 스킬의 전제 확인 실패 시 사용합니다.---<skill> <purpose> `gh` 를 쓰는 모든 흐름의 진입 장벽을 없앤다. OS·터미널·다운로드 도구·패키지 매니저를 감지해 설정 파일에 남기고, 그 조합에 맞는 설치 명령을 만들어 자동 실행하거나 정확히 안내한다. 마지막으로 로그인까지 확인한다. </purpose> <inputs> <arg name="$ARGUMENTS" required="false">`install` / `login` / `status` 같은 원하는 단계. 생략하면 전체 흐름</arg> </inputs> <preconditions> <item>없음. 이 스킬이 전제를 만드는 쪽이다</item> </preconditions> <routing> <always>references/settings.md — settings.json 스키마와 선호도 편집</always> <branch name="install" when="gh 가 설치되어 있지 않음">references/install-matrix.md</branch> <branch name="login" when="gh 는 있는데 인증이 안 됨">references/auth-login.md</branch> </routing> <hard-rules> <rule>sudo 나 관리자 권한이 필요한 명령을 대신 실행하지 않는다. 비밀번호 프롬프트에서 멈춘다.</rule> <rule>권한이 필요 없는 패키지 매니저 설치만 자동 실행한다.</rule> <rule>`gh auth login` 은 대화형이므로 사용자가 직접 실행하게 한다.</rule> <rule>토큰 값을 출력하거나 파일로 저장하지 않는다.</rule> <rule>사용자가 설정 파일에 넣어 둔 선호 순서를 재감지로 덮어쓰지 않는다.</rule> </hard-rules> <handoff> `gh` 준비가 끝나면 원래 하려던 작업(`issue-create` / `issue-start` / `issue-end` 등)으로 돌아간다. </handoff></skill># 전체 흐름```mermaidflowchart TD A[/"gh 필요 · /gh-setup"/] --> B[detect: OS·터미널·다운로더·패키지매니저] B --> C[settings.json 생성 또는 갱신] C --> D[status: gh 설치·인증 확인] D -->|설치됨 + 로그인됨| Z[준비 완료 · 원래 작업으로 복귀] D -->|설치 안 됨| E[plan: OS별 설치 명령 생성] E --> F{권한 필요?} F -- 불필요 --> G[install: 자동 실행] F -- 필요 --> H[사용자가 실행할 명령 제시] H --> H1[사용자 실행 대기] G --> I[status 재확인] H1 --> I I -->|실패| E I -->|설치 확인| J{로그인됨?} D -->|설치됨 + 로그인 안 됨| J J -- 예 --> Z J -- 아니오 --> K[환경별 login 명령 안내] K --> K1[사용자 실행 대기] --> L[gh auth status 확인] --> Z```# 스크립트 경로아래 중 **존재하는 첫 번째 경로**를 `<skill>` 로 쓴다.```text.claude/skills/gh-setup # 현재 프로젝트 (Claude Code).codex/skills/gh-setup # 현재 프로젝트 (Codex)~/.claude/skills/gh-setup # 홈 설치~/.codex/skills/gh-setup # 홈 설치```# 런타임 라우팅항상 **라우터**를 부른다. 라우터가 node → python 순으로 찾아 넘기고, 둘 다 없으면 자체 폴백으로 처리한다.```bashsh <skill>/scripts/gh-env.sh <서브커맨드> # macOS / Linux / WSLpowershell -ExecutionPolicy Bypass -File <skill>/scripts/gh-env.ps1 <서브커맨드> # Windows```출력의 `RUNTIME=` 으로 어느 구현이 돌았는지 알 수 있다 (`node` / `python` / `sh` / `ps1`).폴백(`sh` / `ps1`)은 감지와 안내까지만 한다. `install` 자동 실행과 `config set` 은 지원하지 않는다.# 서브커맨드```textdetect 감지 후 ~/.issue/settings.json 생성·갱신status gh 설치·인증 확인 후 settings.gh 갱신plan OS별 설치 명령 목록 ([auto] / [user] / [guide] 표시)install [--dry-run] [auto] 표시된 명령만 실행login 환경에 맞는 로그인 방법 안내config get [key] 설정 읽기config set <k> <v> terminals / downloaders 순서 변경 (쉼표 구분)```# 실행 순서## 1단계 — 감지와 상태 확인```bashsh <skill>/scripts/gh-env.sh detectsh <skill>/scripts/gh-env.sh status````GH_INSTALLED=1` 이고 `GH_AUTHENTICATED=1` 이면 여기서 끝이다. 바로 원래 작업으로 돌아간다.## 2단계 — 설치```bashsh <skill>/scripts/gh-env.sh plansh <skill>/scripts/gh-env.sh install````install` 은 `[auto]` 단계만 실행한다. `[user]` 로 남은 명령은 사용자에게 이렇게 전달한다.```text아래 명령을 프롬프트에 그대로 붙여 실행해 주세요 (`!` 로 시작하면 이 세션에서 바로 돌아갑니다).! sudo apt update && sudo apt install gh -y```세부 매트릭스는 `references/install-matrix.md`.## 3단계 — 로그인```bashsh <skill>/scripts/gh-env.sh login````LOGIN_REQUIRED=1` 이면 안내된 명령을 사용자가 실행할 때까지 기다린다. 세부는 `references/auth-login.md`.## 4단계 — 확인과 복귀```bashsh <skill>/scripts/gh-env.sh status````GH_INSTALLED=1`, `GH_AUTHENTICATED=1` 을 확인한 뒤 원래 작업을 이어간다.## 마무리 보고```text플랫폼 <os> / <arch> (<family>)터미널 <선호 0번>gh <버전> · 로그인 <계정>설정 ~/.issue/settings.json다음 <원래 하려던 작업>```

Frequently asked questions