Claude Code 스킬 TOP 5, 겹치지 않게 설치하는 가이드

역할: Claude Code 확장 도구의 설치·충돌 점검을 맡는 환경 설정 담당
맥락: 다섯 저장소가 아직 설치되지 않았을 수 있고 기존 Claude Code 설정은 보존해야 하는 <프로젝트 상황 한 줄>
입력: <운영체제와 셸>, <프로젝트 폴더>, <주로 하고 싶은 작업>
작업: ① 설치 여부 확인 — `claude --version`, `claude plugin list --json`, `claude plugin marketplace list`를 실행하세요. ② 미설치 시 설치 — Claude Code가 없으면 공식 설치 문서를 확인해 설치하고, 처음에는 Karpathy Skills 또는 Superpowers 중 하나부터 붙이세요. 플러그인 ID는 추측하지 말고 그 도구의 공식 저장소 README에서 확인한 뒤, 필요한 마켓플레이스를 먼저 등록하고 설치하세요. Superpowers와 ECC는 역할이 겹치므로 둘 중 하나만 고르고, awesome-claude-code는 설치하지 말고 목록으로만 쓰며, wshobson/agents에서는 필요한 플러그인 하나만 고르세요. ③ 실제 명령 검증 — 설치 뒤 `claude plugin list --json`과 `claude plugin details <플러그인 ID>`를 실행해 활성 상태와 구성요소를 확인하세요. ④ 초보자 안내 — 검증이 끝나면 선택한 도구가 무엇을 바꾸고 첫 작업에서 어떻게 쓰는지 쉬운 말로 설명하세요.
제약: 비밀키 값과 자격 증명 파일을 읽거나 출력하지 마세요. 존재하지 않는 마켓플레이스 이름을 지어내지 말고, 기존 설정을 덮어쓰거나 여러 설치 방식을 겹치지 말며, 파일 변경·외부 발행·커밋·푸시는 사용자 승인 전까지 하지 마세요.
출력: 실행한 명령, 확인된 Claude Code 버전, 기존 플러그인, 새로 등록한 마켓플레이스와 설치한 플러그인 ID, 변경된 설정, 검증 결과, 남은 오류와 다음 조치
검증: `claude --version`은 버전 문자열을 보여야 하고, `claude plugin list --json`에는 선택한 플러그인의 정확한 ID와 `enabled: true`가 보여야 하며, `claude plugin details <플러그인 ID>`에는 실제 구성요소(Skills·Agents·Hooks)와 `Projected token cost`의 Always-on 토큰 값이 함께 보여야 합니다. 설치 실패 메시지에 `not found in marketplace`가 있으면 마켓플레이스 등록부터 다시 확인하세요. 하나라도 실패하면 완료로 보고하지 말고 원인과 다음 조치를 제시하세요.

Quick Start

• 공식 사이트: Claude Code 설치 문서
• 공식 GitHub: obra/superpowers
• 공식 GitHub: obra/superpowers-marketplace
• 공식 GitHub: affaan-m/ECC
• 공식 GitHub: multica-ai/andrej-karpathy-skills
• 공식 GitHub: hesreallyhim/awesome-claude-code
• 공식 GitHub: wshobson/agents

용어: GitHub 저장소는 프로그램과 설명서를 함께 보관한 공개 폴더입니다. Star는 사용자가 관심을 표시한 수치이지 품질 보증 점수가 아닙니다.

용어: 플러그인은 Claude Code에 새 규칙이나 작업 기능을 붙이는 확장입니다. 마켓플레이스는 플러그인 목록을 등록해 필요한 항목만 고르는 장터입니다.

아래 명령은 macOS·Linux·WSL에 Claude Code 공식 최신판을 설치합니다.

curl -fsSL https://claude.ai/install.sh | bash

성공하면 설치 완료 안내와 다시 열 터미널 경로가 보입니다. 터미널을 닫았다가 다시 여세요.

아래 명령은 Claude Code 버전을 확인하고, Superpowers 마켓플레이스를 등록한 뒤 Superpowers 하나만 사용자 범위에 설치합니다.

claude --version
claude plugin marketplace add obra/superpowers-marketplace --scope user
claude plugin install superpowers@superpowers-marketplace --scope user
claude plugin list --json

성공하면 ✔ Successfully installed plugin: superpowers@superpowers-marketplace (scope: user)가 나오고, 목록에 같은 ID가 enabled: true로 보입니다.

아래 명령은 빈 연습 폴더에서 Claude Code를 처음 엽니다.

mkdir -p "$HOME/claude-skill-test"
cd "$HOME/claude-skill-test"
claude

성공하면 로그인 뒤 Claude Code 입력창이 열립니다.

입력창에 아래 프롬프트를 붙여넣으면 파일을 만들기 전에 Superpowers의 설계 흐름부터 확인할 수 있습니다.

작은 할 일 관리 앱을 만들고 싶습니다.
아직 파일은 수정하지 마세요.
제가 원하는 결과를 질문으로 확인하고, 선택지와 검증 기준이 있는 설계만 보여주세요.

성공하면 Claude가 바로 코드를 쓰지 않고 목적과 제약을 먼저 묻습니다.

STEP 1. Star 순위와 역할부터 구분하기: 3분

이 단계에서는 Star 순위와 실제 역할을 먼저 확인해, 숫자만 보고 다섯 개를 전부 설치하는 일을 막습니다.

2026년 7월 27일 GitHub REST API로 원본 카드뉴스의 저장소 10개를 다시 조회했습니다. 아래 다섯 개가 그 목록 안에서 Star 상위 5개였습니다.

Star는 계속 바뀝니다. 이 표는 전체 GitHub의 모든 Claude 저장소 순위가 아니라, 원본에 나온 10개 안에서 비교한 결과입니다.

다섯 개는 같은 종류가 아닙니다. awesome-claude-code는 설치 파일이 아니라 목록이고, wshobson/agents는 전체를 설치하는 패키지가 아니라 개별 플러그인을 고르는 장터입니다.

STEP 2. 겹치지 않는 조합 고르기: 3분

이 단계에서는 비슷한 규칙이 동시에 작동하지 않도록 내 목적에 맞는 기본 조합 하나를 고릅니다.

용어: always-on 토큰은 대화를 시작할 때마다 자동으로 먼저 들어가는 설명문 분량입니다. 내가 아무 말도 하기 전에 이미 채워져 있는 자리라고 보면 됩니다.

이 값은 claude plugin details <플러그인 ID>를 실행하면 나오는 Projected token cost의 Always-on 항목에서 직접 볼 수 있습니다. 아래는 2026년 7월 27일에 네 플러그인을 실제로 설치해 확인한 값입니다.

Superpowers와 ECC를 둘 다 켜면 매 대화마다 24,632토큰이 고정으로 들어갑니다. 겹치는 규칙이 늘어나는 것도 문제지만, 내 질문이 시작되기 전에 이미 이만큼을 쓰고 들어간다는 점이 더 큽니다.

처음이라면 Superpowers 하나부터 추천합니다. 마켓플레이스 등록 한 줄과 설치 한 줄이면 끝나고, 설계부터 검증까지 흐름이 분명한데 always-on 비용은 584토큰으로 가볍습니다.

ECC는 더 넓은 스킬·메모리·보안 구성이 필요할 때 Superpowers 대신 고르세요. 두 도구 모두 계획, 테스트, 검증 흐름을 건드리므로 초보자는 처음부터 함께 켜지 않는 편이 안전합니다.

Karpathy Skills는 네 가지 짧은 행동 규칙만 필요한 사람에게 맞습니다. awesome-claude-code는 북마크로 쓰고, wshobson/agents에서는 당장 필요한 플러그인 하나만 설치하세요.

아래 프롬프트는 내 목적에 맞는 조합 하나만 고르게 합니다.

내가 Claude Code로 하려는 일은 <하고 싶은 작업 한 줄>입니다.
Superpowers, ECC, Karpathy Skills 중 기본 도구 하나만 추천해 주세요.
추천 이유, 설치했을 때 달라지는 점, 겹쳐 설치하면 생길 수 있는 혼란을 쉬운 말로 알려 주세요.
아직 설치하거나 파일을 바꾸지는 마세요.

성공하면 추천 하나와 제외한 두 도구의 이유가 짧게 나옵니다.

Windows PowerShell에서 Claude Code가 없다면 아래 공식 명령을 먼저 실행합니다.

irm https://claude.ai/install.ps1 | iex
claude --version

성공하면 설치가 끝난 뒤 Claude Code 버전이 보입니다.

STEP 3. Superpowers 설치하기: 5분

이 단계에서는 Superpowers 마켓플레이스를 등록해 플러그인을 설치하고, 설계부터 검증까지의 작업 순서를 켭니다.

용어: TDD는 코드를 만들기 전에 실패하는 테스트를 먼저 쓰고, 그 테스트가 통과할 때까지 최소한으로 고치는 방식입니다.

Superpowers는 아이디어 확인, 설계 승인, 구현 계획, TDD, 코드 리뷰, 완료 검증을 순서대로 쓰게 합니다. 관련 스킬은 작업 상황에 맞춰 자동으로 선택됩니다.

Superpowers는 Anthropic 기본 목록이 아니라 제작자가 운영하는 obra/superpowers-marketplace에서 배포됩니다. 그래서 마켓플레이스 등록을 건너뛰고 설치하면 실패합니다.

아래 명령은 마켓플레이스를 등록하고 Superpowers를 설치한 뒤 구성요소를 확인합니다.

claude plugin marketplace add obra/superpowers-marketplace --scope user
claude plugin install superpowers@superpowers-marketplace --scope user
claude plugin list --json
claude plugin details superpowers@superpowers-marketplace

성공하면 ✔ Successfully installed plugin: superpowers@superpowers-marketplace (scope: user)가 나옵니다. 상세 화면에는 superpowers 6.2.0과 Skills (14)가 보이고, Skills (14)가 보이면 설치가 끝난 겁니다.

같은 화면 아래쪽 Projected token cost — Always-on: ~584 tok도 함께 확인하세요. 지금 켠 도구가 매 대화에 얹는 고정 비용입니다.

Claude Code를 열고 아래 프롬프트로 첫 작동을 확인하세요.

현재 폴더에서 만들 수 있는 가장 작은 예제 프로젝트를 제안해 주세요.
아직 파일은 수정하지 마세요.
먼저 요구사항을 질문하고, 승인받을 설계와 테스트 기준을 보여주세요.

성공하면 구현보다 질문과 설계가 먼저 나옵니다. 바로 파일을 만들기 시작하면 새 세션을 열고 플러그인 목록을 다시 확인하세요.

STEP 4. ECC를 대안으로 설치하기: 5분

이 단계에서는 스킬·메모리·보안 구성을 넓게 쓰고 싶은 경우 Superpowers 대신 ECC를 설치합니다.

용어: 훅은 Claude Code가 시작되거나 도구를 쓰기 전후에 자동으로 실행되는 점검 코드입니다.

ECC는 기능 범위가 넓습니다. 그래서 플러그인 설치와 수동 full 설치를 겹치지 않는 게 중요합니다.

Superpowers를 이미 시험 중이라면 먼저 그대로 둘지 ECC로 바꿀지 정하세요. 아래 명령은 ECC 플러그인 경로 하나만 설치합니다.

claude plugin marketplace add https://github.com/affaan-m/ECC --scope user
claude plugin install ecc@ecc --scope user
claude plugin list --json
claude plugin details ecc@ecc

성공하면 ecc@ecc가 활성 상태로 보이고, 상세 화면에 ecc 2.0.0과 Skills (375), Agents (67), Hooks (7)이 표시됩니다.

구성요소 숫자에서 짐작되듯 always-on 토큰도 24,048로 큽니다. Superpowers와 함께 켜지 말라는 이유가 여기에 있습니다.

Claude Code 입력창에서 아래 명령으로 파일을 바꾸지 않는 첫 계획을 요청하세요.

/ecc:plan "현재 폴더를 읽고 파일은 수정하지 말고, 할 수 있는 첫 작업 하나와 검증 방법만 알려줘"

성공하면 변경 전에 계획과 확인 방법이 나옵니다.

ECC 플러그인을 썼다면 install.sh --profile full이나 npx ecc-install --profile full을 추가로 실행하지 마세요. 같은 기능이 두 위치에 생기면 명령과 훅이 중복될 수 있습니다.

STEP 5. Karpathy Skills 설치하기: 4분

이 단계에서는 Claude가 추측으로 밀어붙이거나 요청하지 않은 코드를 건드리는 습관을 줄이기 위해 네 가지 행동 규칙을 붙입니다.

현재 저장소 이름은 multica-ai/andrej-karpathy-skills입니다. 예전 forrestchang/andrej-karpathy-skills 주소는 현재 저장소로 이동되지만, 새 설치에는 현재 이름을 쓰는 편이 분명합니다.

네 원칙은 코딩 전 생각하기, 단순하게 만들기, 필요한 줄만 바꾸기, 검증 가능한 목표로 끝내기입니다. 큰 프레임워크보다 짧은 규칙이 필요한 사람에게 맞습니다.

아래 명령은 현재 저장소를 마켓플레이스로 등록하고 Karpathy Skills를 설치합니다.

claude plugin marketplace add multica-ai/andrej-karpathy-skills --scope user
claude plugin install andrej-karpathy-skills@karpathy-skills --scope user
claude plugin list --json
claude plugin details andrej-karpathy-skills@karpathy-skills

성공하면 andrej-karpathy-skills@karpathy-skills가 활성 상태로 보이고, 상세 화면에 andrej-karpathy-skills 1.0.0과 Skills (1)이 표시됩니다.

스킬 개수가 1이라고 놀라지 마세요. 네 원칙이 스킬 하나에 함께 들어 있어서 always-on 토큰도 66으로 가장 가볍습니다.

Claude Code에서 아래 프롬프트로 규칙이 작동하는지 확인하세요.

이 폴더의 파일 이름만 보고 앱 구조를 전부 바꿔 주세요.
다만 확실하지 않은 가정은 먼저 밝히고, 요청 범위 밖 파일은 건드리지 마세요.
아직 수정하지 말고 가장 작은 변경안과 성공 기준만 보여주세요.

성공하면 Claude가 모르는 부분을 먼저 밝히고, 전체 재작성 대신 작은 변경안을 제시합니다.

STEP 6. awesome-claude-code는 설치하지 않고 찾기: 3분

이 단계에서는 awesome-claude-code를 프로그램처럼 설치하지 않고, 필요한 자료를 찾는 공개 목록으로 사용합니다.

용어: 큐레이션 목록은 여러 자료를 기준에 따라 골라 한곳에 정리한 목록입니다.

저장소의 Start Here, From Anthropic, Security, Skills, Memory & Context Persistence 섹션부터 보세요. 관심 있는 항목을 찾으면 그 항목의 공식 저장소와 설치 문서를 다시 확인해야 합니다.

아래 프롬프트는 목록에서 내 목적에 맞는 후보만 좁힙니다.

이 목록을 기준으로 <하고 싶은 작업>에 맞는 Claude Code 자료를 최대 3개만 골라 주세요.
목록: https://github.com/hesreallyhim/awesome-claude-code
각 후보의 공식 저장소, 최근 업데이트 여부, 설치 방식, 필요한 권한을 확인해 주세요.
Star만 보고 고르지 말고, 아직 설치하지 마세요.

성공하면 후보 세 개 이하와 확인해야 할 권한이 함께 나옵니다.

STEP 7. wshobson/agents에서 전문가 하나만 붙이기: 5분

이 단계에서는 보안·테스트·백엔드 같은 전문가 기능 중 지금 필요한 플러그인 하나만 골라 설치합니다.

용어: 에이전트는 보안 점검이나 테스트처럼 역할을 좁혀 맡기는 AI 작업자입니다.

현재 공개 목록에는 94개 플러그인이 있습니다. 마켓플레이스를 등록해도 플러그인이 전부 설치되는 건 아닙니다.

아래 명령은 마켓플레이스를 등록하고 unit-testing 하나만 설치한 뒤 실제 구성요소를 확인합니다.

claude plugin marketplace add wshobson/agents --scope user
claude plugin install unit-testing@claude-code-workflows --scope user
claude plugin list --json
claude plugin details unit-testing@claude-code-workflows

성공하면 unit-testing@claude-code-workflows가 활성 상태로 보이고, 상세 화면에 unit-testing 1.2.1과 Agents (2)가 표시됩니다. always-on 토큰은 111입니다.

다른 기능이 필요하면 아래 명령의 첫 줄만 원하는 ID로 바꾸세요.

PLUGIN_ID="security-scanning"
claude plugin install "${PLUGIN_ID}@claude-code-workflows" --scope user
claude plugin details "${PLUGIN_ID}@claude-code-workflows"

성공하면 선택한 ID의 구성요소가 표시됩니다. 목적을 설명할 수 없는 플러그인은 더 설치하지 마세요.

STEP 8. 설치 결과를 검증하고 되돌리기: 4분

이 단계에서는 설치를 끝냈다는 말보다 실제 활성 ID와 구성요소를 확인하고, 맞지 않으면 안전하게 제거합니다.

아래 명령은 현재 설치된 플러그인과 마켓플레이스를 JSON 목록으로 보여줍니다.

claude plugin list --json
claude plugin marketplace list

성공하면 설치한 플러그인의 정확한 ID, 활성 상태, 설치 범위가 보입니다.

아래 표에서 내가 선택한 경로 하나만 확인하세요.

설치 직후 열린 세션이라면 아래 명령을 Claude Code 입력창에서 실행합니다.

/reload-plugins

성공하면 다시 불러온 플러그인·스킬·에이전트 수가 표시됩니다.

Superpowers가 내 작업에 맞지 않을 때 아래 명령은 해당 플러그인만 제거합니다.

claude plugin uninstall superpowers@superpowers-marketplace --scope user
claude plugin list --json

성공하면 제거 완료 안내가 나오고 설치 목록에서 해당 ID가 사라집니다. ECC나 다른 플러그인을 지울 때는 정확한 ID만 바꾸세요.

FAQ

공식 마켓플레이스에서 superpowers를 설치하라고 해서 했는데 not found가 떠요

증상: claude plugin install superpowers@claude-plugins-official --scope user를 실행하면 Failed to install plugin "superpowers@claude-plugins-official": Plugin "superpowers" not found in marketplace "claude-plugins-official".이 나옵니다.

원인: claude-plugins-official 마켓플레이스는 실제로 있지만 그 안에 Superpowers가 없습니다. Superpowers는 제작자가 따로 운영하는 마켓플레이스에서 배포됩니다.

해결: 아래 명령으로 Superpowers 마켓플레이스를 먼저 등록한 뒤 설치하세요.

claude plugin marketplace add obra/superpowers-marketplace --scope user
claude plugin install superpowers@superpowers-marketplace --scope user

성공하면 ✔ Successfully installed plugin: superpowers@superpowers-marketplace (scope: user)가 보입니다.

다섯 개를 전부 설치하면 더 좋아지나요?

아닙니다. awesome-claude-code는 설치 대상이 아니고, wshobson/agents는 필요한 플러그인만 고르는 목록입니다.

Superpowers와 ECC는 작업 흐름이 겹칩니다. 둘 다 켜면 always-on 토큰만 24,632가 고정으로 들어가니 처음에는 하나만 켜고 결과를 확인하세요.

ChatGPT에도 같은 명령을 붙여넣을 수 있나요?

아닙니다. 이 문서의 플러그인 명령은 로컬 Claude Code용입니다.

ChatGPT에서는 저장소의 공개 설명과 프롬프트를 참고할 수 있지만, Claude Code 플러그인이 자동으로 로드되지는 않습니다.

설치했는데 현재 대화에서 안 보입니다

Claude Code 입력창에서 /reload-plugins를 실행하세요. 그래도 안 보이면 완전히 종료한 뒤 새 세션을 엽니다.

claude plugin list --json에 ID가 없으면 설치 자체가 끝나지 않은 겁니다.

Plugin not found가 나옵니다

플러그인 이름은 맞아도 그 플러그인이 있는 마켓플레이스를 등록하지 않았을 수 있습니다. 먼저 저장소의 현재 공식 README에서 마켓플레이스 주소와 정확한 플러그인 ID를 다시 확인하세요.

아래 명령은 등록된 마켓플레이스를 확인하고 목록을 새로 불러옵니다.

claude plugin marketplace list
claude plugin marketplace update superpowers-marketplace

성공하면 등록된 마켓플레이스 목록과 갱신 안내가 보입니다. 그다음 설치 명령을 다시 실행하세요.

Star가 높으면 안전한가요?

아닙니다. Star는 관심도 신호일 뿐 코드 안전성이나 내 환경과의 호환성을 보장하지 않습니다.

설치 전에 저장소 소유자, 최근 커밋, 플러그인 구성요소, 훅과 외부 연결을 확인하세요. 비밀키·파일·셸 권한을 요구하는 플러그인은 더 꼼꼼히 봐야 합니다.

설치 뒤 Claude의 답이 오히려 복잡해졌습니다

규칙이 겹쳤을 가능성이 큽니다. claude plugin list --json으로 활성 플러그인을 보고 Superpowers와 ECC 중 하나를 제거한 뒤 새 세션에서 다시 시험하세요.

claude plugin details <플러그인 ID>로 always-on 토큰을 확인하면 어느 쪽이 대화를 무겁게 만드는지 숫자로 비교할 수 있습니다.

업데이트는 어떻게 하나요?

아래 명령은 Superpowers를 최신 버전으로 갱신하고 상세 정보를 다시 확인합니다.

claude plugin update superpowers@superpowers-marketplace
claude plugin details superpowers@superpowers-marketplace

성공하면 업데이트 결과와 현재 구성요소가 보입니다. 다른 플러그인은 정확한 ID로 바꾸세요.

공식 자료

• Claude Code 공식 설치 문서
• Claude Code 공식 플러그인 문서
• Anthropic 공식 플러그인 목록
• Superpowers 공식 저장소
• Superpowers 공식 마켓플레이스 저장소
• ECC 공식 저장소
• ECC 공식 사이트
• Karpathy Skills 공식 저장소
• awesome-claude-code 공식 저장소
• wshobson/agents 공식 저장소
• GitHub REST 저장소 조회 문서

이 자료가 도움됐다면

이런 AI 활용 자료를 인스타그램에 계속 올리고 있습니다.

• : 다음 자료를 가장 먼저 받아볼 수 있습니다
• 따라 하다 막힌 부분은 릴스 댓글로 남겨주세요. 다음 자료를 만들 때 참고합니다