노션에서 스크립트가 포함된 스킬을 작동시키는 방법

HWPX 문서 처리 스킬과 그리드 기반 PPT 스킬을 예시로, 노션 AI에서 스크립트형 에이전트 스킬을 ZIP 첨부 방식으로 운영하는 방법을 정리했습니다.

Jun 28, 2026
노션에서 스크립트가 포함된 스킬을 작동시키는 방법
📌
노션 AI 에이전트가 단순히 글만 쓰는 도구를 넘어, 실제 스크립트 기반 작업까지 처리하게 하려면 스킬을 어떻게 정리해야 할까요?
이번 글에서는 HWPX 문서 처리 스킬과 그리드 기반 PPT 제작 스킬을 예로 들어, 노션 AI 안에서 스크립트형 스킬을 운영하는 방법을 정리합니다. 핵심은 스킬 본문에는 실행 절차를 적고, 실제 실행 파일은 ZIP 패키지로 분리해 관리하는 것입니다.

이 글에서 다루는 내용 ⏳ 읽기 4분
  • 스크립트형 에이전트 스킬이 필요한 이유
  • LLM으로 작업하는 것과 스크립트로 작업하는 것의 차이
  • 스킬 본문과 ZIP 패키지를 분리해 관리하는 방법
  • HWPX·PPTX 스킬을 별도 포스트로 연결하는 구조
🔗
예시로 다룬 2가지 에이전트 스킬
이 글에서는 스크립트형 스킬을 어떻게 구성하는지 설명하고, 각 스킬의 복제와 사용법은 별도 소개 글에서 안내합니다.

노션 AI 안에서 스크립트를 실행한다는 것

LLM은 맥락을 읽고 판단해서 결과를 만듭니다. 같은 요청이어도 상황에 맞게 표현을 바꾸고, 빠진 맥락을 추론하고, 사용자의 의도에 맞춰 결과를 조정할 수 있죠.
반대로 스크립트는 정해진 규칙과 코드로 같은 절차를 안정적으로 반복합니다. 파일 변환, 문서 구조 검사, PPT 빌드처럼 결과가 매번 같아야 하는 작업에는 스크립트가 훨씬 안전합니다.
마침 스크립트를 이용하여 결정론적으로 일하는 방법을 다룬 뉴스레터도 있으니, 함께 보면 더 이해하기 좋습니다.
개발 지식이 없는 일반 사용자가 이런 스크립트 기반 작업을 직접 다루기에는 진입장벽이 높았습니다. 그래서 보통은 전용 프로그램을 쓰거나, 클로드 코드·코덱스 같은 코딩 에이전트의 도움을 받아야 했죠. 실행 환경을 준비하고, 파일 경로를 맞추고, 오류가 나면 로그를 읽어 고치는 일도 어느 정도는 필요했습니다.
그런데 이제 노션 AI 안에서도 스크립트를 사용할 수 있게 되었습니다. 결정론적으로 일해야 하는 경우 스크립트를 직접 작성하고 실행까지 할 수 있으며, 사용자가 첨부한 스크립트를 그대로 실행하는 것도 가능합니다. 스크립트의 작동을 포함한 일련의 흐름을 하나의 스킬로 정의해두면 더 쉽게 사용할 수 있겠죠?
⚠️
노션 샌드박스 컴퓨터는 아직 알파 서비스입니다.
현재 사양과 제공 범위는 앞으로 변경될 수 있으며, 모든 유저의 워크스페이스에서 동일하게 제공되고 있지 않을 수 있습니다. 따라서 이 글의 예시는 "현재 확인 가능한 알파 기능을 활용한 실험적 워크플로"로 이해해주세요.
노션 AI에서 코드가 실행되는 걸 우연히 발견한 후 커뮤니티에 즉시 제보한 카톡 내용. 해당 내용을 확인하자마자 노션 페이지를 PDF로 생성하도록 요청하자 직접 PDF 생성 스크립트를 작동시켜 작업을 완수하는 모습을 보여주었다.
노션 AI에서 코드가 실행되는 걸 우연히 발견한 후 커뮤니티에 즉시 제보한 카톡 내용. 해당 내용을 확인하자마자 노션 페이지를 PDF로 생성하도록 요청하자 직접 PDF 생성 스크립트를 작동시켜 작업을 완수하는 모습을 보여주었다.
스크립트 작성과 실행이 가능해진 이상, 노션 AI는 글을 요약하거나 문장을 다듬는 조력자 수준을 넘어설 수 있습니다. 에이전트 스킬을 잘 구성하면 정해진 절차에 따라 파일을 확인하고, 필요한 스크립트를 실행하고, 결과물을 검수하는 흐름까지 맡길 수 있습니다.

스크립트형 스킬 예시로 고른 2가지 작업

노션 AI에서 스크립트를 실행할 수 있다면, 선생님들의 실제 워크플로에 어떤 도움이 될 수 있을지 먼저 고민했습니다.
그중에서도 가장 많은 공수가 들어가는 작업은 크게 두 가지였습니다.
  • 한글 문서(HWPX) 작성·변환·편집
  • 수업·연수용 PPTX 제작
그래서 이번 글에서는 HWPX 문서 처리와 그리드 기반 PPT 제작을 예시로 골랐습니다. 두 사례는 "노션 AI가 스크립트를 실행하면 이런 방식으로 실제 파일 작업까지 도울 수 있다"는 것을 보여주기 위한 대표 예시입니다.
자세한 복제 방법과 사용 예시는 각 스킬 소개 글에서 따로 확인할 수 있습니다.

왜 ZIP 파일로 첨부했을까?

여기서 현실적인 문제가 하나 있었습니다.
노션 AI의 샌드박스 환경 안에서 스크립트를 실행하려면, 에이전트가 참고할 수 있는 실행 파일과 레퍼런스 자료가 필요합니다. 그런데 스킬 데이터베이스에 .py 같은 개별 스크립트 파일을 그대로 첨부하기가 어려웠습니다.
그래서 스크립트와 관련 자료를 ZIP 파일 하나로 묶어 첨부하는 방식으로 해결했습니다.
본문에는 에이전트가 읽을 실행 절차를 정리하고, 파일 속성에는 실제 스크립트가 들어 있는 ZIP 패키지를 붙였습니다. 에이전트는 먼저 본문을 읽고 어떤 순서로 실행할지 파악한 뒤, 첨부된 ZIP을 확인해 필요한 스크립트를 사용할 수 있습니다.
이 방식이 좋은 이유는 분명합니다.
  • 스킬 본문이 불필요하게 길어지지 않습니다.
  • 스크립트와 설명을 분리해서 관리할 수 있습니다.
  • 여러 파일로 구성된 스크립트 패키지를 한 번에 첨부할 수 있습니다.
  • 나중에 스킬을 복제해 가져갈 때 필요한 파일을 함께 확인하기 쉽습니다.
즉, 노션 AI 안에서 스크립트를 실행한다는 말은 에이전트가 즉석에서 마법처럼 결과물을 만들어낸다는 뜻이 아닙니다. 필요한 절차와 파일을 스킬 안에 정리해두고, 그 기준에 따라 샌드박스 안에서 실행하도록 만드는 방식입니다.

정리

이번 글의 핵심은 특정 스킬 2개를 깊게 설명하는 것이 아니라, 노션 AI에서 스크립트형 스킬을 어떻게 관리할 수 있는지 보여주는 것입니다.
HWPX 작성과 PPTX 제작은 선생님들의 워크플로에서 공수가 많이 드는 대표 작업이라 예시로 선택했습니다. 실제 스킬의 자세한 기능과 복제 방법은 아래 글에서 이어서 확인할 수 있습니다.