헤이제임스 - 스킬팩 사용 안내 — 설치부터 첫 기능 구현까지

1. 설치하기

터미널에 아래 한 줄을 붙여넣으세요. 쓰시는 코딩 에이전트를 찾아서 연결해요.

터미널

git clone --single-branch --depth 1 https://github.com/heyjames-ai/skills.git ~/.heyjames/pack && ~/.heyjames/pack/setup

설치기가 세 가지를 물어요. 전부 엔터만 눌러도 기본값으로 설치돼요.

1

어떤 에이전트에서 쓸지

이 컴퓨터에서 찾은 에이전트만 번호로 보여줘요. 쉼표로 여러 개를 고를 수 있어요.
2

전역 / 이 프로젝트만

전역이면 모든 프로젝트에서 써요. 특정 프로젝트에만 두려면 2번을 고르세요.
3

심볼릭 링크 / 복사

링크면 원본 한 곳에 연결해서, 나중에 git pull 한 번으로 전부 바뀌어요.

설치가 끝나면 에이전트를 한 번 다시 시작하세요. 스킬 목록에 hj- 로 시작하는 스킬이 보여요.

2. 라이선스 등록

무료 스킬 3종(회원가입 · 쿠폰 · 관리자 화면)은 등록 없이 바로 써요. 나머지 17종은 스킬팩을 구매하고 라이선스 키를 등록하면 열려요.

1

스킬팩을 구매해요
2

마이페이지 → 스킬팩 라이선스에서 키를 받아요

받는 화면에 복사 버튼이 있어요.
3

터미널에서 키를 등록해요

에이전트에게 「헤이제임스 라이선스 등록」이라고 말해도 돼요.

라이선스 등록

~/.heyjames/setup <라이선스키>

라이선스는 에이전트마다가 아니라 컴퓨터 단위로 저장돼요. 한 번 등록하면 클로드 코드 · 코덱스 어디서든 열려요.

스킬팩 구매하기

3. 스킬 사용법

명령어를 외울 필요가 없어요. 평소 말하듯 요청하면 맞는 스킬이 알아서 잡혀요.

이렇게 말하면 돼요

“쿠폰 기능 구현해줘”
“결제 붙여줘, 환불까지”
“포인트 적립 만들어줘”
“헤이제임스 스킬 목록 보여줘”

어느 스킬인지 애매하면 hj 라우터가 목록을 보여주고 고르게 해요.

요청하면 이 순서로 움직여요

1

스택을 먼저 확인해요

레일즈면 바로 진행하고, 아니면 지금 스택 그대로 갈지 물어요.
2

실전 프롬프트를 프로젝트에 맞게 바꿔요

예시 서비스명 · 금액 · 비율을 실제 서비스 기준으로 바꿔요.
3

정하지 않은 정책을 먼저 물어요

「환불은 며칠까지 받나요?」 같은 것들이에요. 여기서 답한 게 그대로 설계가 돼요.
4

구현하고 체크리스트로 확인해요

오픈 전 체크리스트 8~20개 항목을 하나씩 확인하고 결과를 알려줘요.

4. 주요 스킬 구성

무료 3종과 스킬팩 17종이에요. 옆의 문구를 그대로 말하면 그 스킬이 실행돼요.

서비스의 뼈대

프로젝트를 시작하는 순간부터, 무엇을 만들든 먼저 필요한 것들

레일즈 프로젝트 생성 — 표준 레이아웃 스킬팩 “레일즈 프로젝트 만들어줘”
실전 회원가입 프롬프트 가이드 무료 “회원가입 기능 구현해줘”
실전 소셜 로그인 프롬프트 가이드 스킬팩 “카카오 로그인 붙여줘”
실전 관리자 화면 프롬프트 가이드 무료 “관리자 화면 만들어줘”
실전 접근권한 프롬프트 가이드 스킬팩 “권한 관리 구현해줘”

돈이 오가는 기능

금액·환불·정산처럼 한 번 잘못 만들면 되돌리기 어려운 영역

실전 결제·환불 프롬프트 가이드 스킬팩 “결제 기능 구현해줘”
실전 구독 결제 프롬프트 가이드 스킬팩 “구독 결제 구현해줘”
실전 쿠폰 프롬프트 가이드 무료 “쿠폰 기능 구현해줘”
실전 포인트 프롬프트 가이드 스킬팩 “포인트 기능 구현해줘”
실전 판매자 정산 프롬프트 가이드 스킬팩 “정산 기능 구현해줘”

사용자가 모이는 기능

글·댓글·알림처럼 사용자끼리 부딪히는 지점

실전 리뷰·댓글 프롬프트 가이드 스킬팩 “리뷰 기능 구현해줘”
실전 채팅 프롬프트 가이드 스킬팩 “채팅 기능 구현해줘”
실전 알림 발송 프롬프트 가이드 스킬팩 “알림 기능 구현해줘”
실전 상품 목록·검색 프롬프트 가이드 스킬팩 “검색 기능 구현해줘”
실전 파일 업로드 프롬프트 가이드 스킬팩 “파일 업로드 기능 만들어줘”
매칭 플랫폼 실전 프롬프트 가이드 스킬팩 “매칭 기능 구현해줘”

서비스를 키울 때

다 만든 다음에 부딪히는 문제들

디자인·UX 개선 실전 프롬프트 가이드 스킬팩 “디자인 개선해줘”
실전 다국어·글로벌 프롬프트 가이드 스킬팩 “다국어 지원 구현해줘”
실전 AI 상담 기능 프롬프트 가이드 스킬팩 “AI 상담 기능 구현해줘”
실전 개발·실서버 DB 분리 가이드 스킬팩 “개발 DB 분리해줘”

5. 설치 옵션 · 업데이트 · 제거

질문 없이 바로 깔거나, 나중에 다른 에이전트를 더할 때 쓰는 명령이에요.

질문 없이 지정한 에이전트에 설치

~/.heyjames/setup -a claude-code,codex -g -y

나중에 코덱스를 더 쓰게 됐을 때

~/.heyjames/setup -a codex -g -y

이 프로젝트에만 설치 (복사 방식)

~/.heyjames/setup -p --copy

최신 스킬로 업데이트

git -C ~/.heyjames/pack pull && ~/.heyjames/setup -y

제거 (라이선스 키는 남아요)

~/.heyjames/setup --uninstall

~/.heyjames/setup 은 설치할 때 만들어져요. 팩을 어디에 받아 뒀든 이 경로로 실행되니 위 명령을 그대로 쓰세요.

실전 프롬프트 본문은 서버에서 받아 와서, 내용이 좋아지면 업데이트 없이 바로 반영돼요. git pull 은 새 스킬이 생겼을 때만 필요해요.

6. 잘 안 될 때

스킬이 목록에 안 보여요

설치한 뒤 에이전트를 다시 시작했는지 먼저 확인하세요. 그래도 없으면 ~/.heyjames/setup 을 다시 실행하면 몇 개가 연결됐는지 알려줘요.

「구매 내역이 없습니다」라고 나와요

스킬팩을 구매한 계정으로 받은 키가 맞는지 확인하세요. 키를 다시 받으면 이전 키는 바로 막히니, 새 키로 다시 등록하면 돼요.

라이선스 키가 유효하지 않다고 나와요

마이페이지에서 키를 다시 복사해 setup <키> 로 등록하세요. 앞뒤에 공백이 섞여 들어가는 경우가 가장 흔해요.

코덱스에서도 쓰고 싶어요

스킬을 쓰다 보면 연결할지 한 번 물어요. 바로 하려면 ~/.heyjames/setup -a codex -g -y 를 실행하세요. 라이선스는 다시 등록하지 않아도 돼요.

레일즈 프로젝트가 아닌데 괜찮나요

실전 프롬프트는 정책(요구사항) 수준이라 어떤 스택에도 맞아요. 스킬이 스택을 확인하고 그대로 진행할지 물어요.

더 궁금한 점은 문의로 남겨 주세요.

스킬팩 소개 보기