#+title:      Claude Skills 등록·관리 간단 가이드
#+date:       [2025-11-18 Tue 12:00]
#+filetags:   :skills:claude:orgmode:
#+identifier: 20251118T120000

* Claude Skills 등록·관리 가이드 :WORKLOG:

이 문서는 Anthropic 공식 skills 세트와 개인 orgmode-skills 세트를
Claude Code에서 어떻게 등록·설치하는지 최소 절차만 정리한 메모입니다.

** 1. Anthropic 공식 skills (anthropic-agent-skills)

공식 예제/문서 스킬 리포:
- 로컬 경로: =/home/goqual/repos/3rd/skills=
- 핵심 파일: =.claude-plugin/marketplace.json=
  - name: =anthropic-agent-skills=
  - plugins:
    - =document-skills=
    - =example-skills=

Claude Code에서 마켓플레이스 등록:

#+begin_example
/plugin marketplace add anthropics/skills
#+end_example

그 다음 실제 스킬 번들 설치:

#+begin_example
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills
#+end_example

- =document-skills@anthropic-agent-skills= → PDF/XLSX/DOCX/PPTX 문서 스킬 세트
- =example-skills@anthropic-agent-skills= → algorithmic-art, mcp-builder 등 예제 스킬 세트

** 2. 개인 orgmode-skills 마켓플레이스 (junghan-skills)

개인 Denote/Org + 문서 스킬 묶음:
- 리포: =/home/goqual/repos/gh/orgmode-skills=
- 스킬: 루트에 =SKILL.md= (name: =denote-org=)
- 마켓플레이스 메타데이터:
  - =.claude-plugin/marketplace.json=
  - name: =junghan-skills=
  - plugins:
    - =denote-org-pack=
      - skills:
        - =./= (denote-org)
        - =../skills/document-skills/pdf=
        - =../skills/document-skills/xlsx=

Claude Code에서 마켓플레이스 등록:

#+begin_example
/plugin marketplace add /home/goqual/repos/gh/orgmode-skills
#+end_example

개인 스킬 번들 설치:

#+begin_example
/plugin install denote-org-pack@junghan-skills
#+end_example

이 한 번으로 다음이 함께 활성화됨:
- =denote-org= : Denote/org-mode PKM 스킬
- =pdf=        : Anthropic PDF 스킬
- =xlsx=       : Anthropic XLSX 스킬

** 3. 세션 시작 시 최소 커맨드 요약

새 Claude Code 세션에서 org + 문서 스킬 세트를 쓰고 싶을 때:

1) 한 번만 해두면 되는 것 (이미 완료됨):
   - =/plugin marketplace add anthropics/skills=
   - =/plugin marketplace add /home/goqual/repos/gh/orgmode-skills=

2) 각 세션에서 실행할 것:

#+begin_example
/plugin install document-skills@anthropic-agent-skills   ;; 공식 문서 스킬 세트
/plugin install denote-org-pack@junghan-skills          ;; 개인 orgmode + PDF/XLSX 세트
#+end_example

이후 Denote/Org 관련 작업에서는 먼저 =denote-org= 스킬을 가정하고,
PDF/XLSX 편집·분석이 필요할 때는 =document-skills= 를 함께 활용하는 것을 기본 전략으로 합니다.