스킬팩 사용 안내 — 설치부터 첫 기능 구현까지

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. 라이선스는 다시 등록하지 않아도 됩니다.

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

실전 프롬프트는 정책(요구사항) 수준이라 어떤 스택에도 적용됩니다. 스킬이 스택을 확인한 뒤 그대로 진행할지 물어봅니다.