Notion Agent Skills 사용법: 팀의 반복 업무를 재사용 가능한 지침으로 만드는 법

AI에게 매번 같은 형식의 회의 요약, 검토, 초안을 요청한다면 프롬프트를 복사해 붙이는 방식은 오래 버티기 어렵습니다. 누군가가 잘 만든 요청문은 개인의 노하우로 남고, 팀원마다 결과 형식도 달라지기 쉽습니다. 2026년 9월 15일 공개된 Notion 3.7의 Agent Skills는 이 문제를 “재사용 가능한 지침 페이지”로 풀려는 기능입니다. 한 번 정의한 업무 방식과 참고 자료를 스킬로 저장하고, 필요할 때 Notion Agent가 불러 쓰도록 합니다.

이 글은 Notion을 이미 문서·데이터베이스 허브로 쓰는 팀이 스킬을 어디에 쓰면 좋은지, 기존 Custom Agent와 어떻게 구분할지, 권한과 비용을 무엇부터 점검할지를 설명합니다.

회의록 정리 스킬의 Description, 입력, 추측 금지와 미정 처리 규칙, 출력 구역을 정리한 지침서 예시
회의록 정리 스킬에 넣을 지침서 예시. 기능 설명보다 어떤 입력을 받고 어떤 기준을 지킬지 먼저 정합니다.

먼저 이해할 것: 스킬은 ‘반복 가능한 일하는 방식’이다

Notion은 스킬을 특정 유형의 일을 수행하도록 Notion AI를 가르치는 재사용 가능한 지침이라고 설명합니다. 스킬의 본체는 특별한 코드 파일이 아니라 Notion 페이지입니다. 따라서 기존 문서처럼 제목을 붙이고, 소유자를 정하고, 동료와 공유하고, 수정 이력을 관리할 수 있습니다. 예를 들어 “월간 사업 검토를 우리 팀의 지표 순서로 작성한다”, “제품 제안서를 디자인·개발 기준으로 비평한다”, “신규 입사자 체크리스트를 회사 정책에 맞게 만든다” 같은 규칙을 한 페이지에 담습니다.

핵심은 단순한 템플릿과 다릅니다. 템플릿이 빈 문서의 모양을 복제한다면, 스킬은 Agent가 요청을 해석할 때 참고할 판단 기준과 작업 순서를 제공합니다. 평소에는 Agent 채팅에서 /를 입력해 원하는 스킬을 고르고, 필요한 맥락을 덧붙여 실행할 수 있습니다. 자동 사용은 설명(Description)이 있는 스킬 데이터베이스의 스킬에서 기본적으로 켜집니다. 독립된 스킬 페이지는 먼저 스킬 데이터베이스로 옮기고 설명을 추가해야 하며, Agent는 이 설명으로 요청과의 관련성을 판단합니다. 그래서 스킬 제목과 설명에는 “무엇을, 언제, 어떤 입력으로 처리하는지”를 모호하지 않게 적는 편이 좋습니다.

스킬, Custom Agent, 개인 지침은 무엇이 다를까?

도구맞는 상황시작 방식주의할 점
Agent Skill반복되는 작성·검토·정리 방식Agent 채팅에서 수동 실행 또는 관련 요청에서 활용지침 페이지의 범위가 너무 넓으면 결과가 흔들릴 수 있음
Custom Agent정해진 권한·도구·트리거가 필요한 지속 업무사람, 일정, 워크스페이스 이벤트별도 접근 권한과 연결 앱 범위를 설계해야 함
개인 지침내가 Agent와 대화할 때 항상 유지할 선호대화 전반팀 공용 업무 절차를 대신하기에는 추적과 공유가 약함

예를 들어 매주 같은 형식으로 회의록을 다듬는 일은 스킬부터 시작하기 좋습니다. 반면 매일 특정 데이터베이스의 변경을 감지해 여러 페이지를 업데이트해야 한다면 일정과 트리거를 갖춘 Custom Agent 쪽이 더 적합합니다. Custom Agent는 자체적으로 부여받은 페이지·데이터베이스·연결 앱 권한으로 동작합니다. 누구에게 Agent를 공유하느냐가 Agent가 볼 수 있는 정보와 별개라는 점도 중요합니다. 반대로 일반 Notion Agent는 사용자의 권한 범위 안에서 작동합니다.

에이전트가 실제 작업을 수행하는 환경과 권한 설계가 왜 중요한지는 앞서 정리한 OpenAI Agents API의 관리형 실행 환경 글에서도 확인할 수 있습니다. Notion의 스킬은 그보다 앞단에서 “어떤 기준으로 일을 시킬지”를 문서화하는 레이어에 가깝습니다.

시작 전 준비: 5분 점검표

  • Notion AI 사용 가능 여부: Agent를 쓸 수 있는 플랜과 워크스페이스 설정인지 확인합니다. 모델에 따라 Notion 크레딧이 사용될 수 있습니다.
  • 반복 업무 하나: 처음부터 모든 업무를 일반화하지 말고, 입력과 산출물이 비교적 일정한 작업 하나를 고릅니다.
  • 좋은 기준 문서: 실제로 팀이 승인한 예시, 문체 규칙, 금지 표현, 검토 항목을 모읍니다. 민감한 원문은 권한을 확인한 뒤 넣습니다.
  • 소유자와 검토 주기: 스킬의 책임자와 업데이트 시점을 정합니다. 오래된 정책을 그대로 쓰는 스킬은 자동화보다 위험합니다.
  • 권한 확인: Custom Agent와 함께 쓸 계획이라면, 해당 Agent에 어떤 페이지·연결 앱을 명시적으로 허용할지 먼저 정합니다.

첫 스킬 만들기: ‘회의록을 실행 항목으로 바꾸기’ 예시

다음은 회의 메모를 팀의 실행 문서로 바꾸는 스킬입니다. 목표는 멋진 요약이 아니라, 결정과 담당자·기한이 빠지지 않는 결과를 얻는 것입니다.

  1. 새 스킬을 만듭니다. 사이드바의 Library → Skills → + Add a skill에서 새 스킬 페이지를 만듭니다. 기존 페이지를 사용하려면 페이지 상단의 ••• → Use as a skill을 선택합니다. Agent에게 대화로 스킬 생성을 요청할 수도 있습니다.
  2. 스킬 페이지에 목적을 한 줄로 씁니다. 예: “회의 메모를 결정·실행 항목·확인 필요 사항으로 분류해 프로젝트 페이지 초안으로 만든다.” 이 문장이 스킬을 찾고 판단할 때의 기준이 됩니다.
  3. 입력과 출력 형식을 고정합니다. 입력은 회의 메모와 회의 날짜로 정하고, 필요하면 참석자 정보를 덧붙입니다. 출력은 ‘결정사항 / 실행 항목 표 / 확인 질문’ 세 구역으로 정합니다. 담당자나 마감일이 원문에 없으면 추측하지 말고 “미정”으로 표시하라고 적습니다.
  4. 검토 규칙을 추가합니다. 예를 들어 “원문에 없는 약속을 만들지 말 것”, “고유명사·수치·마감일은 원문과 대조할 것”, “민감한 고객 정보는 결과에 반복하지 말 것”을 넣습니다.
  5. 예시 한 건으로 시험합니다. 실사용 전, 민감하지 않은 짧은 회의 메모를 제공하고 결과를 봅니다. 세 구역이 모두 생겼는지, 미정 사항을 사실처럼 단정하지 않았는지 확인합니다. 원하는 결과가 아니라면 지시문을 고치고 다시 확인합니다.
  6. 이름과 설명을 정리해 공유합니다. 스킬은 페이지이므로 팀이 찾기 쉬운 이름, 적용 조건, 담당자를 적습니다. 관련 스킬을 모아 데이터베이스로 관리하면 한곳에서 최신 버전을 찾기 쉽습니다.

완료 확인은 “스킬이 존재한다”가 아니라, 다른 팀원이 같은 입력으로 실행했을 때 같은 필수 구역과 검토 규칙을 얻는지로 합니다. 스킬이 의도와 다르게 자동 선택된다면 제목·설명을 더 구체화하거나, 당분간은 채팅에서 직접 선택해 사용합니다.

회의 메모 정리 전후: 테스트 1주 연장을 결정사항으로, 오류 목록은 민지와 9월 18일로, 고객 공지의 담당자와 기한은 미정으로 표시한 예시
입력 메모를 결정사항과 실행 항목으로 나눈 예시. 원문에 없는 고객 공지의 담당자·기한은 미정으로 남깁니다.

테스트할 때는 표가 깔끔한지만 보지 말고 어떤 정보가 보존됐고 무엇을 추측하지 않았는지 확인하세요. 이 예시에서 오류 목록의 담당자는 민지, 기한은 9월 18일로 유지됩니다. 고객 공지에는 담당자와 기한을 임의로 붙이지 않고 확인 질문을 남깁니다. 실제 결과가 이런 기준을 어기면 실행을 반복하기 전에 스킬 지침을 수정하는 편이 좋습니다.

바로 써볼 수 있는 세 가지 설계

1. 콘텐츠 초안 품질 점검

입력은 초안과 독자 대상, 출력은 사실 확인 필요 문장·빠진 맥락·제목 후보로 제한합니다. “근거 없는 수치와 직접 경험처럼 보이는 표현을 표시하고, 고칠 때는 원문에 없는 사실을 추가하지 않는다”는 규칙을 넣으면 검토의 목적이 분명해집니다. 산출물은 곧바로 게시하는 글이 아니라 편집자가 확인할 수정 목록이어야 합니다.

2. 제품 제안서 리뷰

입력은 제안서와 팀의 승인 기준입니다. 출력은 사용자 문제, 성공 기준, 의존성, 위험, 결정이 필요한 질문으로 구성합니다. 기대 산출물은 “좋다/나쁘다” 평가가 아니라 다음 회의에서 확인할 질문 목록입니다. 수치나 일정은 제안서에 있을 때만 옮기도록 해 추측을 막습니다.

3. 신규 입사자 문서 정리

입력은 승인된 정책 문서와 역할 정보입니다. 출력은 첫 주 체크리스트와 연결할 원문 링크입니다. 접근 권한이 필요한 시스템은 직접 권한을 부여하거나 완료됐다고 말하지 않고, 담당자에게 요청할 항목으로 남기게 합니다. 정책이 바뀌면 스킬 페이지의 연결 자료와 지시문도 함께 갱신합니다.

권한·비용·보안에서 자주 막히는 지점

첫째, 스킬 페이지 자체를 볼 수 있다고 해서 모든 자료에 자동 접근하는 것은 아닙니다. 특히 Custom Agent는 사람의 권한을 상속하지 않고, 명시적으로 허용한 페이지·데이터베이스·연결 앱 범위에서만 작동합니다. 반대로 Agent에 넓은 권한을 주고 많은 사람과 공유하면, 사용자가 직접 보지 못하는 정보를 Agent 결과로 접할 위험이 생길 수 있습니다. 시작은 최소 권한, 읽기 전용 자료, 제한된 사용자 그룹이 안전합니다.

둘째, 모델과 실행 비용을 따로 봐야 합니다. Notion은 일부 프리미엄 모델이 크레딧을 사용하며, 워크스페이스 관리자가 Settings → Notion AI에서 사용 가능한 모델을 관리할 수 있다고 안내합니다. 스킬을 배포하기 전에 어떤 모델이 선택되는지, 팀의 크레딧 한도와 모니터링 위치가 무엇인지 확인하세요. “자동으로 쓴다”는 이유만으로 비용이 자동으로 예측되는 것은 아닙니다.

셋째, 스킬은 정책의 복사본이 아니라 검토 가능한 운영 문서여야 합니다. 실패 사례, 예외 처리, 근거 문서 링크, 마지막 검토일을 스킬 페이지에 남기면 누군가가 왜 그런 결과가 나왔는지 추적하기 쉽습니다. 업무 규칙이 바뀌면 스킬도 함께 갱신해야 기존 기준을 잘못 적용하는 문제를 줄일 수 있습니다.

마무리: 가장 작은 반복부터 문서화하자

Notion Agent Skills의 가치는 프롬프트를 길게 쓰는 데 있지 않습니다. 팀이 이미 합의한 좋은 판단 기준을 짧고 검토 가능한 단위로 만들고, 같은 업무가 들어올 때 다시 꺼내 쓰는 데 있습니다. 이번 주에는 반복되는 업무 하나를 골라 입력·출력·금지 사항·완료 기준 네 가지만 적어 보세요. 결과가 안정되면 팀 라이브러리에 공유하고, 일정·외부 도구·별도 권한이 필요한 단계만 Custom Agent로 확장하는 순서가 부담이 적습니다.

공식 자료와 확인일

자료 확인일: 2026년 9월 16일

댓글

이 블로그의 인기 게시물

Diagram Design 사용법: Claude Code·Codex로 다이어그램 만드는 순서

Aside Browser 사용법: 설치·가격·권한과 업무 자동화 가이드

OpenAI Agents API란? 관리형 에이전트 실행 환경 이해하기