GLOSSARY

Agent Skills

중급AI 에이전트

이 페이지는 AI 에이전트 문맥에서 자주 쓰이는 Agent Skills의 뜻과 쓰임을 중급 난이도 기준으로 정리한 AI 용어사전 항목입니다. 정의와 맥락, 관련 용어 9개, 관련 글 2개 순서로 묶었으니, 아래 설명을 먼저 읽고 연결된 개념과 글까지 이어서 보면 이해가 빨라집니다.

Agent Skills(에이전트 스킬)는 AI 에이전트가 특정 작업을 처리하는 방법과 필요한 자료를 SKILL.md 중심의 폴더에 묶어 두는 공개 형식입니다. 에이전트는 작업과 관련된 스킬만 골라 읽고, 그 안의 절차와 참고 자료를 따라 일을 수행합니다.

SKILL.md와 폴더에는 무엇이 들어가나

Agent Skills 공식 개요는 스킬을 전문 지식과 반복 업무 절차를 담는 가벼운 공개 형식으로 설명합니다. 최소 구성은 폴더 하나와 그 안의 SKILL.md입니다. 이 파일의 YAML frontmatter에는 name과 description을 반드시 적고, 본문에는 단계별 지시, 입력과 출력 예시, 예외 처리처럼 에이전트가 실제로 따라야 할 내용을 씁니다. description은 스킬이 무엇을 하며 언제 필요한지를 알려주므로, 에이전트가 알맞은 작업에서 스킬을 고르는 기준이 됩니다.

작업이 복잡하면 폴더에 scripts, references, assets 같은 자료를 더할 수 있습니다. scripts에는 반복 실행할 코드, references에는 상세 규칙이나 제품 문서, assets에는 양식과 이미지 같은 결과물 재료를 둡니다. 공식 사양은 SKILL.md만 필수로 정하고 나머지 디렉터리는 선택 사항으로 둡니다. 그래서 문체 지침만 담은 간단한 스킬도 만들 수 있고, 문서 변환 코드와 회사 양식을 함께 가진 제작 스킬도 만들 수 있습니다.

예를 들어 매달 같은 형식의 영업 보고서를 만드는 팀이라면 monthly-sales-report 스킬을 만들 수 있습니다. SKILL.md에는 열 이름 확인, 누락값 처리, 표와 그래프 순서, 검토 항목을 적습니다. scripts에는 매출 합계를 계산하는 코드를, assets에는 회사 보고서 템플릿을 둡니다. 사용자가 원본 스프레드시트를 주고 보고서 작성을 요청하면, 지원하는 에이전트는 이 스킬을 읽고 같은 절차와 형식으로 결과를 만듭니다.

점진적 로딩과 다른 확장 기능의 차이

Agent Skills의 중요한 설계가 점진적 로딩(progressive disclosure)입니다. 모든 스킬의 전문을 세션 시작부터 넣지 않고, 먼저 이름과 설명만 목록으로 보여줍니다. 작업과 맞는 스킬이 선택되면 SKILL.md 전체를 읽고, 그 지시에서 요구할 때만 참고 파일이나 스크립트를 엽니다. 클라이언트 구현 안내는 이 과정을 목록 확인, 지시 로딩, 필요한 자료 로딩의 세 단계로 나눕니다. 스킬이 많아져도 처음부터 모든 자료가 컨텍스트를 차지하지 않도록 만든 구조입니다.

스킬은 도구, MCP, AGENTS.md, 서브에이전트와 역할이 다릅니다. 도구는 파일 읽기나 API 호출처럼 에이전트가 실행할 수 있는 동작입니다. MCP는 외부 서비스와 데이터를 연결하는 규약이며, 스킬은 그 도구와 데이터를 어떤 순서와 기준으로 쓸지 알려줍니다. AGENTS.md 같은 프로젝트 지침 파일에는 저장소 전체에서 계속 지켜야 할 규칙을 두고, 스킬에는 특정 작업에서만 필요한 절차를 두는 편이 맞습니다. 서브에이전트는 별도의 컨텍스트에서 위임된 작업을 수행하는 실행 주체이고, 스킬은 주체가 따라 읽는 작업 지침입니다.

ℹ️형식과 실행 능력은 구분해야 합니다

SKILL.md에 명령이 적혀 있어도 에이전트에 해당 도구와 권한이 없으면 실행할 수 없습니다. 스킬은 작업 방법을 전달하며, 실제 능력과 허용 범위는 사용하는 제품과 환경이 결정합니다.

호환성과 신뢰를 어떻게 판단하나

공개 형식이라는 말이 모든 에이전트에서 똑같이 실행된다는 뜻은 아닙니다. 제품마다 스킬을 찾는 경로, 자동 호출 방식, 지원하는 frontmatter, 스크립트 실행 언어와 권한 처리가 다를 수 있습니다. 공식 사양의 allowed-tools 필드도 실험 항목이며 구현별 지원 차이가 있다고 명시합니다. Claude Agent SDK의 Skills 문서에서는 SDK 사용 시 이 필드가 적용되지 않고, 애플리케이션의 도구 허용 설정으로 권한을 관리한다고 설명합니다. 스킬을 다른 제품으로 옮길 때는 파일이 보이는지, 지시가 로드되는지, 필요한 도구를 쓸 수 있는지 각각 확인해야 합니다.

설치 전에는 스킬 폴더를 코드 패키지처럼 검토해야 합니다. 지시문은 에이전트의 행동을 바꾸고, 스크립트는 파일이나 네트워크에 직접 영향을 줄 수 있습니다. 출처가 분명한지, 어떤 파일을 읽고 쓰는지, 외부 전송이나 설치 명령이 있는지 확인합니다. 업무에 필요하지 않은 넓은 권한을 요구한다면 범위를 줄이고, 민감한 자료에는 읽기 전용 도구만 허용하는 편이 안전합니다. 공개 저장소에 있다는 사실이나 다른 사람이 많이 쓴다는 사실만으로 내용을 신뢰해서는 안 됩니다.

긴 설명은 한 파일에 몰아넣지 않는 편이 좋습니다. description에는 호출 조건을 구체적으로 적고, 본문에는 작업 순서와 실패 조건을 남기며, 상세 자료는 필요할 때 읽을 파일로 나눕니다. 실행 결과를 검사하는 단계도 지시 안에 포함해야 합니다. 같은 입력에서 비슷한 결과가 나올지는 분명한 절차, 현재 환경과 맞는 도구, 검토 가능한 스크립트, 필요한 권한이 함께 갖춰졌는지에 달려 있습니다.

RELATED TERMS