노션(Notion) 3.7부터 노션 AI에 만든 스킬을 「Download to local agents」로 내 컴퓨터의 AI 도구에 내려받을 수 있어요. 클로드 코드(Claude Code)로 받으면 SKILL.md 파일 하나로 저장되고, 클로드 코드에서 /스킬이름 을 치면 노션에서 쓰던 지시 그대로 일해요.
스킬은 "이 일은 이렇게 해 줘"를 적어 둔 업무 지시서예요. 같은 지시서를 노션과 클로드 코드에 따로 쓰지 않아도 되는 게 핵심이에요.
이런 분께
- 노션 AI에 "미팅 메모를 제안서로" 같은 스킬을 만들어 쓰고 있는 분
- 클로드 코드로 내 컴퓨터 파일을 정리하거나 문서를 만들 때 같은 규칙을 쓰고 싶은 분
끝나면 이렇게 됩니다
> /skills
meeting-to-proposal 미팅 메모를 팀 제안서 양식으로 바꿔요
> /meeting-to-proposal 오늘미팅메모.md
제안서 초안을 proposal-draft.md 로 만들었어요.
준비물
- 노션 계정과 노션 AI 스킬 한 개 이상(노션 도움말에 요금제 조건은 따로 나와 있지 않아요)
- 클로드 코드가 설치된 컴퓨터. 클로드 코드는 터미널(컴퓨터에 글자로 명령하는 창)에서 쓰는 클로드예요.
- 기준: 2026년 10월, 노션 3.7(2026-09-15 출시)
따라 하기
- 노션 왼쪽 사이드바 「Library」에서 「Skills」 탭을 열어요. 「Settings」 → 「Notion AI」 → 「Skills」로 가도 같아요.
- 내려받을 스킬 페이지를 열고, 위쪽 「•••」을 눌러 「Download to local agents」를 골라요.
- 보낼 곳으로 Claude Code를 골라요. 스킬은 SKILL.md 파일과, 공유를 허락한 첨부 파일로 저장돼요.
- 터미널을 열어요(윈도우: 시작 메뉴에서 '터미널' 검색, 맥: Spotlight에서 '터미널'). 그리고 claude 를 입력해 클로드 코드를 켜요.
- /skills 를 입력해 목록에 방금 받은 스킬이 있는지 봐요.
- /스킬이름 뒤에 파일 이름이나 할 일을 붙여 보내요.
복사해서 쓰는 프롬프트
스킬을 처음 쓸 때 클로드 코드에 보내면 좋은 문장이에요.
/[스킬 이름] 을 [파일 이름 또는 폴더]에 써줘. 결과는 새 파일로 만들고, 원본은 고치지 마. 스킬 지시 중 이 파일에 맞지 않는 부분이 있으면 먼저 물어봐줘.
[스킬 이름]에는 /skills 목록에 보이는 이름, [파일 이름 또는 폴더]에는 "오늘미팅메모.md"처럼 넣어요.
AI에게 통째로 맡기기
위 가이드대로 노션 스킬을 클로드 코드에 넣고 싶어. 스킬 이름은 [스킬 이름]이야. 한 단계씩 알려줘.
자주 막히는 곳
막히면 아래부터 봐요.
- 클로드 코드 /skills 목록에 노션 스킬이 안 보일 때: 개인 스킬 폴더는 ~/.claude/skills/스킬이름/SKILL.md 예요. 그 자리에 파일이 있는지 보고, 클로드 코드를 켠 채로 처음 폴더를 만들었다면 /reload-skills 를 입력해요.
- 노션에서 스킬을 고쳤는데 클로드 코드에 반영이 안 될 때: 내려받은 파일은 자동으로 바뀌지 않아요. 노션 스킬에 바뀜 표시가 붙으면 2단계를 다시 해서 새로 받아요.
- 노션 「Download to local agents」 메뉴가 없을 때: 노션 앱이 최신인지 보고, 그래도 없으면 워크스페이스 관리자 설정을 확인해요.
확인
/skills 목록에 스킬 이름과 설명이 보이고, /스킬이름 으로 보냈을 때 노션에서 쓰던 양식대로 결과가 나오면 잘 된 결과예요. 노션에서 스킬을 처음 만드는 순서는 미팅 메모를 팀 제안서로, 노션 AI 스킬 만들기에 있어요.
