SHIFTONE
트렌드 소개16분 읽기SHIFTONE Team

업무 매뉴얼을 프롬프트에 붙여 넣고 계신가요 — Agent Skills 가 리눅스 재단 표준이 된 뒤, SKILL.md 한 장에 뭘 적어야 하나요

10월 22일 Anthropic 이 Agent Skills 를 Linux Foundation 산하 AAIF 에 기증했어요. 절차를 프롬프트에 붙여 넣는 대신 SKILL.md 폴더로 두면 무엇이 달라지는지, 점진적 공개 · MCP 와의 차이 · 공개 레지스트리의 악성 스킬까지 저희 관점에서 정리했어요.

펼쳐진 피아노 악보 위에 연필로 적은 연주 메모가 흩어져 있다 — 누구나 읽는 표준 기보법 위에 얹힌 그 팀만의 절차

신입이 온 둘째 날이에요. 경비 정산 절차를 알려 주려고 위키 링크 세 개와 슬랙에서 긁은 예외 규칙 몇 줄을 묶어 보내요. 석 달 뒤 다른 팀에 같은 걸 또 보내고요.

에이전트한테도 저희는 똑같이 하고 있었어요. 시스템 프롬프트에 절차 2천 자를 붙여 넣고, 다른 도구로 옮길 때 또 붙여 넣고요. 그 붙여넣기가 어디로 가야 하는지, 10월 22일에 답 하나가 정해졌어요.

10월 22일, 스킬이 MCP 옆자리로 갔어요

Anthropic 이 Agent Skills 의 이름과 로고, GitHub 조직, agentskills.io 도메인을 Linux Foundation 산하 Agentic AI Foundation(AAIF) 에 기증했어요. AAIF 는 지난해 12월 MCP 를 앵커로 출범한 재단이고, 8월엔 A2A 가 같은 지붕으로 들어왔죠. 같은 날 OpenAI 의 Open Responses, Hugging Face 의 OpenEnv, Alibaba 의 OpenSandbox 도 함께 들어와 호스팅 프로젝트가 열 개가 됐어요.

시점사건
2025-10-16Anthropic, Claude 에 Agent Skills 도입
2025-12agentskills.io 에 오픈 표준으로 공개 · AAIF 출범(MCP 기증)
2026-08-17A2A 가 AAIF 호스팅 프로젝트로 편입
2026-10-22Agent Skills 기증 · AAIF 프로젝트 10개로

Anthropic 발표 기준으로 ChatGPT · Cursor · GitHub Copilot · VS Code 등 70개 넘는 플랫폼이 이 형식을 읽고, 공개된 스킬은 100만 개, 설치는 2억 8천만 회에 가깝다고 해요. 유지보수는 Anthropic · Google · OpenAI 엔지니어들이 개인 자격으로 맡아요.

스킬은 폴더 하나예요

SKILL.md 한 장이 든 폴더가 스킬이고, 옆에 스크립트 · 참고 문서 · 템플릿을 둘 수 있어요. 머리말에서 중요한 건 description 이에요. 1,024자 안에 무엇을 하는지와 언제 쓰는지를 같이 적어야 해요. 에이전트가 이 스킬을 꺼낼지 말지를 이 한 줄로 정하거든요.

---
name: expense-report
description: 사내 경비 정산 규정에 따라 영수증을 분류하고 정산서를 만든다.
  경비, 정산, 영수증, 법인카드 내역 처리를 요청받았을 때 사용한다.
license: Proprietary. LICENSE.txt has complete terms
metadata:
  author: finance-ops
  version: "1.2"
---

이렇게 적으면 달라지는 건 로드 순서예요. 규격은 이걸 점진적 공개라고 불러요. 시작할 때는 모든 스킬의 이름과 설명만(약 100토큰) 올리고, 요청이 설명과 맞을 때 본문(5,000토큰 이내 권장)을 읽고, 스크립트와 참고 문서는 그때그때 열어요.

스킬은 한 번에 올라가지 않아요 — 세 번에 나눠 올라가요 ① 시작모든 스킬의 name · description스킬당 약 100토큰 요청이 설명과 맞으면 ② 활성화그 스킬의 SKILL.md 본문만5,000토큰 이내 · 500줄 아래 본문이 가리키면 ③ 실행scripts/ · references/ · assets/필요한 파일만 그때 열어요 같은 절차 2천 자, 어디에 두느냐에 따라 매 호출에 올라가는 양이 달라요 프롬프트에 붙여 넣기 — 경비 정산과 상관없는 호출에도 전부 올라가요 스킬로 두기 — 평소엔 설명 한 줄, 경비 정산 요청에서만 본문 ← 맞는 작업에서만 토큰 수치는 agentskills.io 규격의 권장값이에요. 실제 절감폭은 스킬 개수와 호출 분포에 따라 달라요.

프롬프트에 붙여 넣는 것과 뭐가 다른가요

스킬은 프롬프트를 줄이는 기술이 아니라, 프롬프트를 옮길 수 있게 만드는 형식이에요.

AS-IS 프롬프트에 붙여 넣기TO-BE SKILL.md 폴더
올라가는 시점매 호출, 전부설명이 맞는 작업에서만 본문
도구를 바꾸면다시 붙여 넣기같은 폴더를 70개 넘는 플랫폼이 읽어요
버전 · 작성자누가 언제 고쳤는지 없음git 이력 + metadata 의 author · version
결정적인 작업모델이 매번 생성scripts/ 의 코드가 같은 결과를 내요

MCP 와는 자리가 달라요. MCP 는 에이전트가 무엇에 접근할 수 있는지를 잇는 규약이고, 스킬은 그걸로 어떻게 일하는지를 적는 형식이에요. 도구는 있는데 절차가 없어서 사람한테 매번 되묻는 자리를 스킬이 메워요.

저희가 보는 시사점 — 지식의 단위가 바뀌어요

톺톺 · 떠올라 개발기에서 저희가 쓴 건 구현 코드가 아니라 기준서와 루틴이었어요. 그때는 사내 컨벤션이던 그 문서의 그릇이 이번 기증으로 산업 표준이 됐어요. 사람이 읽는 매뉴얼을 에이전트용으로 옮겨 적는 일, 저희가 Skill Ops 라고 부르는 일의 단위가 폴더 하나로 정해진 거예요.

그래서 무엇을 적느냐가 더 중요해졌어요. 규격은 Helps with PDFs 를 나쁜 설명으로, "PDF 의 텍스트와 표를 뽑는다, 사용자가 PDF · 양식 · 추출을 말할 때 쓴다" 를 좋은 설명으로 들어요. 절차는 본문에, 매번 같은 결과가 나와야 하는 계산 · 변환은 스크립트에 두라는 게 Anthropic 엔지니어링 글의 권고고요.

다만 스킬이 권한을 주는 건 아니에요. 10월 27일 Frontegg 설문(CISO · CSO 300명, 벤더 설문이라 참고만)에선 78% 가 운영 중인 에이전트의 권한을 회수한 적이 있다고 답했어요. 절차는 스킬에, 누가 끄는지는 신원에, 무엇을 실행할 수 있는지는 도구 게이트에 둬야 해요.

바로 믿으면 안 되는 세 가지

  • 100만 · 2억 8천만은 Anthropic 집계예요. 플랫폼마다 세는 기준이 다르고, 설치 수가 품질을 보장하지도 않아요.
  • 공개 레지스트리의 스킬은 코드예요. Snyk 이 올해 2월 ClawHub 와 skills.sh 의 스킬 3,984개를 감사했더니 76개가 자격증명 탈취 · 백도어 · 데이터 유출용이었고, 13.4% 에 치명 등급 문제가 있었어요. Anthropic 도 믿을 수 있는 출처의 스킬만 설치하라고 적어 뒀어요.
  • allowed-tools 는 아직 실험 필드예요. 플랫폼마다 지원이 다를 수 있다고 규격에 적혀 있어요. 버전 릴리스와 제안 절차도 아직 로드맵 제안 단계고요.

이번 주에 해 볼 수 있는 것

프롬프트에 붙어 있는 절차 하나를 골라 폴더로 떼어 내요. description 에 언제 쓰는지를 키워드와 함께 적고, metadata 에 작성자와 버전을 넣어요. 그 폴더는 외부 레지스트리가 아니라 사내 리포에 두고 코드처럼 리뷰해요. 검사는 참조 도구 한 줄이면 돼요.

skills-ref validate ./expense-report

통과하면 머리말이 규격에 맞는다는 뜻이지, 절차가 맞는다는 뜻은 아니에요. 절차의 품질은 결국 골든셋 같은 평가로 재야 해요.

붙여넣기는 폴더로 가고, 폴더는 리뷰를 거쳐요

신입에게 보내던 링크 세 개는 이제 에이전트가 읽는 폴더 하나가 돼요. 어느 도구에서든 읽히는 건 표준이 해 주지만, 안에 적힌 절차가 맞는지와 누가 책임지는지는 여전히 저희 몫이에요. 완성된 매뉴얼이 아니라 계속 고쳐 쓰는 매뉴얼이라는 점만 그대로예요.

자주 묻는 질문

Q. 저희는 Claude 를 안 쓰는데 Agent Skills 가 의미가 있나요? A. ChatGPT · Cursor · GitHub Copilot 등 70개 넘는 플랫폼이 같은 형식을 읽어요. 어느 도구를 쓰든 절차를 한 폴더로 유지할 수 있다는 게 요점이에요.

Q. MCP 서버를 이미 붙였는데 스킬도 따로 필요한가요? A. MCP 는 접근할 도구와 데이터를 잇고, 스킬은 그 도구로 어떤 순서와 규칙으로 일하는지를 적어요. 도구는 있는데 결과가 매번 다르다면 비어 있는 건 스킬 쪽이에요.

Q. 공개 스킬 디렉터리에서 받아 써도 되나요? A. 사내 업무용 스킬은 외부에서 받지 않고 리포에서 만들어 리뷰하는 쪽을 권해요. 스킬은 스크립트를 포함하니 코드 설치와 같은 기준으로 봐야 해요.

Sources