블로그로 돌아가기
Agent Skills가 재단으로 넘어갔다는데 내 SKILL.md는 괜찮을까요? 2026 정리
[TUTORIAL]

Agent Skills가 재단으로 넘어갔다는데 내 SKILL.md는 괜찮을까요? 2026 정리

퀀텀점프클럽 정상록퀀텀점프클럽 정상록18분 읽기4 views
#AAIF#AI 에이전트 스킬 보안#Anthropic#Agent Skills#SKILL.md

무료 자료

PDF · 무료

AI 업무 레시피 카드, 관리권이 협회로 넘어갔어요

긴 글을 다 읽기 전에, 실무 가이드부터 먼저 챙겨가세요.

Agent Skills가 재단으로 넘어갔다는데 내 SKILL.md는 괜찮을까요? 2026 정리

재단으로 넘어갔다는데 내 스킬 파일을 다시 써야 하나요?

결론부터 말씀드리면 지금 쓰는 스킬 파일은 그대로 두셔도 됩니다. Anthropic이 2026-10-22에 발표한 건 Agent Skills 표준의 관리를 리눅스 재단 산하 Agentic AI Foundation(AAIF)으로 옮긴다는 내용이고 파일 형식은 바뀌지 않았어요.

발표를 접한 분들은 이런 질문이 먼저 떠올랐을 거예요. "재단으로 넘어갔다는데 내가 만든 SKILL.md를 다시 써야 하나?" 그 뒤에는 보통 이 질문이 따라옵니다. "스킬이 이렇게 많이 퍼졌다는데 남이 만든 걸 받아 써도 되나?" 둘 다 당연한 걱정이에요.

스킬은 AI 에이전트에게 주는 레시피 카드라고 생각하면 쉽습니다. SKILL.md 한 장에 할 일과 순서를 적고 필요하면 도구와 참고 자료를 붙이는 식이에요. 이번 발표는 이 카드 양식을 만든 회사가 양식 관리권을 요리 협회에 넘긴 일에 가깝습니다. Claude, ChatGPT, Cursor 같은 여러 주방에서 같은 양식이 통하도록 여러 회사가 함께 지키는 구조가 된 거예요.

이 글은 질문 순서대로 답합니다. 무엇을 넘겼고 누가 관리하는지 보고 70개 이상이라는 수치의 출처를 따져본 뒤 한국 실무자가 챙길 호환성과 설치 전 점검 10항목까지 정리했어요.

Anthropic은 정확히 무엇을 재단에 넘겼나요?

Anthropic 발표문에 따르면 2026-10-22 재단에 기증한 대상은 네 가지입니다. 이름과 로고, GitHub 조직, agentskills.io 도메인, 표준 자체예요. 원문은 이렇게 적었습니다.

Anthropic은 정확히 무엇을 재단에 넘겼나요?Anthropic은 정확히 무엇을 재단에 넘겼나요?

이미지 출처: mixed-news.com

"We are donating the Agent Skills name and logo, the GitHub organization, and the agentskills.io domain."

Agent Skills라는 이름과 로고, GitHub 조직, agentskills.io 도메인을 기증한다는 뜻이에요.

재단에 들어가야 쓸 수 있는 건 아닙니다. 같은 글에 "You can continue to use the standard or contribute to it without joining the AAIF."라는 문장이 있어요. AAIF에 가입하지 않아도 표준을 계속 쓰고 기여할 수 있다는 말입니다.

그럼 Anthropic에 남는 건 무엇일까요. 발표문은 남는 범위를 열거하지 않았고 이름과 로고의 상표 사용 조건도 적지 않았어요. 확인된 사실은 두 가지입니다. 2026-10-23 조회 기준으로 Claude 제품의 스킬 기능 문서는 Anthropic 문서 사이트(platform.claude.com)에 그대로 있고 예제 저장소 anthropics/skills도 Anthropic 조직 아래 남아 있습니다. 이건 조회로 확인한 현재 상태이지 기증 범위에 대한 공식 해석은 아닙니다. 저장소와 도메인의 이관 일정도 공개되지 않았어요.

누가 Agent Skills 표준을 관리하게 되나요?

Anthropic 발표문은 유지보수 체제를 이렇게 설명합니다.

누가 Agent Skills 표준을 관리하게 되나요?누가 Agent Skills 표준을 관리하게 되나요?

이미지 출처: aaif.io

"Engineers from Anthropic, Google, OpenAI, and other companies will maintain the standard as individuals, with David Soria Parra and Mahesh Murag as Lead Maintainers."

Anthropic, 구글, OpenAI를 비롯한 여러 회사 엔지니어가 개인 자격으로 표준을 유지보수하고 두 사람이 리드 메인테이너를 맡는다는 말이에요. 그래서 "OpenAI와 구글이 같이 관리한다"는 식의 요약은 절반만 맞습니다. 세 회사 외에 다른 회사도 포함되고 회사 대표가 아니라 개인 자격이라고 원문이 적었거든요.

AAIF 보도자료는 David Soria Parra를 MCP 공동 창시자이자 리드 메인테이너(Anthropic)로 소개했습니다. Mahesh Murag의 소속은 이번에 확인한 1차 출처에 없어요. AAIF 블로그는 여러 회사에서 모인 기술 운영위원회(TSC)가 이끈다고 밝혔지만 위원 명단과 의사결정 규칙은 공개되지 않았습니다.

AAIF 자체는 낯선 곳이 아니에요. 리눅스 재단이 2025-12-09 설립을 발표했고 Anthropic, Block, OpenAI가 공동 설립했습니다. 첫 프로젝트는 MCP, goose, AGENTS.md였고 그사이 A2A, Agent Router, agentgateway가 합류했어요. 2026-10-22에 Agent Skills, Open Responses, OpenEnv, OpenSandbox 4개가 더해져 호스팅 프로젝트는 10개가 됐습니다.

로드맵은 아직 제안 단계예요. Anthropic이 제안한 건 버전별 릴리스, 공식 제안 절차, 스킬을 쓰고 설치하는 사람을 위한 보안 가이드 3가지입니다. 보안 가이드가 나온 게 아니라 제안됐을 뿐이라는 점을 기억해 두세요.

70개 이상 플랫폼과 2억 8천만 회 설치는 믿어도 되는 숫자인가요?

Anthropic 발표문에 따르면 2025-12 표준 공개 이후 ChatGPT, Cursor, GitHub Copilot, VS Code를 포함한 70개 이상 에이전트 플랫폼이 Agent Skills를 붙였고 스킬은 100만 개, 설치는 약 2억 8천만 회에 이릅니다. 발표문에는 집계 출처가 없어요. 출처를 따라가 보니 이렇게 정리됩니다.

수치출처읽는 법
70개 이상 플랫폼Anthropic 발표문목록과 집계 방법이 공개되지 않음
스킬 100만 개AAIF 블로그, Vercel 보고서Vercel이 운영하는 skills.sh 레지스트리 등재 기준
설치 약 2억 8천만 회Vercel 보고서레지스트리 카운터이고 고유 사용자 수가 아님

AAIF 블로그는 같은 날 "a million skills have been listed on the popular skills.sh registry"라고 적었어요. 인기 있는 skills.sh 레지스트리에 스킬 100만 개가 등재됐다는 말입니다.

Vercel이 2026-09-25 낸 보고서는 2026-01 출범부터 2026-08까지 레지스트리가 스킬 100만 개와 설치 약 2억 8천만 회를 기록했다고 밝혔어요. 여기에 "They do not represent unique people or necessarily independent choices."라는 단서를 달았습니다. 고유 사용자 수도 아니고 서로 독립적인 선택의 합도 아니라는 뜻이에요. 같은 보고서에 따르면 레지스트리 스킬의 거의 절반이 딱 한 번만 설치됐고 상위 375개(레지스트리의 0.04%)가 전체 설치의 62%를 차지했습니다. 2억 8천만 회를 "2억 8천만 명이 쓴다"로 읽으면 안 되는 이유예요.

46개와 70개도 헷갈리기 쉬워요. agentskills.io 쇼케이스에는 2026-10-23 조회 기준 46개 제품이 올라 있는데 신청과 검토를 거친 목록이라 70개 이상이라는 주장과 기준이 다릅니다. 두 숫자는 서로 환산하지 않는 게 맞아요. Vercel 집계는 2026-08까지이고 Anthropic 발표는 2026-10-22에 "So far"라고 썼기 때문에 두 시점이 같은지도 확인할 수 없습니다.

지금 쓰는 SKILL.md를 고쳐야 하나요? 한국어 이름은 되나요?

agentskills.io 사양에 따르면 필수 항목은 name과 description 2개뿐이고 사양 저장소의 마지막 변경은 2026-08-09입니다. 이번 기증으로 형식이 바뀌었다는 공지는 없어요. 만들어 둔 SKILL.md는 고칠 필요가 없고 버전 릴리스가 나오면 그때 다시 보면 됩니다. Developers Digest도 "nothing in your SKILL.md files has to change today"라고 판단했어요. SKILL.md 파일에서 당장 바꿀 건 없다는 뜻입니다.

한국어 사용자가 걸리기 쉬운 곳은 이름 규칙이에요.

  • name은 1~64자이고 소문자여야 해요. 하이픈으로 시작하거나 끝날 수 없고 연속 하이픈도 안 되며 폴더 이름과 같아야 합니다. 허용 문자는 문서마다 표현이 달라요. 사양 표와 Claude 문서는 소문자, 숫자, 하이픈만 적었지만 공식 참조 검증기 skills-ref는 "Skill names support i18n characters (Unicode letters)"라고 밝히고 한자와 러시아어 이름 테스트를 통과시킵니다. 한글 name이 모든 도구에서 통한다고 보장할 수는 없으니 영문 소문자, 숫자, 하이픈으로 짓는 게 안전해요.
  • description은 1~1024자이고 언어 제한이 없어서 한국어로 써도 돼요. 에이전트가 관련 작업을 알아보도록 구체적인 키워드를 넣으라고 사양이 권고합니다. 한국어 사용자라면 실제로 입력할 한국어 키워드를 넣어 두면 됩니다.
  • 본문은 5,000토큰, 500줄 미만을 권장해요.
  • 형식 점검은 skills-ref validate ./my-skill 명령으로 할 수 있습니다.

이름은 영문 규칙에 맞추고 설명은 한국어로 쓰는 식이에요. 예시를 하나 들면 이렇습니다.

---
name: weekly-report-writer
description: 주간 보고서 초안을 만든다. 사용자가 "주간 보고", "주간 리포트"를 말할 때 쓴다.
---

설치 위치는 사양이 정하지 않아요. 도구 사이 공유 관례는 프로젝트 .agents/skills/와 사용자 ~/.agents/skills/이고 일부 구현은 호환을 위해 .claude/skills/도 읽습니다. 특정 도구 전용 항목을 다른 도구가 어떻게 처리하는지는 사양에 규정이 없으니 옮길 도구에서 직접 불러 보는 게 확실해요. 라이선스는 사양 코드가 Apache 2.0, 문서가 CC BY 4.0입니다.

AI 에이전트 스킬 보안, 남이 만든 스킬은 얼마나 위험한가요?

Claude 스킬 문서는 "Use Skills only from trusted sources: those you created yourself or obtained from Anthropic."라고 적었어요. 직접 만들었거나 Anthropic에서 받은 스킬만 쓰라는 뜻이고 소프트웨어를 설치하듯 다루라고 덧붙입니다. 외부 URL에서 내용을 가져오는 스킬은 특히 조심하라고 해요.

규모가 커질수록 이 문장이 무거워집니다. Developers Digest는 "a bad skill is now a cross-vendor supply chain problem"이라고 봤어요. 나쁜 스킬이 이제 여러 회사 도구에 걸친 공급망 문제라는 해석입니다. 매체의 해석이라서 사실 근거는 아래 조사들로 봐야 해요.

2026-10-13 arXiv 프리프린트(동료 심사 전)는 마켓 2곳(ClawHub, skillsmp) 등재물 6,309개를 분석해 10개 중 7개꼴로 셸 실행이나 자격증명 접근 같은 높은 권한 능력의 증거가 하나 이상 있다고 보고했습니다. 같은 논문은 frontmatter가 읽히는 6,061개 가운데 권한을 선언한 770개 중 59%가 실제 능력보다 적게 선언했다고 집계했어요. 저자들은 allowed-tools가 접근을 막는 장치가 아니라 확인 질문을 없애는 장치라고 지적했습니다.

안심할 만한 숫자도 있어요. The Agent Forge가 2026-10-19 낸 스캔 리포트(스캐너 운영사의 자체 보고)는 공개 GitHub 저장소 277곳의 SKILL.md 9,930개에서 악성코드를 찾지 못했습니다. 보안 교육, 테스트, 예제 916개를 뺀 일반 스킬 9,014개 중 30개(0.33%)가 고위험 패턴에 걸렸지만 악의 징후는 없었어요. 고칠 습관으로는 내려받은 스크립트를 셸에 바로 연결하는 것(14개 파일)과 키 하나를 얻으려 키 파일 전체를 읽는 것(8개 파일)이 꼽혔습니다. 두 결과가 어긋나 보여도 모집단이 달라요. 앞의 것은 마켓 등재물이고 뒤의 것은 공개 GitHub 저장소이며 ClawHub와 비공개 스킬은 범위 밖입니다.

실제 사고도 있었어요. CSA(클라우드 보안 연합) 연구 노트는 2026-02부터 2026-05까지 OpenClaw의 ClawHub 마켓에서 악성 스킬이 1,184개 넘게 확인됐고 macOS 정보 탈취 악성코드 배포에 쓰였다고 정리했습니다. 2026-06-22 air.security 실험에서는 연구진이 만든 스킬이 에이전트 2만 6천 곳에 닿았는데 공개 스캐너들이 안전 판정을 냈어요. 실험이라 실제 피해는 없었습니다. 교훈은 하나예요. 스킬이 외부 문서 링크를 따라가 지시를 받게 하면 그 링크 내용도 사실상 스킬의 일부인데 스캐너는 묶음 안의 파일만 봅니다.

AI 에이전트 스킬 보안은 설치 수나 별점이 아니라 내가 직접 읽었는지에서 갈려요.

남의 스킬을 설치하기 전에 무엇을 점검하면 되나요?

표준 차원의 보안 가이드는 아직 없어서 공식 문서와 위 조사에서 방어 기준을 뽑아 쓰는 수밖에 없습니다. Claude 엔터프라이즈 문서는 코드 실행, 지시 조작, MCP 서버 참조, 네트워크 접근, 하드코딩 자격증명을 높은 위험으로 분류하고 사양 사이트는 프로젝트 스킬을 신뢰 확인 뒤에만 로드하라고 권고해요. 이 기준을 바탕으로 정리한 10항목을 팀 점검표로 써 보세요.

  1. 출처 확인: 직접 만들었거나 신뢰하는 발행자의 스킬만 써요. 별점, 설치 수, 스캐너 통과는 안전 증거가 아닙니다.
  2. 묶음 전체 읽기: SKILL.md, references, scripts, assets까지 모두 읽어요. HTML 주석과 보이지 않는 문자도 살펴보세요.
  3. 외부 URL 도메인 확인: 공식 도메인과 일치하는지 보고 실행 중에 외부 문서를 받아 그대로 따르게 하는 구조는 따로 표시해 두세요.
  4. 스크립트는 격리 환경에서 먼저 실행: 설명과 실제 동작이 같은지 확인해요. 내려받은 스크립트를 셸에 바로 연결하는 설치 대신 패키지 매니저와 버전 고정을 쓰세요.
  5. 자격증명은 필요한 변수 하나만: .env 전체를 읽거나 키를 직접 적어 둔 스킬은 고쳐 쓰거나 거절합니다.
  6. allowed-tools를 권한 제한으로 믿지 않기: 선언한 내용과 묶음이 실제로 하는 일을 대조하세요.
  7. 위험한 지시 찾기: 권한 확인을 끄라는 지시, AGENTS.md나 CLAUDE.md 같은 상주 파일을 고치라는 지시가 있는지 찾아요.
  8. 버전 고정: 업데이트가 오면 처음 설치할 때처럼 다시 검토합니다.
  9. 프로젝트 스킬은 신뢰 표시한 저장소에서만 로드: 방금 내려받은 저장소의 스킬이 조용히 지시를 끼워 넣는 일을 막아 줘요.
  10. 조직 배포는 작성자와 검토자 분리: Claude 엔터프라이즈 문서는 스킬 작성자가 자기 스킬을 검토하지 않아야 한다고 적었어요.

10항목이 부담스럽다면 1번, 2번, 4번부터 시작하세요. 출처를 보고 전부 읽고 격리해서 돌려 보는 것만으로도 점검의 기본은 갖춰집니다.

마무리

Agent Skills가 재단으로 넘어간 건 파일을 바꾸라는 신호가 아니에요. 여러 회사 도구에서 같은 레시피 카드를 쓰게 됐다는 신호입니다. 카드가 널리 돌수록 받은 카드를 끝까지 읽는 습관의 값어치가 커져요.

먼저 해볼 일은 두 가지입니다. 내 스킬 폴더의 name이 소문자, 숫자, 하이픈 규칙에 맞는지 확인해 보세요. 남이 만든 스킬을 설치할 일이 있다면 위 10항목을 팀 점검표로 복사해 두시면 됩니다. 천천히 검토하셔도 충분해요. 로드맵의 버전 릴리스와 보안 가이드가 정식으로 나오면 그때 다시 비교해 보면 됩니다.

자주 묻는 질문

재단에 가입하지 않으면 Agent Skills를 쓸 수 없나요?

아니요, 쓸 수 있어요. Anthropic 발표문(2026-10-22)은 AAIF에 가입하지 않아도 표준을 계속 쓰고 기여할 수 있다고 밝혔습니다. 사양은 Apache 2.0(코드)과 CC BY 4.0(문서)으로 공개돼 있어요. 회원사 등급이 기술 운영위원회 의석과 이어지는지는 공개된 문서에 없습니다.

스킬 이름을 한글로 지어도 되나요?

문서마다 답이 달라서 name은 영문으로 짓는 게 안전해요. 사양 표와 Claude 문서는 name에 소문자, 숫자, 하이픈만 적었지만 공식 참조 검증기 skills-ref는 한글 같은 유니코드 글자도 통과시킵니다. 도구마다 처리가 다를 수 있으니 name은 영문 소문자, 숫자, 하이픈으로 짓고 폴더 이름과 맞추세요. description은 1~1024자이고 언어 제한이 없어요. 사양은 에이전트가 관련 작업을 알아보도록 구체적인 키워드를 넣으라고 권고하니, 사용자가 실제로 입력할 한국어 키워드를 넣어 두면 됩니다.

설치 수가 많으면 믿고 써도 되는 스킬 아닌가요?

설치 수는 안전 증거가 아닙니다. Vercel 보고서는 설치 약 2억 8천만 회가 레지스트리 카운터 합계이고 고유 사용자 수가 아니라고 밝혔어요. skills.sh 문서도 정기 보안 감사를 하지만 등재된 모든 스킬의 품질과 보안을 보장할 수 없다고 적었습니다. 설치 전 10항목은 설치 수와 상관없이 똑같이 적용하세요.

스킬 폴더를 .claude/skills에서 .agents/skills로 옮겨야 하나요?

꼭 옮길 필요는 없어요. 사양은 스킬 폴더 위치를 정하지 않고 프로젝트 .agents/skills/와 사용자 ~/.agents/skills/를 도구 사이 공유 관례로 소개합니다. 일부 구현은 .claude/skills/도 읽어요. 옮기기 전에 쓰는 도구 문서에서 읽는 위치를 확인하고 그 도구에서 스킬이 실제로 불러와지는지 시험해 보세요.

참고 자료