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

쓰던 .claude/ 설정을 플러그인으로 옮기기

이미 만들어 둔 스킬·훅을 팀에 나눠주고 싶을 때

내용

📌 옮기는 순서

① 플러그인 폴더와 매니페스트 만들기
   mkdir -p my-plugin/.claude-plugin
   → my-plugin/.claude-plugin/plugin.json 작성

② 쓰던 것 복사 (없는 폴더는 건너뛰기)
   cp -r .claude/skills   my-plugin/
   cp -r .claude/agents   my-plugin/
   cp -r .claude/commands my-plugin/

③ 훅 옮기기
   settings.json 의 hooks 객체를 그대로
   my-plugin/hooks/hooks.json 으로. 형식이 같습니다.

④ 테스트
   claude --plugin-dir ./my-plugin

[ 무엇이 달라지나 ]
• 훅 위치 — settings.json → hooks/hooks.json
• 배포 — 손으로 복사 → /plugin install
• 이름 — /deploy → /my-plugin:deploy

⚠️ 옮긴 뒤 원본을 지우세요
프로젝트·개인 .claude/agents/ 는 같은 이름의 플러그인 에이전트를 덮어씁니다.
원본이 남아 있으면 플러그인 쪽이 동작하지 않습니다.
(스킬은 이름이 달라져서 둘 다 남습니다)

옮기려는 설정: {{INPUT}}

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

근거

유형
설정 가이드 — 지정된 파일이나 설정에 적용합니다
사용 환경
Claude Code (터미널) 전용
주의
원본을 안 지우면 에이전트는 플러그인 쪽이 무시됩니다. 스킬은 이름이 달라 둘 다 남습니다.
공식 출처
https://code.claude.com/docs/en/plugins
확인일
2026-09-09 — 이후 바뀌었을 수 있습니다
도서관에서 열기 — 내 내용 넣고 복사하기