← AI 용어집

AI 용어집 · 기초 · 에이전트

스킬 Agent Skills

스킬(Agent Skills)은 AI 에이전트가 특정 작업을 잘 해내도록 지시문·스크립트·참고 자료를 한 폴더에 묶어 둔 '업무 매뉴얼 꾸러미'입니다. 에이전트는 이 꾸러미를 작업에 필요할 때만 꺼내 읽습니다.

쉽게 말하면 회사 캐비닛에 업무별 매뉴얼 바인더가 꽂혀 있는 것과 비슷합니다. 신입 직원은 평소엔 바인더 제목만 훑어보다가, 해당 업무를 맡으면 그 바인더만 꺼내 펼쳐 봅니다. 다만 사람과 달리 에이전트는 바인더에 든 프로그램(스크립트)을 직접 실행할 수도 있습니다.

무엇인가

스킬은 SKILL.md라는 문서 파일 하나를 중심으로 한 폴더입니다. SKILL.md에는 최소한 스킬의 이름과 설명이 들어가고, 그 아래에 작업을 어떻게 해야 하는지 알려 주는 지시문이 적힙니다. 필요하면 실행할 수 있는 스크립트, 참고 문서, 템플릿 같은 자료도 함께 넣습니다. Anthropic이 Claude용 기능으로 처음 소개했고, 이후 여러 회사의 도구에서도 쓸 수 있는 개방형 표준으로 공개했습니다.

스킬 폴더 한눈에 보기

  • my-skill/스킬 하나 = 폴더 하나
    • SKILL.md필수이름·설명 + 작업 지시문
      • 이름·설명평소에는 이것만 읽어 둠
      • 지시문작업이 맞을 때 꺼내 읽음
    • scripts/선택직접 실행할 수 있는 프로그램
    • references/선택참고 문서
    • assets/선택템플릿
예시 구조입니다. SKILL.md 하나만 있어도 스킬이 되고, 스크립트·참고 문서·템플릿은 필요할 때 더합니다.

어떻게 작동하나

핵심은 '필요한 만큼만 조금씩 읽기(Progressive disclosure)'입니다. 먼저 에이전트는 시작할 때 모든 스킬의 이름과 설명만 읽어 둡니다(발견). 사용자 작업이 어떤 스킬의 설명과 맞으면 그때 그 스킬의 SKILL.md 전체를 읽어 들입니다(활성화). 그다음 지시문을 따라 작업하면서, 필요하면 함께 든 스크립트를 실행하거나 참고 파일을 추가로 엽니다(실행).

스킬을 필요한 만큼만 읽어 들이는 3단계스킬 폴더들 → ① 발견(시작할 때); ① 발견 → ② 활성화(작업과 맞으면); 사용자 작업 → ② 활성화; ② 활성화 → ③ 실행; ③ 실행 → 작업 결과사용자 작업스킬 폴더들SKILL.md·스크립트참고 자료① 발견이름·설명만 읽기② 활성화SKILL.md 전체 읽기③ 실행지시 따르기스크립트·파일 사용작업 결과시작할 때작업과 맞으면
스킬을 필요한 만큼만 읽어 들이는 3단계 에이전트는 평소엔 스킬의 이름·설명만 알고 있다가, 작업이 맞아떨어질 때만 전체 지시문을 읽고 실행합니다.

왜 주목받나

AI 모델이 한 번에 기억하며 다룰 수 있는 글의 양(컨텍스트 윈도)은 한정돼 있습니다. 스킬은 평소엔 이름과 설명만 차지하므로, 많은 스킬을 갖춰 두어도 부담이 작습니다. 또 회사·팀만의 업무 절차와 노하우를 폴더 하나로 묶어 버전 관리하고 재사용할 수 있습니다. 같은 형식을 지원하는 여러 에이전트 제품에서 한 번 만든 스킬을 그대로 쓸 수 있다는 점도 장점으로 꼽힙니다. 만드는 방식이 단순해, 개발자가 아니어도 쉽게 고쳐 가며 개선할 수 있다는 평가도 나옵니다.

알아 둘 점

스킬은 모델 자체를 새로 학습시키는 것이 아니라, 필요할 때 읽어 들이는 지시문과 자료일 뿐입니다. 그래서 스킬의 설명을 어떻게 쓰느냐에 따라 에이전트가 제때 꺼내 쓰는지가 달라집니다. 스크립트가 든 스킬은 코드를 안전하게 실행할 수 있는 환경이 있어야 제대로 작동합니다. 외부에서 받은 스킬은 실행 코드를 담을 수 있으므로, 출처를 확인하고 쓰는 것이 좋습니다.

예시

Claude 앱에서 엑셀·파워포인트·워드 파일을 만들어 주는 기능은 스킬로 구현돼 있으며, 사용자는 조직의 브랜드 가이드 같은 자신만의 스킬도 만들어 넣을 수 있습니다. 이 사이트에서 다룬 소식으로는 AWS가 코딩 에이전트용 SageMaker 추론 최적화 스킬 'aws-ai-ml'을 공개한 사례가 있습니다. 코딩 에이전트가 이 스킬을 불러오면, AWS가 정리한 절차와 도구를 따라 모델 배포 작업을 처리할 수 있게 됩니다. OpenAI의 Codex 개발 문서에도 스킬을 만드는 방법이 따로 안내돼 있습니다.

이 사이트에서 나온 사례

함께 보면 좋은 용어

참고