AI한테 일을 시킬 때마다 같은 설명을 또 치고 계시죠. 노션 스킬 라이브러리는 그 설명을 노션 페이지에 한 번만 적어두고 여러 AI가 돌려 쓰게 해주는 기능입니다. 9월 15일 노션 3.7에 들어갔어요.
노션 안에서만 도는 기능이 아니라는 게 핵심입니다. 노션에 적어둔 걸 클로드 코드나 코덱스 같은 다른 에이전트로 꺼내 갈 수 있거든요. 공식 문서 기준으로 정리하고, 제가 직접 눌러보다 막힌 지점도 그대로 적을게요.
노션 AI Skills 데이터베이스 화면. 왼쪽 표에 PRD Proofread 등 스킬 목록과 Description 열, 오른쪽 페이지 위에 AI 스킬로 쓰이고 있다는 안내 줄
이미지 출 처: 노션 공식 블로그 "A skills library for every agent" 캡처
노션 스킬이 뭔가요
말은 거창한데 알맹이는 간단해요. AI한테 주는 설명서 한 장입니다.
회의록 정리를 시킨다고 해볼게요. 매번 "결정된 것만 뽑고, 누가 언제까지 할지 붙이고, 세 줄 안에 끝내"라고 치시죠. 이걸 한 번 적어서 저장해두고 다음부터 안 치는 것, 그게 스킬입니다.
위 화면에 보이는 게 그렇게 모아둔 목록이에요. 회의 결정 정리하기, 사내 공지 쓰기, 정책 요약하기, 캠페인 기획하기 같은 게 줄줄이 있습니다. 노션이 적어둔 정의는 "AI에게 특정 종류의 일을 어떻게 하는지 가르치는, 재사용 가능한 지침"이고요.
새로 생긴 개념은 아닙니다. 클로드 코드나 코덱스 쓰시는 분들은 이미 파일로 만들어 쓰고 계세요. 달라진 건 그걸 적는 자리입니다.
노션 스킬 만들기: 파일 대신 노션 페이지로 적습니다
지금까지는 이 설명서를 메모장 같은 데서 파일로 만들어야 했어요. 이제 노션 페이지에 그냥 쓰면 됩니다. 평소 문서 쓰듯이요.
자리가 바뀌니 따라오는 게 있습니다.
- 권한: 누가 보고 누가 고칠지를 노션 권한 그대로 씁니다
- 수정 제안: 동료가 바로 덮어쓰지 않고 제안만 걸어둘 수 있어요
- 버전 기록: 누가 언제 뭘 바꿨는지 남습니다
- 사용 분석: 관리자가 어떤 스킬이 실제로 쓰이는지 봅니다
만 드는 길은 두 갈래예요. Library에서 Skills 탭을 열고 + Add a skill을 누르거나, 이미 있는 페이지에서 •••를 눌러 Use as a skill을 고르면 됩니다. 노션 에이전트한테 대화로 "이런 스킬 만들어줘"라고 시켜도 되고요.
스킬로 걸린 페이지는 맨 위에 "이 페이지는 AI 스킬로 쓰이고 있습니다"라는 안내 줄이 떠요. 어떤 문서가 스킬로 물려 있는지 헷갈릴 일이 없습니다.
노션 에이전트가 알아서 꺼내 쓰게 하려면
스킬을 만들어두면 노션 에이전트가 알아서 골라 씁니다. 다만 조건 2개를 둘 다 맞춰야 해요.
- 스킬 데이터베이스 안에 있을 것. 그냥 페이지로 두면 안 됩니다. 스킬용 데이터베이스를 만들고 그 안에 넣으세요. 거기에 페이지를 만들면 자동으로 스킬이 됩니다
- 설명(
Description)을 채울 것. 노션 에이전트가 이 설명을 읽고 지금 이 스킬을 꺼낼 때인지 판단합니다
설명 칸이 비어 있으면 그 스킬은 영영 안 불려 나와요. 만들고 나서 설명부터 채우셔야 합니다.
Files 칸도 있어요. 예시 문서나 양식 파일을 여기 달아두면 스킬이 불려 나올 때 같이 들어갑니다. 기본값은 자동 호출 켜짐이고, 원하면 끌 수 있고요.
클로드 코드로 가져오기: SKILL.md로 내려 받습니다
노션에 적어둔 스킬을 밖으로 꺼내는 게 이번 발표의 진짜 알맹이예요. 노션 문서에는 클로드 코드, 코덱스, 커서, 제미나이, 그록 같은 로컬 에이전트로 내려받을 수 있다고 적혀 있습니다. 5종이죠.
꺼낼 때 쓰는 건 skills CLI예요. 도움말을 열어보니 받을 수 있는 대상에 notion이 아예 적혀 있더라고요.
skills add <package>
e.g. vercel-labs/agent-skills
notion
https://notion.so/<skill-page>
그래서 바로 돌려봤는데, 3초 만에 막혔어요!
◇ Failed to load Notion packs
■ Notion CLI (ntn) is required. Install it from:
https://developers.notion.com/cli/get-started/overview
Then run `ntn login`.
노션 CLI(ntn)를 먼저 깔고 로그인해야 한다는 뜻입니다. 순서를 건너뛰면 저처럼 똑같은 줄을 보시게 돼요. 차례는 이렇습니다. 노션 CLI 설치, ntn login으로 로그인, 그다음에 skills add notion.
로그인 뒤 화면은 노션이 공개해뒀어요. 워크스페이스를 통째로 당기는 게 아니라 스킬 페이지 주소를 그대로 붙여넣는 방식이더라고요.
터미널에서 npx skills add에 노션 페이지 주소를 넣은 결과. 노션 워크스페이스에서 스킬을 받았다는 줄과 Source: Notion page, 설치할 에이전트 76개
이미지 출처: 노션 공식 블로그 "A skills library for every agent" 캡처
받고 나면 어느 에이전트에 넣을지 고르는 단계가 나와요. 그 화면에 후보가 76개로 찍혀 있습니다. 클로드 코드와 코덱스만 있는 게 아니라는 얘기죠.
개발자라면: 노션 스킬 API
여기부터는 직접 붙여 쓰시는 분들 얘기예요. 아니면 다음 문단으로 넘어가셔도 됩니다.
노션이 스킬을 밖으로 빼주는 통로(API)를 같이 열었습니다. 주소 하나를 부르면 스킬이 압축 파일로 떨어져요. 안에는 설명서 본문과 딸린 파일이 그대로 들어 있습니다.
쓸모 있는 건 버전 번호가 따로 온다는 점이에요. 내용이 바뀌었는지 볼 때 본문을 통째로 받아 비교할 필요가 없습니다. 번호 1개만 대조하면 돼요!
노션이 이걸 써먹는 예제도 공개했습니다. makenotion/notion-skills-github-sync라는 저장소인데, 노션의 스킬을 깃허브로 주기적으로 밀어 넣어줘요. 기획자는 노션에서 글로 고치고, 개발자는 깃허브에서 파일로 받는 그림입니다.
노션 3.7에 같이 들어간 것들
스킬만 들어간 업데이트는 아니었어요. 눈에 띄는 걸 골라봤습니다.
- 커스텀 에이전트가 하위 에이전트한테 일을 넘깁니다. 큰 일을 쪼개서 맡기는 구조예요
- 회의 끝나면 자동으로 뒷정리를 하고, 문서 안에 에이전트를 끼워 넣을 수 있습니다
- Agent SDK가 퍼블릭 베타로 열렸어요. 비즈니스와 엔터프라이즈 플랜입니다
- 쓸 수 있는 모델이 늘었어요. 오푸스 5, GPT-5.6 Sol, Kimi K3까지 붙었습니다
- AI 검색이 50% 빨라졌다고 적혀 있어요
스킬을 쓰려면 어떤 요금제가 필요한지는 노션 문서에 안 적혀 있었습니다. 확인되면 고쳐두겠습니다.
그래서 지금 뭘 하면 되나
노션을 팀으로 쓰고 계시면 해볼 만해요. 규칙은 노션에 있는데 에이전트한테 줄 설명은 따로 관리하는 상황이면, 그 두 벌이 갈라지는 건 시간 문제거든요. 사람이 고치는 자리와 에이전트가 읽는 자리를 하나로 묶는 게 이 기능의 요점입니다.
혼자 쓰시는 분이라면 급하지 않습니다. 파일 하나 고치는 데 협업 기능까지 필요하진 않으니까요. 반대로 개발을 안 하는 동료가 규칙을 고쳐야 하는 팀이라면 얘기가 달라져요. 파일을 열어 고치라고 하는 것보다 노션 페이지를 고치라고 하는 쪽이 훨씬 쉽습니다.
지피터스에서도 스킬은 계속 다루는 주제예요. 매주 하나씩 붙잡고 만져보는 자리가 지피터스 AI 스터디입니다. 클로드 코드와 코덱스 주제가 입문부터 고급까지 열려 있어요!
자주 묻는 질문
노션 스킬은 노션 안에서만 쓰나요?
아니에요. 내려받아서 클로드 코드, 코덱스, 커서, 제미나이, 그록에서도 씁니다. Files 칸에 달아둔 파일도 같이 나가요.
노션 스킬을 클로드 코드로 가져오려면 뭐가 필요한가요?
노션 CLI(ntn)를 설치하고 ntn login으로 로그인한 다음, skills add notion을 실행하면 됩니다. 로그인을 건너뛰면 설치 실패 메시지가 떠요.
에이전트가 스킬을 알아서 꺼내 쓰게 하려면요?
스킬을 스킬 데이터베이스 안에 두고 Description 칸을 채우세요. 둘 중 하나라도 비면 자동으로 안 불려 나옵니다.
확인일: 2026년 9월 22일. 기능과 출시일은 노션 3.7 릴리스 노트와 노션 공식 블로그, 만드는 방법과 자동 호출 조건은 노션 헬프 센터, 압축 파일과 버전 번호는 노션 개발자 문서에서 확인했어요. 깃허브 동기화 예제는 makenotion/notion-skills-github-sync입니다. 터미널 화면은 같은 날 제 맥에서 skills CLI를 직접 돌려 받은 출력이에요. 클로드 코드 쪽 규칙 파일 정리는 AGENTS.md 지원 글에 적어뒀습니다.