홈 › Claude Code › 스킬과 플러그인
개요설치CLI 참조요금 및 한도Agent SDK스킬 및 플러그인GitHub웹, 데스크톱 및 IDE모델오류오픈 소스인가요?튜토리얼학생용 안내QA 자동화Cursor와 비교Codex 및 OpenCode와 비교하위 에이전트훅MCP생태계VS CodeOpenRouter요청 속도 제한중국어 가이드
최종 업데이트: 2026년 10월 11일

Claude Code 스킬과 플러그인

스킬은 지난 한 해 동안 Claude Code에 추가된 기능 중 가장 유용하면서도 가장 잘 알려지지 않은 기능입니다. 스킬은 관련이 있을 때만 모델이 불러오는 지침 폴더입니다. 덕분에 코딩 에이전트는 모든 프롬프트에 내용을 전부 담지 않고도 사용자의 배포 운영 절차서, PDF 도구, 디자인 시스템을 이해할 수 있습니다.

TLDR

  • 스킬은 SKILL.md(프런트 매터와 지침) 및 선택적인 스크립트나 참조 파일이 들어 있는 디렉터리입니다.
  • Claude Code는 다음 위치에서 스킬을 불러옵니다. ~/.claude/skills/ (개인용) 및 .claude/skills/ (프로젝트용), 그리고 설치된 플러그인에서 불러옵니다.
  • 플러그인은 스킬, 명령, 에이전트, MCP 서버를 하나로 묶습니다. /plugin marketplace add owner/repo 그다음 /plugin install.
  • Anthropic은 github.com/anthropics/skills에 공식 스킬 모음을 공개하고 있으며, 저희가 엄선한 목록은 github.com/iskandaryv/awesome-claude-skills.에서 확인할 수 있습니다.

스킬의 정확한 의미

스킬은 지침을 단계적으로 공개하는 방식입니다. 모델은 처음에는 스킬의 이름과 설명만 확인하며, 작업이 일치하면 전체 SKILL.md와 스킬이 가리키는 파일을 읽습니다. 이렇게 하면 컨텍스트를 작게 유지하면서도 필요할 때 에이전트에 작업별 심층 지식을 제공할 수 있습니다. 여기에는 절차, 스타일 규칙, 도메인별 체크리스트, 실행 가능한 보조 스크립트까지 포함됩니다.

---
name: release-notes
description: Write release notes from the git log in this repo's house style. Use when asked for a changelog or release notes.
---

1. Run `git log --oneline <last-tag>..HEAD`.
2. Group commits by area (api, ui, infra). Drop chores.
3. One line per change, user-facing wording, no commit hashes.
4. Output in the format of CHANGELOG.md; do not edit the file unless asked.

Claude Code가 스킬을 찾는 위치

  • ~/.claude/skills/<name>/SKILL.md — 개인용으로, 모든 프로젝트에 적용됩니다.
  • .claude/skills/<name>/SKILL.md — 저장소에 커밋하여 팀과 공유합니다.
  • 플러그인 내부 — 스킬, 슬래시 명령, 서브에이전트, MCP 설정을 묶어 배포하는 방식입니다.

플러그인 마켓플레이스

/plugin marketplace add anthropics/claude-code   # register a marketplace (any git repo with a manifest)
/plugin install <name>@<marketplace>          # install from it
/plugin                                        # browse, enable, disable, update

마켓플레이스는 플러그인 매니페스트가 있는 저장소일 뿐이므로, 팀에서도 같은 방식으로 비공개 마켓플레이스를 호스팅할 수 있습니다. Anthropic의 공식 스킬은 github.com/anthropics/skills에 있습니다. 문서 스킬(PDF, DOCX, XLSX, PPTX), 스킬 생성용 스킬, 직접 스킬을 작성하기 전에 읽어 볼 만한 예제가 포함되어 있습니다.

실제로 많이 설치하는 스킬

  • 문서 스킬 — 추측에 의존하지 않고 PDF, Word, Excel, PowerPoint 파일을 올바르게 읽고 생성합니다.
  • 프런트엔드 디자인 스킬 — 생성된 UI가 제품과 일치하도록 컴포넌트 라이브러리, 토큰, 레이아웃 규칙을 제공합니다.
  • 테스트 및 검토 스킬 — 팀의 완료 기준을 한 번 정의해 둡니다.
  • 배포 운영 절차서 — 정확한 명령과 점검 항목을 제공하고, 위험한 명령에는 보호 장치를 둡니다.
  • 각 스킬의 용도와 링크를 포함한 엄선 목록: github.com/iskandaryv/awesome-claude-skills.

좋은 스킬 작성하기

  • 설명에는 *언제* 사용해야 하는지 구체적으로 적으세요. 모델은 이를 기준으로 작업과의 일치 여부를 판단합니다.
  • SKILL.md는 짧게 유지하고, 분량이 많은 참조 자료는 스킬에서 링크하는 별도 파일에 넣으세요.
  • 결과가 정해진 단계에는 스크립트를 우선 사용하세요. 모델은 해당 절차를 다시 도출하는 대신 스크립트를 호출해야 합니다.
  • 다음으로 테스트하세요. /skills 세션에서 실행하고, 의도한 작업에서 스킬이 활성화되는지 확인하세요.

서브에이전트, 훅, MCP에는 별도의 가이드가 있습니다

스킬은 확장 지점 중 하나입니다. 서브에이전트(자체 컨텍스트를 가진 별도 작업자), 훅(도구 이벤트에 따라 실행되는 셸 명령), MCP 서버(외부 도구 및 데이터)에는 각각 이 허브의 전용 가이드가 있습니다. 스킬은 이들 모두에 적용되는 절차를 패키지로 묶는 확장 지점입니다.

게이트웨이에서 스킬 사용하기

스킬은 사용자 컴퓨터에 있는 파일이며 Claude Code 런타임이 읽으므로, 설정된 API 엔드포인트와는 완전히 독립적입니다. 스킬을 많이 사용하는 세션은 길어지기도 하며, 정액제 요금제는 바로 이런 사용 방식에 맞춰 설계되었습니다.

먼저 무료로 사용해 보세요

신규 계정에는 $5의 무료 API 크레딧이 제공됩니다 사용할 코드: CLAUDECODE — Sonnet으로 저녁 한나절 Claude Code를 사용하기에 충분합니다. 이후에는 액면가의 7.69231배에 해당하는 크레딧이 제공됩니다.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

코드 CLAUDECODE로 계정 만들기

자주 묻는 질문

스킬과 플러그인은 어떻게 다른가요?

스킬은 하나의 기능(SKILL.md가 들어 있는 폴더)입니다. 플러그인은 여러 스킬과 슬래시 명령, 서브에이전트, MCP 서버를 포함할 수 있는 배포용 묶음으로, 마켓플레이스에서 설치합니다.

Claude Code 스킬은 무료인가요?

네. Anthropic의 공식 스킬과 커뮤니티 모음은 공개 저장소로 제공됩니다. 스킬은 실제로 세션에 불러올 때만 토큰 비용이 발생합니다.

Claude Code 스킬 마켓플레이스는 어디에 있나요?

단일 스토어는 없습니다. 플러그인 매니페스트가 있는 모든 git 저장소가 마켓플레이스가 될 수 있으며, /plugin marketplace add로 등록할 수 있습니다. 보통 Anthropic의 자체 저장소부터 시작합니다.

Agent SDK에서 스킬을 사용할 수 있나요?

네. SDK는 동일한 런타임을 실행하므로 표준 디렉터리에 있는 스킬을 같은 방식으로 불러옵니다.

게이트웨이에서 Claude Code 실행하기

동일한 모델, 환경 변수 두 개, 액면가의 7.69231배에 해당하는 크레딧 또는 정액 무제한 요금제를 이용하세요. 신규 계정: 코드 CLAUDECODE로 $5의 무료 API 크레딧을 받으세요.

API 키 발급받기 무제한 요금제 보기

AI Prime Tech는 독립 API 게이트웨이이며 Anthropic과 제휴 관계가 없고, Anthropic의 보증이나 후원을 받지 않습니다. “Claude”와 “Claude Code”는 Anthropic의 상표입니다. 여기에 설명된 Claude Code 기능은 작성 당시 Anthropic의 공개 문서를 기준으로 하며 자주 변경됩니다. 이 페이지의 가격과 모델 목록은 이 게이트웨이의 실시간 설정에서 가져옵니다.

더 많은 Claude Code 가이드

Claude Code: 완벽 가이드Claude Code 설치 방법Claude Code CLI 문서: 명령어와 플래그Claude Code 요금 및 한도 설명Claude Code SDK, 이제 Claude Agent SDK로GitHub에서 Claude Code 사용하기: App, Action 및 @claudeClaude Code에 웹 인터페이스가 있나요? 웹, 데스크톱 및 IDE 설명Claude Code가 사용하는 모델과 변경 방법Claude Code 오류와 해결 방법Claude Code는 오픈 소스인가요?Claude Code 튜토리얼: 첫 실전 세션학생을 위한 Claude: Claude Code, API 및 교육 분야에서 실제로 제공되는 혜택QA 자동화에 Claude Code를 사용하는 방법Claude Code와 Cursor 비교: 어떤 도구를 언제 선택하고, 둘 다 어떻게 사용할까Claude Code vs Codex vs OpenCode: 터미널 에이전트 비교Claude Code 하위 에이전트: 작동 방식, 정의 방법, 에이전트 팀Claude Code 훅: 에이전트 동작에 대한 결정론적 제어Claude Code MCP: 서버 연결, 범위, 원격 MCP와 실제 예제Claude Code 생태계: 라우터, 프레임워크, 플러그인과 이를 모아 둔 목록VS Code에서 Claude Code 사용하기: 확장 프로그램, 터미널 사용 방식, 오류Claude Code에서 OpenRouter를 사용하는 방법과 사용하지 않는 편이 나은 경우Claude 요청 한도 오류: "API 오류: 요청 한도 도달"의 의미와 해결 방법Claude Code 사용법: 설치부터 일상적인 사용까지