에이전트 스킬(Agent Skills)이란 — 폴더 하나로 AI에게 업무를 가르치는 표준, 리눅스재단으로 갔다
Agent Skills is an open format, started by Anthropic, in which a folder with a SKILL.md file of instructions plus optional scripts and resources teaches an AI agent a task; the agent reads only the short name and description until the skill is needed. Anthropic donated the standard to the Linux Foundation's Agentic AI Foundation on October 22, 2026, alongside OpenAI's Open Responses, Hugging Face's OpenEnv and Alibaba's OpenSandbox.
에이전트 스킬(Agent Skills)은 AI 에이전트에게 특정 업무 방법을 가르치는 개방형 형식이다. SKILL.md라는 설명서 파일과 스크립트·참고 자료를 폴더 하나에 담아 두면, 에이전트는 평소엔 이름과 한 줄 설명만 읽고 있다가 필요할 때 전체를 불러온다. 앤트로픽이 만들어 2025년 12월 공개 표준으로 풀었고, 2026년 10월 22일 리눅스재단 산하 '에이전틱 AI 재단(AAIF)'에 기증했다
3줄 요약
- 형식 — SKILL.md(이름·설명+지침)와 스크립트·자료를 담은 폴더 하나
- 원리 — 평소엔 설명만, 필요할 때만 전체를 읽어 문맥을 아낀다
- 지위 — 10월 22일 리눅스재단 AAIF에 기증, MCP·AGENTS.md와 같은 집
핵심 질문
- 에이전트 스킬 MCP 차이
- **MCP는 AI를 외부 도구에 연결하고, 스킬은 그 도구로 일하는 방법을 가르친다.** | 구분 | 에이전트 스킬 | MCP | |---|---|---| | 담는 것 | 지침·절차·스크립트·자료 | 도구·데이터 연결 규약 | | 형태 | 폴더+SKILL.md 파일 | 클라이언트-서버 프로토콜 | | 실행 | 에이전트가 읽고 따름 | 서버가 요청을 처리 | | 비유 | 업무 매뉴얼 | 콘센트 규격 |
- SKILL.md 작성법
- **맨 위에 이름과 설명을 적고, 아래에 지침을 쓴다.** | 부분 | 내용 | 언제 읽히나 | |---|---|---| | 머리말(YAML) | name, description | 항상(목록용) | | 본문(마크다운) | 단계별 지침·주의점 | 스킬이 필요할 때 | | 부속 파일 | 스크립트·양식·참고 문서 | 지침이 가리킬 때 |
- 에이전트 스킬 지원하는 프로그램
- **앤트로픽은 70개 넘는 에이전트 플랫폼이 채택했다고 밝혔다.** | 범주 | 예 | |---|---| | AI 비서 | 클로드, 챗GPT | | 코딩 도구 | 커서, 깃허브 코파일럿, VS Code, 코덱스 | | 관리 | 리눅스재단 AAIF(2026년 10월 22일부터) |
AI 에이전트에게 일을 맡길 때 가장 귀찮은 건 매번 같은 설명을 반복하는 것이다. "보고서는 이 양식으로, 숫자는 이 시트에서, 마지막에 이 검사를 돌려라." 에이전트 스킬(Agent Skills)은 이 설명을 폴더 하나에 묶어 두고 에이전트가 필요할 때 꺼내 쓰게 하는 형식이다.
앤트로픽이 만들어 2025년 12월 공개 표준으로 풀었고, 2026년 10월 22일 리눅스재단 산하 에이전틱 AI 재단(AAIF)에 기증했다. 같은 재단에는 이미 앤트로픽의 MCP, AGENTS.md, 블록의 goose가 들어가 있다. 특정 회사가 아니라 중립 재단이 표준을 관리하게 된 것이다.
1. 스킬은 어떻게 생겼나
스킬 하나는 폴더 하나다. 핵심은 SKILL.md 파일이다.
| 구성 | 형식 | 예(‘분기 보고서 작성’ 스킬) |
|---|---|---|
| 머리말 | YAML: name, description | name: 분기 보고서 / description: 재무 시트로 분기 보고서를 만들 때 |
| 본문 | 마크다운 지침 | 1) 시트에서 매출 탭을 읽는다 2) 양식에 채운다 3) 합계 검사를 돌린다 |
| 스크립트 | 파이썬·셸 등 | check_totals.py |
| 자료 | 양식·참고 문서 | template.docx, style-guide.md |
왜 이렇게 나눴나 — '점진적 공개'
에이전트는 처음에 모든 스킬의 이름과 설명 한 줄만 읽는다. 지금 할 일이 그 설명과 맞으면 그때 본문을 읽고, 본문이 가리키는 파일을 그때 연다.
| 단계 | 에이전트가 읽는 것 | 문맥(토큰) 사용 |
|---|---|---|
| 평소 | 스킬 목록의 이름·설명 | 스킬당 몇십 토큰 |
| 해당 업무 시작 | SKILL.md 본문 | 수백~수천 토큰 |
| 세부 단계 | 스크립트·참고 자료 | 필요한 것만 |
스킬을 수십 개 깔아 둬도 문맥 창이 차지 않는 이유다. 문맥 창이 왜 귀한지는 「컨텍스트 윈도우란」에서 다뤘다.
2. MCP·AGENTS.md와 무엇이 다른가
세 가지 모두 AAIF가 관리하지만 맡는 일이 다르다.
| 표준 | 한 줄 정의 | 담는 것 | 비유 |
|---|---|---|---|
| 에이전트 스킬 | 일하는 방법 꾸러미 | 지침·절차·스크립트 | 업무 매뉴얼 |
| MCP | 도구 연결 규약 | 외부 시스템 접속 방법 | 콘센트 규격 |
| AGENTS.md | 저장소 안내문 | 프로젝트 규칙·명령어 | 현관 안내판 |
| A2A | 에이전트끼리 대화 규약 | 작업 위임·응답 형식 | 사내 메신저 |
MCP로 사내 데이터베이스에 연결했다면, 스킬은 "그 데이터베이스에서 이 순서로 조회해 이 양식으로 정리하라"를 가르친다. MCP의 구조는 「MCP란」, 에이전트끼리 협업은 「A2A 프로토콜이란」에 정리했다.
3. 10월 22일 무엇이 바뀌었나
| 항목 | 내용 |
|---|---|
| 발표 | 2026년 10월 22일, 샌호세 AGNTCon + MCPCon |
| 함께 들어간 프로젝트 | 오픈AI 'Open Responses'(여러 회사 LLM을 같은 API로), 허깅페이스 'OpenEnv'(강화학습 환경), 알리바바 'OpenSandbox'(에이전트 실행 상자) |
| AAIF 프로젝트 수 | 2025년 12월 출범 시 3개 → 10개 |
| 앤트로픽 이관 범위 | 명세, 깃허브 조직, 로고, agentskills.io 도메인 |
| 채택(앤트로픽 발표) | 에이전트 플랫폼 70곳 이상, 설치 2억8천만 회 |
MCP 공동 창시자 데이비드 소리아 파라는 "스킬로 무언가를 만드는 누구나 다음 방향을 함께 정할 수 있게 하려는 것"이라고 말했다. 경쟁사인 오픈AI·알리바바도 자기 표준을 같은 날 같은 재단에 넣었다. 에이전트 도구가 회사마다 따로 노는 상황을 피하려는 흐름이다.
4. 써 보려면 — 사례와 주의점
| 활용 예 | 스킬에 담는 것 |
|---|---|
| 회사 문서 양식 | 브랜드 규칙·서식·검사 스크립트 |
| 데이터 분석 | 자주 쓰는 쿼리·차트 규칙 |
| 코드 리뷰 | 팀 체크리스트·테스트 명령 |
| 고객 응대 | 답변 원칙·금지 표현·에스컬레이션 기준 |
주의점
- 스크립트는 실행된다. 남이 만든 스킬을 깔 때는 안의 스크립트를 먼저 읽어야 한다. npm 패키지처럼 공급망 공격의 통로가 될 수 있다(「npm 공급망 공격이란」 참조).
- 지시문 삽입 위험. SKILL.md 본문은 에이전트가 그대로 따르는 지침이다. 악의적인 문장이 섞이면 「프롬프트 인젝션이란」에서 본 공격과 같은 효과가 난다.
- 설명이 곧 호출 조건. description을 모호하게 쓰면 엉뚱한 때 불리거나 필요할 때 안 불린다. "언제 쓰는지"를 구체적으로 적는 것이 핵심이다.
5. 자주 묻는 것
| 질문 | 답 |
|---|---|
| 코딩을 몰라도 만들 수 있나 | 지침만 있는 스킬은 마크다운 문서 하나로 충분하다 |
| 클로드 전용인가 | 아니다. 공개 표준이고 10월 22일부터 리눅스재단이 관리한다 |
| 무료인가 | 형식 자체는 무료 공개 명세다. 실행하는 에이전트 요금은 별개 |
| 플러그인과 같은가 | 비슷하지만 스킬은 코드보다 '지침' 중심이고, 필요할 때만 읽힌다 |