한국어EN
5분 용어할 수 있는 일고급기술 용어까지

에이전트 스킬(Agent Skills), SKILL.md

AI가 만든 글AI(Claude)가 이 사이트의 기록과 수업을 바탕으로 쓴 낱말 풀이예요. 자동 점검을 거쳐 올리고, 운영자가 모든 글을 읽지는 않아요.만드는 방법

AI 에이전트가 필요할 때만 꺼내 읽는 일 설명서 꾸러미예요.

에이전트 스킬은 AI 에이전트에게 어떤 일을 하는 방법을 알려 주는 파일 꾸러미예요. 가운데에는 SKILL.md라는 설명서가 꼭 있고, 이름과 짧은 설명, 일하는 방법이 적혀 있어요. 필요하면 프로그램 코드나 서식 파일도 함께 넣어요.

에이전트는 처음엔 스킬마다 이름과 설명만 읽어 두고, 맡은 일이 그 설명과 맞을 때만 설명서 전체를 펼쳐요. 그래서 스킬을 많이 깔아도 컨텍스트 창을 조금만 차지해요. Anthropic이 2025년 10월 내놓았고, 12월에 개방 표준으로 공개했어요.

다만 스킬을 까는 건 남이 쓴 지시와 코드를 내 에이전트에 들이는 일이에요. 2026년 1월 Cisco가 에이전트 스킬 3만 1천 개를 분석했더니 26%에서 취약점이 하나 이상 나왔어요.

비유로 보면

체육관 선반에 종목별 규칙 카드가 꽂혀 있다고 해 봐요. 선생님은 평소엔 카드 제목만 훑어보다가, 오늘 피구를 하게 되면 그때 피구 카드만 꺼내 자세히 읽죠. 에이전트 스킬도 제목만 들고 있다가 필요한 순간에 설명서를 펼쳐요.

예를 들면

'우리 반 발표 자료를 학교 양식대로 만들어 줘'라고 할 때, 학교 양식 스킬이 깔려 있으면 에이전트가 그 설명서와 서식 파일을 꺼내 써요.

자주 하는 오해

  • 오해스킬을 깔면 AI 모델이 새로 학습해서 더 똑똑해진다.

    실제로는스킬은 모델 속 숫자를 바꾸지 않아요. 일할 때 설명서를 읽어 컨텍스트에 넣을 뿐이라, 스킬을 지우면 그 방법도 더는 쓰지 못해요. 같은 형식을 지원하는 다른 에이전트로 그대로 옮겨 쓸 수 있는 것도 그래서예요.

  • 오해공개된 곳에 올라온 스킬이면 안심하고 깔아도 된다.

    실제로는Anthropic은 믿을 만한 곳의 스킬만 설치하고, 그렇지 않으면 안에 든 코드와 바깥 인터넷에 연결하라는 지시가 있는지 먼저 꼼꼼히 살피라고 권해요. SKILL.md는 글로 된 파일이라 설치하기 전에 직접 열어 읽어 볼 수 있어요.

수업에서 써 보기

선생님은 수업 시작에, 학생은 혼자 공부할 때 써 보세요.

질문
에이전트가 '지금 이 스킬을 꺼낼 때'라는 걸 알아채게 하려면, 설명 한 줄을 어떻게 써야 할까요?
활동
모둠마다 '급식 식단표로 영양 보고서 쓰기' 같은 일을 하나 골라 스킬 카드를 만들어요. 맨 위에 이름과 한 줄 설명을, 아래에 단계별 방법을 적어요. 다른 모둠이 설명 한 줄만 보고 언제 쓸 카드인지 맞혀 본 뒤, 출시 기록(E0723)의 '필요할 때만 읽기' 방식과 Cisco 분석(E0838)을 읽고 서로의 카드에 '밖으로 보내기' 같은 위험한 지시가 없는지 점검해요.

이 낱말과 이어진 기록

출처로 확인한 AI 역사 속 장면이에요.

Cisco (Amy Chang, Vineeth Sai Narajala, Idan Habler)
에이전트 스킬 31,000개 분석 결과 26%가 최소 1개 취약점 보유

스킬 마켓플레이스를 검증되지 않은 공급망으로 규정한 첫 대규모 실측

Anthropic
Agent Skills를 개방 표준으로 공개 (agentskills.io)

사양과 레퍼런스 SDK 공개, MCP에 이은 두 번째 표준화 시도

Anthropic
Agent Skills 출시 (SKILL.md, progressive disclosure)

절차적 지식을 폴더로 패키징하고 메타데이터-본문-번들 3단계로 필요할 때만 로드