내 ~/.claude를 안 건드리고 Claude Code 스킬만 골라 설치하는 법 (feiskyer/claude-code-settings)

"좋아 보이는 Claude Code 스킬 모음을 받고 싶은데, 안내문에 mv ~/.claude ~/.claude.bak부터 나온다. 지금 쓰는 설정을 통째로 백업하고 갈아끼우라는 건데, 이거 그대로 따라 해도 되나?"

이 글은 그 망설임에서 멈춘 초중급 개발자를 위한 것입니다. 결론부터 말하면, 전체 설정을 교체하지 않고 원하는 스킬만 골라 넣는 길이 따로 있습니다. 오늘 만들 산출물은 (1) 안전하게 스킬만 설치하는 명령 한 줄과 (2) 설치 후 "제대로 들어갔나"를 확인하는 체크리스트입니다.

이 모음(feiskyer/claude-code-settings)은 뭘 주는가

feiskyer/claude-code-settings는 Claude Code용 설정·스킬·서브에이전트를 한데 모은 저장소입니다. 여기서 스킬(skill)은 "특정 작업을 어떻게 처리하는지 Claude에게 미리 가르쳐 둔 재사용 가능한 능력"입니다. 예를 들어 회의록을 받으면 자막을 뽑고, 이미지를 그려주는 식의 작업 묶음이라고 보면 됩니다. /스킬이름으로 부르거나 상황에 맞으면 자동으로 불려 나옵니다.

원문이 소개하는 스킬을 표로 추리면 이렇습니다.

스킬	하는 일	추가로 필요한 것
codex-skill	OpenAI Codex로 작업 위임(비대화형 자동 실행)	Codex CLI
autonomous-skill	여러 세션에 걸친 장시간 작업 자동화	Claude CLI
nanobanana-skill	Gemini로 이미지 생성·편집	GEMINI_API_KEY
gpt-image-skill	OpenAI GPT Image로 이미지 생성·편집	OPENAI_API_KEY
youtube-transcribe-skill	유튜브 영상 자막 추출	—

원문은 github.com/feiskyer/claude-code-settings에서 직접 확인할 수 있습니다.

설치 방법이 세 갈래라 헷갈린다 — 뭘 골라야 하나

원문은 세 가지 길을 줍니다. 차이를 먼저 잡아야 함정을 피합니다.

• 플러그인(/plugin marketplace add ...): 스킬과 에이전트를 통째로 또는 개별로 설치. 단, 원문이 못 박아 둔 함정이 있습니다 — ~/.claude/settings.json은 플러그인으로 설정되지 않아서 따로 수동 설정해야 합니다.
• 수동 설치(git clone): ~/.claude를 백업하고 저장소를 통째로 받는 방식. LiteLLM 프록시로 GitHub Copilot을 LLM 게이트웨이처럼 연결하는 설정까지 따라옵니다. 강력하지만 기존 설정을 갈아끼우는 부담이 큽니다.
• npx skills: AI 코딩 도구에 스킬만 설치. 전체 설정을 건드리지 않습니다.

기존 ~/.claude를 지키면서 맛부터 보고 싶다면 세 번째가 가장 부담이 적습니다.

오늘 만들 산출물: 스킬만 골라 넣는 명령

먼저 무엇이 들어 있는지 목록만 봅니다.

npx -y skills add -l feiskyer/claude-code-settings

마음에 드는 것만 고르려면 인자 없이 실행해 대화형으로 선택합니다.

npx -y skills add feiskyer/claude-code-settings

전부 넣고 싶으면 --all을 붙입니다.

npx -y skills add --all feiskyer/claude-code-settings

npx -y의 -y는 "이 패키지를 내려받아 실행할까요?"라는 확인을 건너뛰는 옵션입니다. 처음 실행하면 skills 패키지를 잠깐 받아오는데, 이 글을 쓰는 시점 기준 npm에 skills 패키지가 정상 게시되어 있고(버전 1.5.11), 실행 진입점은 bin/cli.mjs로 확인됩니다. 즉 npx skills라는 명령 자체는 실재합니다.

따라 하다 막히는 지점과 확인 체크리스트

npx는 Node.js와 함께 옵니다. 그래서 첫 함정은 거의 항상 환경입니다. 실행 전에 아래를 확인하세요.

node --version    # 예: v25.6.1
npm --version     # 예: 11.9.0

버전 숫자가 위와 똑같을 필요는 없습니다. 명령이 에러 없이 숫자를 출력하면 Node와 npm이 깔려 있다는 뜻이고, npx skills가 돌아갈 토대가 된 겁니다. 여기서 "command not found"가 나오면 스킬 설치가 아니라 Node 설치부터 해결해야 합니다.

설치를 끝냈다면 이 순서로 점검합니다.

1. 목록부터 — npx -y skills add -l ...로 저장소가 읽히고 스킬 이름이 뜨는지 확인. 여기서 막히면 네트워크나 저장소 경로 문제입니다.
2. 고르기 — 인자 없는 add로 필요한 것만 선택. 전부 넣지 말고 표에서 "추가로 필요한 것"이 빈 스킬(youtube-transcribe)부터 시작하면 API 키 없이 바로 테스트됩니다.
3. 호출 확인 — Claude Code에서 /스킬이름으로 불러 반응하는지 확인.
4. 키 필요 스킬은 미루기 — nanobanana(GEMINI_API_KEY), gpt-image(OPENAI_API_KEY)는 키 설정 전엔 동작하지 않습니다. 키를 어디에 넣는지는 원문 각 스킬 항목을 그대로 따르세요.

정리: 다음에 무엇부터 확인할까

전체 설정을 갈아끼우기 전에, npx -y skills add -l feiskyer/claude-code-settings로 목록만 한 번 띄워 보세요. 이름이 뜬다면 내 ~/.claude를 건드리지 않고도 필요한 스킬 하나만 골라 시작할 수 있다는 신호입니다.

---

🐦 X에서 더 빠르게: @baegseungh7061
📚 이 시리즈 더 보기: Code 빌드
💌 새 글 알림: X 팔로우 또는 블로그 RSS 구독