아무도 구분하지 않지만 구분해야 할 3가지 에이전트 스킬

에이전트 스킬이란 무엇인가?

LangChain, CrewAI, Claude Code, AutoGen 등을 사용하여 에이전트를 구축해 본 적이 있다면, 누구나 "스킬"에 대해 이야기하지만 아무도 같은 의미로 사용하지 않는다는 문제에 직면했을 것입니다.

AI 에이전트는 소프트웨어의 새로운 구성 요소가 되고 있습니다. 모든 작업에 코드를 작성하는 대신, 에이전트를 구성(목표, 도구, 행동 세트 부여)하면 에이전트가 스스로 단계를 파악합니다. 에이전트 스킬은 범용 에이전트를 특정 맥락에서 실제로 유용하게 만드는 방법입니다.

하지만 문제는 "스킬"이라는 단어 자체가 망가졌다는 것입니다.

같은 단어, 네 가지 다른 의미

주요 프레임워크들을 살펴보세요:

| 프레임워크 | '스킬'이라 부르는 것 | 실제 의미 |
| :--- | :--- | :--- |
| Alexa | Skill | 음성 트리거 앱 통합 — 고유한 호출 문구와 응답 로직을 가진 미니 앱 |
| Semantic Kernel | Skill | 플래너에 기능을 노출하는 함수 래퍼 — 타입이 지정된 API 엔드포인트에 가까움 |
| CrewAI | Skill | 에이전트 역할 정의 — 에이전트가 무엇을 할 수 있는지가 아니라 크루 내에서 '누구'인지를 정의 |
| Anthropic (Claude Code) | Skill | 코딩 에이전트의 행동을 구성하는 파일 폴더 (SKILL.md + 헬퍼 스크립트) |

어떤 것도 이식 가능하지 않습니다. 깔끔하게 구성되지도 않습니다. 한 프레임워크에서 "스킬"을 배운 개발자는 다음 프레임워크에서 그것을 다시 배워야 합니다.

Anthropic의 형식은 구체적이고 실용적이지만, 근본적인 긴장이 내재되어 있습니다.

너무 좁고(파일 시스템의 코딩 에이전트에만 적용) 너무 넓습니다(형식은 정의되어 있지만 의미론은 정의되지 않음). 그들의 가이드라인은 SKILL을 정의하는 '방법'만 알려줄 뿐, '무엇을 의미하는지'는 알려주지 않습니다. 기존 워크플로우와 어떻게 연결할지, 범위를 어떻게 정할지, 언제 하나의 스킬을 둘로 나눌지 알려주지 않습니다. 도구는 있는데 사용 설명서가 없는 것과 같습니다.

새로운 단어는 필요 없습니다. 더 나은 정신 모델이 필요합니다.

분류: 3가지 유형의 스킬

이름의 혼란을 넘어서면 더 명확한 그림이 나타납니다. 야생에서 "스킬"이라고 불리는 대부분의 것들은 사실 세 가지 범주 중 하나에 속하며, 그 차이를 이해하면 설계, 범위 지정, 결합 방식이 바뀝니다.

🧠 페르소나 스킬 — 에이전트가 누가 되는가

페르소나 스킬은 에이전트의 정체성, 즉 어조, 전문성, 경계, 행동 기본값을 정의합니다. 작업이 아니라 캐릭터입니다.

"당신은 보안 취약점에 집중하는 시니어 코드 리뷰어입니다. 심각도 등급과 함께 문제를 표시하고, 문제만 지적하는 것이 아니라 항상 해결책을 제안하세요."

형식: 주로 자연어 — 에이전트를 위한 캐릭터 시트로 생각하세요.

이식성: 예 — 모든 LLM 기반 에이전트 런타임에서 작동합니다.

비유: 역할에 맞는 사람을 고용하는 것. 어떤 버튼을 누를지가 아니라 어떤 사람이 되어야 할지를 설명합니다.

🔧 도구 스킬 — 에이전트가 무엇을 할 수 있는가

도구 스킬은 API 호출, 함수, 외부 서비스와 같은 특정 기능을 래핑합니다. 개별적이고 상태가 없으며 호출 가능합니다.

예시: "웹 검색", "이메일 전송", "데이터베이스 쿼리"

형식: 함수 시그니처 + 인증 구성 + 사용 지침

이식성: 부분적 — 인터페이스는 이식 가능하지만 실행은 런타임 환경과 인증 구성에 따라 다릅니다. API 버전 관리와 자격 증명 관리 때문에 도구 스킬은 플랫폼 간 이동 시 조정이 필요한 경우가 많습니다.