6.1. 스킬(Skills)의 개념 및 구조 · 비개발자를 위한 Antigravity 가이드

1. 스킬(Skills)이란?

1.1. 클로드 스킬(Claude Skills)의 등장

AI 기술은 자고 일어나면 새로운 것이 쏟아질 정도로 빠르게 변화하고 있습니다. 그중에서도 최근 가장 주목받는 기술은 단연 앤트로픽(Anthropic)이 발표한 '클로드 스킬(Claude Skills)' 입니다.

클로드 스킬은 앤트로픽(Anthropic)이 처음 제안했으나, 특정 기업의 시스템에 종속되지 않는 오픈 표준(Open Standard) 을 지향합니다. 오픈 표준이란 정해진 프로토콜만 준수하면 서로 다른 플랫폼에서도 스킬을 자유롭게 호환하여 사용할 수 있음을 의미합니다. 마치 USB-C 규격이 다양한 전자기기의 연결 방식을 하나로 통일한 것처럼, 스킬은 AI 에이전트 생태계에서 프롬프트와 기능의 범용성을 보장하는 핵심 표준이 되고 있습니다.

이 덕분에 최근 OpenAI뿐만 아니라 구글에서도 Gemini CLI와 Antigravity를 통해 스킬(Skills) 을 공식 지원하기 시작했습니다. (2026.1.14 업데이트)

1.2. 스킬(Skills)의 개념

스킬은 단순히 길게 작성된 프롬프트가 아닙니다. AI 에이전트가 특정 전문 영역의 업무를 수행하는 데 필요한 지식, 실행 도구(Script), 참고 자료(resources) 를 하나로 묶은 '전문 지식 패키지' 입니다.

쉽게 비유하자면, 평소에는 다방면에 능숙한 일반 비서였던 AI가 상황에 따라 '법률 전문가 스킬'이나 '회계 전문가 스킬'을 즉시 장착하여, 해당 분야의 숙련된 전문가로 기능하도록 돕는 확장 기능과 같습니다.

이미 AI가 다양한 업무를 수행하고 있음에도 왜 스킬이 특별하다는 것인지 의문이 생길 수 있을 것입니다. 스킬의 핵심적인 특징은 다음과 같습니다.

전문성 확보: AI는 범용적인 지식은 풍부하지만 특정 영역의 깊이 있는 업무에는 한계가 있습니다. 스킬은 에이전트가 필요하다고 판단한 경우 전문가의 지식과 도구를 즉시 학습하여 결과물을 만들도록 돕습니다.
자원의 효율적 활용: AI에게 모든 정보를 한꺼번에 기억하게 하면 할루시네이션¹ 발생 가능성이 높아지고 처리 비용도 늘어납니다. 스킬은 필요한 순간에만 지식을 불러오기 때문에 에이전트가 컨텍스트를 효율적으로 활용할 수 있습니다.
일관된 결과 산출: 규칙(Rules)이나 워크플로우(Workflows)와 마찬가지로 확률 모델인 AI의 불확실성을 보완합니다. 스킬은 정해진 체계 안에서 일관되고 신뢰할 수 있는 결과를 만들어냅니다.

2. 스킬(Skills)의 작동 원리와 구조

2.1. 스킬(Skills)의 작동원리

스킬이 자원을 효율적으로 활용할 수 있는 핵심 비결은 '점진적 공개(Progressive Disclosure)' 에 있습니다.

이는 모든 정보를 한꺼번에 AI의 머릿속에 집어넣는 대신, 필요한 순간에 필요한 만큼만 단계적으로 정보를 로드하는 지능적인 방식입니다.

1단계: 탐색 (Discovery) 사용자의 명령을 듣고 "지금 이 업무에 필요한 스킬이 무엇인가?"를 찾아내는 단계입니다. 에이전트는 설치된 모든 스킬의 '이름'과 '설명(프론트 매터²)'을 확인합니다. 이 정보는 매우 가벼워서 수백 개의 스킬이 있어도 에이전트의 기억 공간(Context)을 거의 차지하지 않습니다.
2단계: 활성화 (Activation) 에이전트가 특정 스킬이 필요하다고 판단하면, 그제야 해당 스킬의 본체인 SKILL.md 파일의 전체 내용을 읽습니다. 단순히 이름만 아는 상태에서 벗어나, 업무를 어떻게 수행해야 하는지에 대한 상세 지침을 머릿속에 로드하는 단계입니다.
3단계: 실행 (Execution) 이제 에이전트는 작업을 수행하는 과정에서 스킬의 구체적인 지침을 따릅니다. 필요한 경우 폴더 내의 '스크립트'를 실행하거나 '상세 문서'를 참조하여 결과를 만들어냅니다. 이 방식 덕분에 에이전트는 방대한 전문 지식을 보유하면서도 현재 대화에만 명확하게 집중할 수 있습니다.

클로드 스킬과 안티그래비티 스킬

클로드와 안티그래비티에서 정의하는 스킬의 단계별 명칭은 차이가 있을 수 있으나 핵심 원리는 동일합니다. 본 가이드는 독자의 이해를 돕기 위해 안티그래비티 공식 가이드의 작동 방식을 기준으로 작성하였습니다.

2.2. 스킬(Skills)의 구조

스킬은 기본적으로 하나의 폴더 형태이며, 그 안에는 에이전트가 업무를 수행하는 데 필요한 모든 자원이 체계적으로 정리되어 있습니다.

2.1.1. 스킬의 폴더 구조

SKILL.md 파일은 필수이며, 나머지는 필요에 따라 선택적으로 구성합니다.

SKILL.md (필수): 스킬의 '두뇌'이자 메인 지침서입니다.
scripts/ (선택): 파이썬(Python)이나 쉘(Shell) 스크립트처럼 실제로 컴퓨터를 조작하거나 복잡한 계산을 수행하는 '손과 발' 역할을 하는 코드가 담깁니다.
examples/ (선택): 에이전트가 참고할 수 있는 성공적인 작업 사례나 샘플 결과물을 넣어둡니다. (에이전트는 예시를 볼 때 훨씬 더 정확하게 일합니다)
resources/ (선택): 템플릿 파일, 회사 표준 서식, 이미지, 참고용 데이터 등 에이전트가 업무 중에 열어봐야 할 백과사전입니다.

[예시]

valuation-expert/   # 스킬 폴더 이름
├── SKILL.md                  
├── scripts/                 
│   └── calculate_dcf.py   # DCF 계산 자동화 스크립트
├── examples/                
│   └── sample_report.md   # 잘 작성된 가치평가 보고서 샘플
└── resources/               
    ├── valuation_template.xlsx  # 재무모델링 엑셀 템플릿
    └── industry_multiples.csv   # 산업별 멀티플 참조 데이터

scripts 를 사용하는 것의 의미

AI 에이전트가 파일 생성, 편집 같은 업무를 수행할 때, 겉으로는 단순히 결과만 보여주는 것 같지만 사실 내부적으로는 직접 코드를 작성하고 실행하는 과정을 거칩니다. 하지만 매번 즉석에서 코드를 생성해 실행하면 결과가 불분명하거나 오류가 발생할 위험이 있습니다. 스킬 내에 검증된 스크립트를 미리 정의해두면, 에이전트가 매번 ' 확률 ' 에 의존해 코드를 새로 짜는 대신 ' 정해진 도구 ' 를 정확히 사용하게 되어 업무의 신뢰성과 안정성이 향상됩니다.

2.1.2. ‘SKILL.md’의 내부 구성

가장 중요한 SKILL.md 파일은 크게 두 부분으로 나뉩니다.

1. 프론트매터 (Front-matter): 파일 최상단의 --- 사이 영역입니다.

Name: 스킬의 고유 이름입니다.
Description: "이 스킬이 언제 필요한가?"에 대한 답입니다. 에이전트가 수많은 스킬 중 지금 필요한 것을 골라내는 '트리거(Trigger)' 역할을 하므로, 어떤 상황에서 쓰이는지 아주 상세하게 적는 것이 좋습니다.

Description 작성의 좋은 예 vs 나쁜 예

❌ 나쁜 예 (너무 간결함): " 기업 가치평가 및 엑셀 모델링 스킬 "
✅ 좋은 예 (명확한 트리거 포함): " 사용자가 가치평가 (Valuation) 나 재무 추정 모델링을 요청할 때 사용하며, 기업 재무 데이터를 분석해 DCF 엑셀 모델을 생성하고 적정 주가를 산출합니다."

2. 본문 (Markdown): 에이전트가 스킬을 로드한 후 따라야 할 구체적인 행동 지침입니다. 전문가의 업무 매뉴얼처럼 상세하게 구성하는 것이 포인트입니다.

목표 및 배경: 이 스킬을 통해 달성하고자 하는 최종 결과물과 맥락을 정의합니다. 예: "기업의 재무 데이터를 기반으로 DCF(현금흐름할인법) 모델을 구축하고 적정 가치를 산출합니다"
단계별 지침: 업무를 수행하는 논리적 순서를 정의합니다. 예: "1. 과거 3개년 재무제표 추출 → 2. 주요 가정 수립 → 3. 미래 현금흐름 추정 → 4. 기업가치 결과 도출"
업무 표준: 파일 명명 규칙, 데이터 구조, 보고서 톤앤매너 등 업무 표준을 지정합니다. 예: "모든 추정 근거는 엑셀 내 별도 주석으로 표기하고, 가독성을 위해 천 단위 콤마를 사용합니다"
주의사항: 에이전트가 절대 하지 말아야 할 행동을 명시합니다. 예: "정확한 근거가 없는 성장률은 임의로 입력하지 말 것", "일회성 비용은 추정치에서 반드시 제외할 것"
의사결정 트리: 복잡한 상황에서 에이전트가 스스로 판단할 수 있는 기준을 줍니다. 예: "만약 대상 기업이 적자 상태라면 PER 대신 EV/EBITDA 배수를 활용하여 상대가치를 보조 지표로 활용하라"
레퍼런스 연결: 폴더 내의 ./scripts/나 ./resources/ 파일을 구체적으로 언제 호출해야 하는지 알려줍니다.

3. 규칙(Rules) vs 워크플로우(Workflows) vs 스킬(Skills)

앞서 다뤘던 규칙, 워크플로우, 그리고 이번에 살펴본 스킬은 모두 에이전트가 내 의도대로 일관되게 행동하도록 돕는 도구라는 공통점이 있습니다. 모두 마크다운 파일을 기반으로 지침을 전달하며, 이를 통해 AI로부터 일관되고 신뢰할 수 있는 결과물을 얻게 해줍니다.

하지만 이들은 작동 방식과 주요 목적에 따라 다음과 같이 구분됩니다.

구분	규칙 (Rules)	워크플로우 (Workflows)	스킬 (Skills)
핵심 정의	에이전트가 항상 따라야 할 태도, 지침	특정 작업을 수행하기 위한 절차	특정 전문 능력을 사용하기 위한 지식, 도구, 스크립트의 패키지
작동 방식	상시 적용 (Always On) 또는 전역 설정	수동 트리거 (`/` 명령어 사용)	자동 탐색 (AI가 필요 시 스스로 로드∗)
주요 목적	코드 스타일, 문서화 표준 등 일관성 유지	테스트 생성, 코드 감사 등 반복 작업 실행	복잡한 도메인 작업 수행, 기능 확장, 컨텍스트 절약

∗ 단, 스킬(Skills) 또한 사용자가 명시적으로 특정 스킬을 사용하도록 요청할 수 있습니다. 이는 AI가 어떤 스킬을 활용할지 판단하기 어려운 모호한 상황에서 특히 유용합니다.

비교 예시: 기업 가치평가 (Valuation) 실무

규칙 (Rules): " 모든 재무 수치는 세 자리마다 콤마 (,) 를 사용하고, 최종 기업가치 (EV) 결과는 항상 표의 최하단에 볼드로 표시하라."
스킬 (Skills): XLSX 스킬 (엑셀 모델링 능력)
- 결과: 사용자가 " 엑셀로 DCF 모델을 생성해줘 " 라고 요청하면, 에이전트가 스스로 해당 스킬을 로드하여 복잡한 재무 수식이 포함된 엑셀 파일을 직접 작성하고 분석을 수행합니다.
워크플로우 (Workflows): /report-qc (보고서 최종 검수 절차)
- 결과: 보고서 작성이 끝나고 사용자가 이 명령어를 치면, 에이전트가 "1. 오타 교정 → 2. 본문과 표의 숫자 일치 확인 → 3. 각주 번호 누락 점검 → 4. 완료 보고 전송 " 절차를 수행합니다.

언제 어떤 것을 사용해야 할까요?

위에서 정의한 차별점들이 실제 사용 환경에서 항상 명확하게 구분되는 것은 아닙니다. 실무적인 관점에서는 다음과 같은 기준으로 활용해 보시길 추천합니다.

규칙 (Rules): 모든 대화에서 항상 지켜야 할 기본 원칙 (예: 한국어 답변, 특정 마크다운 스타일 유지 등)
워크플로우 (Workflows): / 명령어를 입력해 즉시 실행하고 싶은 정형화된 반복 작업
스킬 (Skills): 에이전트가 전문 지식으로 보유하고 있다가, 상황에 맞춰 스스로 판단해 꺼내 쓰길 바라는 전문 역량 특히 비개발자 사용자라면 스킬 기능을 적극 활용해 보세요. 엑셀 (xlsx), 워드 (docs), 파워포인트 (ppt) 와 같은 문서 작업을 스킬로 등록해두면 에이전트가 복잡한 수작업을 대신 수행해 줍니다. 구체적인 활용법은 다음 장에서 다루겠습니다.

할루시네이션 (Hallucination): 인공지능이 답변을 생성하는 과정에서 논리적인 오류나 잘못된 데이터를 바탕으로 사실이 아닌 정보를 마치 진실인 것처럼 그럴듯하게 지어내는 '환각 현상'을 의미합니다. ↩
프론트 매터 (Front-matter): 문서의 최상단에 위치하는 데이터 영역으로, 문서의 제목, 설명, 작성일 등 핵심 정보를 정해진 형식에 맞춰 기록한 것입니다. ↩