AI 도서관 · Claude · 에이전트 스킬 · 플러그인

내 첫 플러그인 만들기 (가장 빠른 길)

claude plugin init 하나면 뼈대가 만들어지고 다음 세션부터 바로 잡혀요

내용

📌 가장 빠른 방법

claude plugin init my-tool

~/.claude/skills/my-tool/ 에 plugin.json 과 SKILL.md 뼈대가 생깁니다.
다음 세션부터 my-tool@skills-dir 로 저절로 잡혀요. 마켓도 설치도 필요 없습니다.

[ 직접 만들 때 ]
my-plugin/
├── .claude-plugin/
│   └── plugin.json     ← 이것만 이 안에 들어갑니다
└── skills/
    └── hello/
        └── SKILL.md

plugin.json 최소 형태
{
  "name": "my-plugin",
  "description": "무엇을 하는 플러그인인지",
  "version": "1.0.0"
}

[ 만들면서 테스트 ]
claude --plugin-dir ./my-plugin
고친 뒤에는 /reload-plugins

⚠️ 가장 흔한 실수
skills/ commands/ agents/ hooks/ 를 .claude-plugin/ 안에 넣으면 안 됩니다.
.claude-plugin/ 에는 plugin.json 하나만. 나머지는 전부 플러그인 폴더 바로 아래입니다.

만들고 싶은 플러그인: {{INPUT}}

{{INPUT}} 자리에 내 내용을 넣어 쓰는 프롬프트입니다. 아래 버튼으로 열면 넣는 칸이 나옵니다.

근거

유형
설정 가이드 — 지정된 파일이나 설정에 적용합니다
사용 환경
Claude Code (터미널) 전용
주의
name 이 곧 이름 앞에 붙는 접두사가 됩니다. 스킬은 /플러그인이름:스킬이름 으로 불립니다.
공식 출처
https://code.claude.com/docs/en/plugins
확인일
2026-09-09 — 이후 바뀌었을 수 있습니다
도서관에서 열기 — 내 내용 넣고 복사하기