Claude Code 플러그인 레퍼런스 (night-market 판)

무엇을 해주나

Claude Code 플러그인을 직접 만들거나 디버깅할 때 필요한 '기계적 계약'을 한곳에 모아 둔 참조 문서입니다.

• .claude-plugin/plugin.json, metadata.json, openpackage.yml 각 필드의 의미와 동기화 규칙
• SKILL.md 프론트매터 규약(description 160자 제한, role 분류, 허브-스포크 점진 로딩)
• 커맨드 vs 스킬 vs 에이전트를 언제 쓰는지 판단표, $ARGUMENTS·extends 사용법
• 훅의 핵심: hooks/hooks.json에만 등록, 페이로드는 stdin JSON(환경변수 아님), 항상 exit 0 + stdout JSON 판정, PreToolUse는 allow|deny|ask만 인정
• 호스트 Python 3.9 제약(datetime.UTC 금지, from __future__ import annotations 필수, 서드파티 import 가드), 플러그인 캐시 실행으로 인한 상대경로 금지
• 마켓플레이스 등록/설치, 버전 락스텝 범프 스크립트, 검증용 재확인 셸 명령 모음

이런 분께 추천

• Claude Code용 플러그인·스킬·훅을 직접 만들고 있는 개발자
• 훅이 조용히 아무 일도 하지 않는 문제를 추적하는 사람
• claude-night-market 저장소에 기여하거나 그 구조를 그대로 참고해 사내 플러그인 체계를 세우려는 팀

활용 예시

1. 훅이 안 먹힐 때: CLAUDE_TOOL_NAME 같은 환경변수를 읽고 있었다면 stdin JSON 파싱 패턴으로 교체하고, echo not-json | python3 hook.py; echo $?가 0을 내는지 확인.
2. 세션 시작 시 "Duplicate hooks file" 오류: plugin.json의 hooks 배열에서 ./hooks/hooks.json을 제거하고 hooks/hooks.json 자동 로딩에 맡김.
3. 새 스킬 추가 후 참조가 깨질 때: plugin.json의 skills 배열 등록, description 160자 이내, ## Exit Criteria 섹션 유무를 체크해 스킬 그래프 래칫을 통과시킴.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/athola/claude-night-market/HEAD/.claude/skills/claude-code-plugin-reference/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 athola/claude-night-market 의 .claude/skills/claude-code-plugin-reference 폴더를 내 ~/.claude/skills/claude-code-plugin-reference/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.