Agent Plugins 1.0, 클라이언트마다 다시 포장하지 않는 최소 패키지 만들기 | DAKER 커뮤니티

같은 Skill과 같은 MCP 서버를 쓰는데도, 클라이언트가 바뀔 때마다 폴더 구조와 매니페스트를 다시 맞추고 있다면 작업의 핵심은 내용보다 포장에 묶여 있는 셈입니다. OpenAI 공식 영상 Introducing Agent Plugins(2026-08-06)가 짚는 문제도 바로 여기입니다.

Agent Plugins 1.0.0은 Skills 사양이나 MCP 사양 자체를 바꾸지 않습니다. 대신 여러 클라이언트에서 옮겨 다닐 수 있는 공통 패키지 형식을 정의해, 같은 구성 요소를 반복 복제하고 이후 드리프트를 감수하는 일을 줄이려는 접근입니다.

Agent Plugins 최소 패키지

한 줄 답: Agent Plugins 1.0.0은 Skills·MCP 사양을 바꾸지 않고, plugin.json + skills/ + 선택적 mcp.json 공통 패키지 형식만 정의합니다. 클라이언트마다 다시 포장하지 않으려면 공식 Build 가이드의 hello-plugin부터 맞추면 됩니다.

왜 지금 Agent Plugins를 볼 만한가

영상에서 강조하는 포인트는 단순합니다. 에이전트의 능력은 이미 있어도, 그것을 어떤 상자에 담아 전달할지가 제각각이면 재사용성이 떨어집니다. ChatGPT·Codex·Cursor·GitHub Copilot·Kiro·VS Code처럼 서로 다른 클라이언트에서 같은 패키지를 쓰려면, 내용보다 포장 규칙을 먼저 맞출 필요가 있습니다.

문제는 스킬 내용이 아니라 포장입니다.

이 점에서 Agent Plugins 1.0.0은 새로운 기능 묶음이라기보다 공통 포맷에 가깝습니다. Skills와 MCP는 그대로 두고, 이식 가능한 패키지 형식만 정의합니다. 상세 절차는 공식 문서 https://agent-plugins.org/를 따르면 됩니다.

영상이 짚는 흐름

OpenAI의 Introducing Agent Plugins 영상은 약 95초 분량으로, 왜 에이전트 패키징 표준이 필요한지부터 Agent Plugins 소개, 패키지 구조와 skills·MCP 서버, 제품 간 이식, 범위와 시작 방법까지 짧게 훑습니다. 빠르게 개념을 잡고 문서로 넘어가기 좋은 구성입니다.

패키지 한 장으로 맞추는 규칙

Agent Plugins의 기본 단위는 디렉터리 하나입니다. 루트에는 plugin.json이 반드시 있어야 하고, skills/ 아래에는 Agent Skills 형식의 하위 디렉터리를 둡니다. 각 스킬은 SKILL.md를 가집니다.

MCP는 루트의 mcp.json에 선언합니다. 여기서 stdio · Streamable HTTP · legacy HTTP+SSE를 명시합니다. 반면 클라이언트 전용 기능은 공통 규칙을 깨지 않도록 com.github.copilot/처럼 역도메인 확장 디렉터리에 둡니다. 다른 클라이언트는 이를 무시합니다.

Agent Plugins 1.0.0은 상자만 공통으로 맞추고, 설치·배포·권한·샌드박스·UX는 각 클라이언트가 맡습니다.

즉 v1의 범위는 분명합니다. 패키지 형식을 표준화하되, 실제 설치 경험이나 권한 처리까지 한 번에 통일하려는 사양은 아닙니다.

언제 플러그인이 꼭 필요한가

Google Developers Blog는 단일 MCP나 단일 스킬만 전달할 때는 플러그인이 필수는 아니라고 설명합니다. Agent Plugins의 가치가 커지는 시점은 함께 움직여야 하는 구성 요소가 있을 때입니다.

예를 들어 특정 스킬과 그 스킬이 기대하는 MCP를 한 상자에 넣고, 여러 클라이언트에 같은 형태로 전달해야 한다면 플러그인 방식이 유리합니다. 반대로 단일 요소만 다룬다면 굳이 패키지 계층을 추가하지 않아도 됩니다.

오늘 바로 만들 수 있는 최소 패키지

가장 간단한 출발점은 공식 Build 가이드의 hello-plugin입니다. 구조는 아래와 같습니다.

hello-plugin/
├── plugin.json
└── skills/
    └── greet/
       └── SKILL.md

plugin.json 예시는 다음과 같습니다.

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

skills/greet/SKILL.md의 골격은 다음과 같습니다.

---
name: greet
description: Greet the user and offer help.
---

Greet the user and offer help.

이 정도만 있어도 유효한 플러그인이 됩니다. 레포에 디렉터리를 만들고, 스키마 URL과 name을 넣은 뒤, 사용하는 클라이언트에서 패키지를 한 번 로드해 greet 스킬이 보이는지 확인하면 됩니다. 이후 팀 표준 스킬이 생기면 같은 skills/ 아래에 추가하고, 도구가 필요해지면 mcp.json을 붙이는 식으로 확장하면 됩니다.

이미 어디까지 채택됐나

GitHub Changelog(2026-08-12)는 VS Code · Copilot CLI · Copilot SDK · Copilot 앱에서 Agent Plugins 1.0이 GA라고 안내합니다. 기존 Copilot 전용 플러그인은 마이그레이션 없이 유지되며, 스펙을 채택할 때는 $schema 추가, skills/·mcp.json의 고정 위치 사용, Copilot 전용 파일을 네임스페이스 디렉터리로 옮기는 작업이 중심입니다.

또한 초기 Technical Steering Committee에는 Amazon · Cursor · Microsoft · OpenAI · Vercel이 Core Maintainer로 참여했고, Google도 2026-08-06에 Core Maintainer로 합류했다고 공개했습니다.

지금 먼저 잡아둘 기준

이 주제는 AGENTS.md 작성, Plan Mode, 개별 스킬 워크플로와는 결이 다릅니다. 여기서 먼저 정리할 것은 여러 클라이언트에 다시 포장하지 않는 패키지 단위입니다.

표준 논의를 길게 보기 전에, 레포에 최소 패키지 한 개를 먼저 두는 편이 더 빠를 수 있습니다.

작게 시작해도 됩니다. plugin.json 하나와 greet 스킬 하나만으로도, 이후 스킬과 MCP를 어디에 어떻게 담을지 기준점이 생깁니다.

출처

여러 클라이언트에서 스킬과 MCP를 함께 써야 한다면, 여러분은 어느 시점부터 패키지 표준의 필요성을 체감하셨나요?