Agent Skills의 Agentic AI Foundation 이전: 코딩 에이전트 운영 팀에 생기는 변화

2026년 10월 22일 새너제이에서 열린 AGNTCon + MCPCon North America에서 Agentic AI Foundation이 4개의 신규 프로젝트를 발표했습니다. 코딩 에이전트를 운영하는 모든 팀에 직접적인 영향을 미치는 프로젝트는 바로 Anthropic이 기여한 SKILL.md 포맷 기반의 Agent Skills입니다. 나머지 세 프로젝트는 OpenAI의 Open Responses, Hugging Face의 OpenEnv, Alibaba의 OpenSandbox입니다. Linux Foundation 산하에 있는 이 재단은 현재 MCP, A2A, AGENTS.md, goose를 포함해 총 10개의 프로젝트를 호스팅하고 있습니다.

Anthropic의 기증 관련 게시글에는 이전된 항목들이 명시되어 있습니다. Agent Skills라는 이름과 로고, GitHub 조직, agentskills.io 도메인, 그리고 표준 자체입니다. 또한 Anthropic이 자체 집계한 도입 현황도 함께 공개되었는데, 2025년 12월 표준이 발표된 이래 70개 이상의 에이전트 플랫폼이 Agent Skills를 통합했으며, "100만 개의 스킬이 게시되었고 약 2억 8,000만 회 설치되었다"고 합니다.

단순한 거버넌스 관련 소식처럼 보일 수 있고 실제로도 대체로 그렇지만, 특정 작업에는 Claude Code를, 다른 작업에는 Codex를 사용하는 이들에게 중요한 실질적 문제를 해결해 줍니다. 바로 "스킬이 특정 벤더의 전유물인가, 아니면 표준화할 수 있는 포맷인가?"라는 질문입니다. 이제 스킬은 중립적인 소유 주체를 갖춘 포맷이 되었습니다.

핵심 요약 (TL;DR)

Agent Skills는 이제 Agentic AI Foundation 산하의 벤더 중립적 프로젝트가 되었으며, Anthropic, Google, OpenAI 등 여러 기업의 엔지니어들이 개인 자격으로 유지 관리합니다. 10월 22일 이후에도 파일 포맷 자체는 전혀 바뀌지 않았습니다. 기존 SKILL.md 파일은 그대로 작동하며, 이를 로드하는 제품들도 이전과 동일한 위치에서 파일을 읽어옵니다. 달라진 점은 다음 버전을 누가 결정하느냐입니다. 개발팀 입장에서 가장 실용적인 접근법은 스펙에 명시된 6개 필드만 사용해 스킬을 작성하고, 저장소당 하나의 복사본만 유지하여 각 에이전트가 이를 찾아 로드하도록 구성하는 것입니다.

한 단락으로 살펴보는 Agent Skills

스킬이란 SKILL.md 파일을 포함하는 디렉터리입니다. 최소한 name과 description이 포함된 YAML 프론트매터와 그 뒤를 잇는 Markdown 지침으로 구성됩니다. 아울러 scripts/, references/, assets/ 디렉터리를 함께 포함할 수도 있습니다. 공식 사양은 10분이면 다 읽을 수 있을 만큼 간결합니다.

스킬은 점진적 공개(progressive disclosure) 방식을 통해 비용을 낮게 유지합니다. 에이전트는 시작 시 각 스킬의 이름과 설명만 로드하며(사양에 따르면 각각 약 100토큰 수준), 작업이 스킬과 일치할 때만 SKILL.md 본문 전체를 읽고, 지침에서 직접 참조할 때만 번들로 포함된 파일을 엽니다.

더 자세한 설명과 공개된 소스에서 가져온 스킬을 검증하는 방법은 코딩 에이전트 스킬이란 무엇인가를 참고하세요.

이번 이전으로 달라지는 점과 달라지지 않는 점

달라지는 점은 세 가지입니다. 첫째, 브랜드와 인프라의 소유권입니다. 이름, 도메인, GitHub 조직이 더 이상 해당 포맷을 사용하는 경쟁 제품들의 특정 벤더에 종속되지 않습니다. 둘째, 의사결정 참여자입니다. 이제 Anthropic, Google, OpenAI의 엔지니어들이 각 사 제품이 이미 채택한 단일 포맷을 함께 유지 관리합니다. 셋째, 공식 프로세스가 도입될 예정이며, 여기에 참여하기 위해 재단에 가입할 필요는 없습니다.

달라지지 않는 점도 세 가지가 있으며, 이는 여러분의 저장소에 직접 영향을 미치는 요소들입니다. 포맷은 10월 21일과 동일합니다. 사양에는 여전히 스킬이 어디에 위치해야 하는지 명시되어 있지 않으며, 스킬 디렉터리 내부에 무엇이 들어가는지만 정의하고 어떤 디렉터리를 탐색할지는 각 제품이 결정합니다. 또한 제품별 확장 기능은 그대로 유지되므로, 한 에이전트가 인식하는 필드를 다른 에이전트는 무시하거나 거부할 수 있습니다.

이번 변화가 얼마나 최근에 일어났는지를 보여주는 사례가 있습니다. 10월 26일 기준으로도 저장소의 기여 가이드에는 로고 사용 요청이 "Anthropic 팀에 의해 검토된다"고 여전히 적혀 있었고, 사양 페이지에는 버전 번호가 없었습니다. 버전별 릴리스는 제안된 로드맵에만 있을 뿐 아직 공식 출시되지 않았습니다. 따라서 실질적으로는 안정적인 사양으로 보되, 문서상으로는 아직 명시적 버전이 지정되지 않은 상태로 여기는 것이 좋습니다.

스킬을 한 번만 작성하여 여러 에이전트에서 불러오기

다음은 공식 사양에 정확히 부합하는 최소한의 스킬 예시입니다. name은 영문 소문자, 숫자, 하이픈으로 구성되며 최대 64자이고 폴더 이름과 일치합니다. description은 1,024자 제한 내에서 스킬이 수행하는 작업과 사용 시점을 설명합니다. 그 외의 모든 필드는 선택 사항입니다.

.agents/skills/migration-review/
├── SKILL.md
└── references/
    └── CHECKLIST.md

---
name: migration-review
description: Reviews a database migration before it merges. Checks reversibility, locking on large tables, and data backfills. Use when a diff adds or changes files under migrations/ or the user asks for a migration review.
license: Apache-2.0
metadata:
  owner: platform-team
  version: "1.2"
---

# Migration review

1. List every migration file in the diff.
2. For each one, confirm a down migration exists, or state why it cannot.
3. Flag any ALTER TABLE on a table listed in references/CHECKLIST.md as large.
4. Flag backfills that run inside the migration instead of a separate job.
5. Report one line per file: PASS, or FAIL with the reason.

Do not edit the migration. Report only.

사양에서 metadata를 문자열 키와 문자열 값의 맵으로 정의하고 있으므로 metadata 값은 따옴표로 감싼 문자열이어야 합니다. 참조 파일은 사양 권장 사항에 따라 SKILL.md의 한 단계 아래 하위 디렉터리에 위치합니다. 다른 사람이 의존하기 전에 다음과 같이 참조 검증기(reference validator)로 확인해 보세요.

skills-ref validate ./.agents/skills/migration-review

이제 재단이 해결해주지 못하는 부분인 탐색 경로를 살펴보겠습니다. Codex의 스킬 문서에서는 저장소 내 .agents/skills와 사용자 홈 디렉터리의 $HOME/.agents/skills를 지정합니다. 반면 Claude Code의 문서에는 프로젝트용으로 .claude/skills/<skill-name>/SKILL.md, 개인용으로 ~/.claude/skills/가 명시되어 있습니다. 다행히 두 도구 모두 심볼릭 링크로 연결된 스킬 폴더를 인식합니다. 따라서 사양의 클라이언트 구현 가이드에서 탐색 경로로 권장하는 범용 클라이언트 규칙에 따라 .agents/skills에 원본을 하나만 유지하고, Claude Code를 위해 심볼릭 링크를 걸어주면 됩니다.

mkdir -p .claude/skills
ln -s ../../.agents/skills/migration-review .claude/skills/migration-review
git add .agents/skills .claude/skills

이렇게 하면 하나의 폴더에서 한 번만 리뷰하고 한 곳에서만 업데이트하면 됩니다. .agents/skills를 직접 탐색하는 제품은 링크를 걸 필요가 없으므로 각 제품의 문서를 확인하시기 바랍니다.

스킬의 이식성을 유지하기 위한 세 가지 규칙은 다음과 같습니다.

• 공유 복사본에서는 사양에 정의된 6개 필드만 사용하세요(name, description, license, compatibility, metadata, allowed-tools). Claude Code 문서에 따르면 Claude Code 자체는 context: fork와 같은 확장을 허용하지만, claude.ai 업로드 및 Skills API는 다른 키가 포함되어 있으면 오류를 발생시키며 거부합니다.
• allowed-tools는 힌트로만 취급하세요. 사양에서는 이 필드를 실험 단계로 표시하고 있으며, 에이전트마다 지원 수준이 다릅니다.
• 제품별 전용 설정은 공유 프론트매터에서 제외하세요. 예를 들어 Codex는 스킬 폴더 내부의 agents/openai.yaml 파일에서 선택적 UI 및 호출 설정을 읽어오며, 다른 에이전트는 이를 무시합니다.

둘 이상의 에이전트 또는 여러 사람이 동일한 저장소를 다룰 때는 공유 포맷으로 표준화하세요. 반면 단일 개발자가 단일 에이전트만 사용할 때는 복잡한 절차를 생략해도 괜찮습니다. 해당 에이전트의 전용 디렉터리에 개인 스킬을 두고 사용하다가, 두 번째 에이전트를 도입할 때 이식성을 챙겨도 늦지 않습니다.

신뢰성 검증 문제는 재단이 대신 해결해주지 않는다

포맷에 중립적인 소유 주체가 생겼다고 해서 스킬의 안전성이 저절로 보장되는 것은 아닙니다. 클라이언트 구현 가이드에서도 언급하듯, 프로젝트 수준의 스킬은 현재 작업 중인 저장소에서 가져오게 되며, 이는 제어할 수 없는 외부 저장소를 방금 클론한 것일 수도 있습니다. 따라서 에이전트가 이러한 스킬을 신뢰성 검증을 거친 후 로드하도록 권장합니다. Anthropic이 제안한 로드맵에는 스킬을 작성하고 설치하는 이들을 위한 보안 가이드라인이 포함되어 있으나, 이는 아직 완성된 형태의 가이드라인이 존재하지 않는다는 뜻이기도 합니다.

가이드라인이 확정되기 전까지는 스킬을 일반적인 외부 의존성(dependency)처럼 철저히 검토해야 합니다. 에이전트가 실행하기 전에 SKILL.md와 모든 스크립트를 꼼꼼히 확인하고, 명령어에는 최소 권한만 부여하며, 비밀 정보가 노출되지 않도록 하세요. Anthropic 집계 기준 100만 개의 스킬이 공개된 지금, 병목은 스킬의 공급량이 아니라 바로 철저한 리뷰입니다.

Sharkly의 역할

표준화된 포맷은 "이 파일이 내 에이전트에서 로드될 것인가"에 대한 답만 제공할 뿐입니다. 어떤 에이전트가 어떤 스킬을 보유하는지, 누가 스킬을 수정할 수 있는지, 실행 결과는 어디로 전달되는지에 대해서는 답해주지 않습니다. 이러한 관리 문제는 에이전트를 추가할 때마다 기하급수적으로 늘어납니다.

Sharkly에서 스킬은 Skills 문서에 명시된 대로 SKILL.md를 진입점으로 사용하며, YAML 형식의 name과 description 뒤에 지침이 따릅니다. 사용자는 SKILL.md, .skill 파일, zip 압축 파일 또는 폴더를 업로드하거나, 지원되는 공개 URL에서 가져오거나, Computer의 Runtime이 이미 감지한 스킬을 가져올 수 있습니다. 가져온 스킬은 관리형 사본이 되므로 문서에서는 바인딩하기 전에 이를 검토하도록 안내합니다. 모든 스킬은 생성 시 고정되는 하나의 범위(Scope: Organization, Space, Agent 중 하나)를 가지며, 수정 권한은 작성자 및 Organization 소유자나 관리자로 제한됩니다. 각 진행 경로는 Sharkly Skills에서 자세히 다룹니다.

바인딩은 Agent에서 이루어지며, Agent에서 원하는 Runtime을 선택하게 됩니다. Crews 문서에 따르면 Crew는 "단일 리더 Agent가 조율하는 사용자와 Agent로 구성된 재사용 가능한 그룹"이며, 각 Agent 멤버는 자체 설정을 유지합니다. 따라서 리더는 Claude Code로 실행되고 리뷰어는 Codex로 실행되는 Crew에서도 동일한 Space Skill을 바인딩할 수 있으며, 각 멤버의 실행 결과는 동일한 Task로 반환됩니다. Agent가 조사, 실행, 테스트 및 보고를 수행하면, 사용자는 어떤 스킬에 팀 권한을 부여할지 결정하고 최종 결과를 승인합니다.

저장소별로 폴더 하나와 심볼릭 링크를 사용해 수동으로 스킬 동기화를 유지할 수도 있고, 팀 규모가 커짐에 따라 Sharkly를 도입해 어떤 Agent가 어떤 스킬을 갖출지 관리할 수도 있습니다. 두 에이전트를 함께 실행하는 방법에 대한 자세한 내용은 워크트리(worktree) 측면을 다룬 단일 코드베이스에서 Claude Code와 Codex 함께 사용하기를 참고하세요.

자주 묻는 질문 (FAQ)

Agent Skills가 Agentic AI Foundation으로 이전되면서 포맷이 변경되었나요? 아닙니다. 이번 발표로 이름, 로고, GitHub 조직, 도메인, 표준이 재단으로 이전되었을 뿐입니다. agentskills.io의 사양 파일은 그대로 유지되며, 기존 SKILL.md 스킬도 변함없이 작동합니다.

현재 Agent Skills의 유지 관리는 누가 맡고 있나요? Anthropic 게시글에 따르면 Anthropic, Google, OpenAI 및 기타 기업의 엔지니어들이 개인 자격으로 유지 관리하고 있으며, David Soria Parra와 Mahesh Murag가 리드 메인테이너를 맡고 있습니다. Anthropic은 버전별 릴리스와 공식 제안 절차를 제안한 상태이지만, 아직 공식 도입되지는 않았습니다.

어떤 에이전트가 Agent Skills를 지원하나요? Anthropic에 따르면 ChatGPT, Cursor, GitHub Copilot, VS Code 등을 포함해 70개 이상의 플랫폼이 지원합니다. agentskills.io의 클라이언트 쇼케이스에는 Claude Code, Codex, Gemini CLI, OpenCode, Goose, OpenHands 등의 제품이 등재되어 있습니다. 스킬을 불러오는 디렉터리는 제품마다 다르므로 각 제품의 문서를 확인하시기 바랍니다.

스킬을 작성하거나 표준에 기여하려면 재단에 가입해야 하나요? 아닙니다. Anthropic의 게시글에 따르면 재단에 가입하지 않아도 표준을 사용하거나 기여할 수 있으며, 사양에 대한 피드백은 프로젝트 공식 Discord를 통해 제출할 수 있습니다.

Claude Code용으로 작성된 스킬이 Codex에서도 작동하나요? 프론트매터에 사양에 정의된 6개 필드만 사용하고 Codex가 스킬을 탐색하는 위치에 배치되어 있다면, 포맷 측면에서는 문제없이 작동합니다. 다만 context: fork와 같은 Claude Code 전용 확장 기능은 지원되지 않으므로 공유 복사본에서는 제외해야 합니다. 스킬 이전은 에이전트 전환 과정의 일부일 뿐이며, 나머지 내용은 코딩 에이전트 간 전환 시 컨텍스트를 유지하는 방법에서 다룹니다.