스킬 한 번 만들어 6개 클라이언트에, Agent Plugins 1.0에서 빠진 Anthropic

코딩 에이전트에 나만의 작업 절차를 가르치고 싶으면 스킬을 만듭니다. 폴더 하나에 SKILL.md를 넣고 "PR 올릴 때는 이런 순서로 검토해라" 같은 지시를 적어두는 방식입니다. 외부 도구나 사내 데이터베이스에 연결해야 하면 MCP 서버를 붙입니다. 여기까지는 이미 공용 규격이 있어서 어느 도구에서든 통합니다.

문제는 그 둘을 한 묶음으로 배포할 때 생겼습니다. Claude Code는 매니페스트를 .claude-plugin/plugin.json에 두고 MCP 설정을 .mcp.json으로 읽습니다. VS Code, Cursor, Kiro는 각자 다른 자리에서 다른 이름을 찾습니다. 그래서 같은 스킬 묶음을 도구 수만큼 다시 포장해야 했습니다. AWS 오픈소스 블로그는 이 상황을 "한 클라이언트에 맞춰 만들고, 다른 클라이언트용으로 다시 작성"하는 일이라고 적었습니다.

8월 6일 Agent Plugins 1.0.0이 공개됐습니다. OpenAI, Microsoft, AWS, Cursor를 만드는 Anysphere, GitHub, Vercel이 함께 냈고, Google은 같은 날 Core Maintainer 합류를 발표했습니다. 이 규격은 디렉터리 배치와 파일 이름만 통일합니다. 하는 일이 그게 전부입니다.

플러그인은 그냥 디렉터리 하나입니다

규격 전체가 파일 세 개로 끝납니다.

my-plugin/
├── plugin.json          # 필수. 이름과 규격 버전
├── skills/              # 선택. skills/{이름}/SKILL.md
│   └── code-review/
│       └── SKILL.md
├── mcp.json             # 선택. MCP 서버 선언
└── com.example.client/  # 선택. 특정 클라이언트 전용 영역

plugin.json에서 반드시 있어야 하는 필드는 두 개뿐입니다.

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "hello-plugin"
}

나머지 version, description, author, license, keywords는 선택입니다. 대신 루트는 닫힌 스키마라서 사양에 없는 키를 넣으면 검증에 걸립니다. 벤더가 자기 필드를 마음대로 늘려 규격을 갈라놓는 일을 막는 장치입니다. 클라이언트 고유 데이터가 필요하면 com.example.client 같은 역방향 도메인 영역에 넣고, 그 영역을 모르는 클라이언트는 내용을 검증하지 말고 무시해야 합니다.

스킬 탐색 범위도 좁게 못 박았습니다. skills/ 바로 아래 하위 디렉터리에 SKILL.md가 있으면 스킬 하나로 칩니다. 사양은 클라이언트가 그보다 더 깊은 경로를 재귀 탐색해서는 안 된다고 규정합니다. 스킬 하나가 잘못돼 있어도 건너뛰고 나머지는 계속 읽습니다. 한 컴포넌트에서 난 실패가 다른 독립 컴포넌트의 로딩을 막아서는 안 된다는 복원력 원칙이 따로 명시돼 있습니다.

mcp.json은 stdio, streamable-http, 레거시 sse 세 가지 연결 방식을 담습니다. 클라이언트는 앞의 둘 중 최소 하나를 지원해야 하고 sse는 선택입니다. 로컬 프로세스를 띄우는 경우 클라이언트가 PLUGIN_ROOT(플러그인 절대경로)와 PLUGIN_DATA(클라이언트가 관리하는 영속 데이터 경로) 두 환경변수를 반드시 넘겨줘야 하고, ${PLUGIN_ROOT} 치환은 args, env 값, cwd에만 한 번씩 적용됩니다. command는 셸 파싱 없이 단일 토큰으로 취급합니다.

재료 두 개 모두 Anthropic이 만들었습니다

Agent Plugins가 새로 만든 부분은 포장지뿐입니다. 안에 담기는 두 규격은 원래 있던 것을 그대로 씁니다.

• MCP: Anthropic이 2024년 11월 공개한 도구 연결 규격
• Agent Skills: Anthropic이 만든 SKILL.md 기반 스킬 규격

그런데 창립 멤버 명단에도, 기술운영위원회에도 Anthropic은 없습니다. 초기 Core Maintainer는 Amazon, Cursor, Microsoft, OpenAI, Vercel이고 여기에 Google이 더해졌습니다. 스펙 대표 작성자는 Vercel의 Jonathan Hefner이고, Google 쪽 대표는 DeepMind의 Kevin Hou입니다. The Decoder는 8월 7일 기사에서 Anthropic이 두 표준을 모두 만들었으면서도 이 작업에 참여하지 않았고, 대신 자사 데스크톱 도구 Cowork에 자체 플러그인 시스템을 붙였다고 정리했습니다.

거버넌스 문서를 보면 이 명단이 우연이 아니라 설계입니다. 어느 벤더도 Core Maintainer 과반을 가질 수 없고, 모든 직위는 회사가 아니라 개인이 보유하며, 이름·로고·도메인·GitHub 조직은 위원회가 지정한 중립 주체가 신탁으로 보유합니다. 스펙은 CC-BY-4.0, 코드는 Apache 2.0입니다. 한 회사가 규격을 만들고 나머지가 따라 쓰는 구조를 처음부터 피한 배치입니다. MCP 사양이 단독 개정으로 무상태 전환을 강제했던 일을 겪은 쪽이라면 이유를 짐작할 수 있습니다.

훅과 서브에이전트는 옮겨가지 않습니다

사양은 비목표를 명시적으로 적어뒀습니다. 커맨드, 훅, 서브에이전트, LSP 서버는 클라이언트별 성격이 강하다는 이유로 v1에서 제외했고, 레지스트리 기반 배포, OAuth와 자격증명 저장, 서브프로세스 샌드박싱도 뺐습니다. The Decoder의 요약대로 이 규격은 포장과 발견만 다루고 마켓플레이스, 권한, 런타임 환경은 건드리지 않습니다.

Google 블로그는 이 선긋기를 이렇게 설명했습니다. "포장은 하나의 일이고, 플러그인을 발견해 사용자에게 전달하는 것은 다른 일입니다."

Claude Code 플러그인과 나란히 놓으면 이식되는 것과 안 되는 것이 뚜렷하게 갈립니다.

스킬 디렉터리 규칙은 이미 글자 하나까지 같습니다. 매니페스트 위치와 mcp.json 앞의 점 하나만 옮기면 Claude Code 플러그인의 절반은 그대로 Agent Plugins가 됩니다. 반대로 훅으로 도구 호출을 막거나 서브에이전트로 작업을 나눠 놓은 플러그인이라면 옮겨갈 자리가 아예 없습니다. 팀 규칙을 훅에 심어둔 조직일수록 이식 가능한 비율이 낮아집니다.

지금 쓸 수 있나

규격은 공개돼 있고 지역 제한이 없습니다. 대기자 명단, 신청, 승인 절차도 없습니다. 필요한 것은 이 형식을 읽을 줄 아는 클라이언트뿐입니다.

AWS는 자사 Agent Toolkit에 여러 플러그인에 걸쳐 30개가 넘는 스킬을 큐레이션해 두고 Agent Plugins 호환으로 열었습니다. Google의 Data Agent Kit은 BigQuery, Spanner, Cloud SQL 연동 플러그인을 제공합니다. 만드는 쪽이 아니라 쓰는 쪽이라면 지금 설치할 수 있는 플러그인은 대부분 이 두 곳에서 나옵니다.

이미 Claude Code용 스킬이나 플러그인을 만들어 둔 팀이라면 skills/ 폴더는 손대지 말고 매니페스트를 루트 plugin.json으로, .mcp.json을 mcp.json으로 복사한 사본을 만들어 Cursor나 VS Code에서 열어 보면 됩니다. 30분이면 우리 플러그인의 어느 부분이 이식되고 어느 부분이 훅·서브에이전트에 묶여 남는지 목록이 나옵니다. 그 목록을 보면 이 규격이 우리 팀에 쓸모 있는지 판단이 섭니다.