스킬·MCP를 플러그인으로 묶기

스킬 하나를 만들고 나면 마주치는 세 가지 벽

스킬 만드는 법은 익혔습니다. 그 다음에 막히는 자리들입니다

• 벽 ① 나만 씁니다. 내 계정과 내 노트북에만 깔려 있어서, 팀원에게 알려주려면 SKILL.md 본문을 일일이 복사해 붙여넣게 해야 합니다.
• 벽 ② 손발이 없습니다. 스킬은 "어떻게 일할지"를 알지만, DART에서 데이터를 가져오거나 구글 시트에 결과를 쓰는 일은 못 합니다.
• 벽 ③ 흩어져 있습니다. 하나의 시나리오에 스킬 두세 개가 같이 쓰여도, 깔 때는 하나씩 따로 깝니다. 누가 어떤 버전을 갖고 있는지 알기 어렵습니다.

MCP가 뭔가요?

AI에게 "이 도구를 쓸 수 있어"라고 알려주는 통로

스킬이 "이 일은 이렇게 해"라고 알려주는 매뉴얼이라면, MCP(Model Context Protocol)는 "이 도구를 쓸 수 있어"라고 연결해 주는 통로입니다. AI가 DART에서 공시 데이터를 가져오거나, 구글 시트에 표를 쓰거나, 내 PC 폴더의 파일을 읽을 수 있게 만드는 길입니다. Claude Code와 Codex가 같은 규격을 쓰기 때문에, MCP 서버 하나를 만들면 양쪽에 그대로 붙습니다.

플러그인 폴더 구조

매니페스트 한 장에 이름을 적고, 나머지는 묶고 싶은 만큼만 넣습니다

구조는 두 도구가 거의 같습니다. 스킬은 skills/ 하위에 폴더째 넣고, MCP는 루트의 .mcp.json에 적습니다. 매니페스트가 들어가는 숨김 폴더의 이름만 다릅니다.

매니페스트와 .mcp.json, 두 장으로 끝납니다

매니페스트는 이름표, .mcp.json은 같이 붙일 도구 목록입니다

매니페스트에는 이 묶음이 무엇인지만 적습니다. 실제로 붙일 MCP 서버는 루트의 .mcp.json에 따로 적습니다. 두 도구 모두 MCP 표기 형식은 같습니다.

이 플러그인을 깔면 skills/ 안의 스킬 두 개와 DART MCP, 구글 시트 MCP가 한꺼번에 설정됩니다. API 키 같은 비밀은 반드시 ${ENV_VAR} 형태로 적어 설치하는 사람의 환경에서 읽도록 합니다. 파일에 직접 적으면 안 됩니다.

배포 3가지 방법

팀 규모와 공개 범위에 따라 고릅니다

• ① 폴더째 건네기. 사내 공유 드라이브에 올려둡니다. 한두 명 작은 팀이거나 한 번 써 보는 단계일 때만 씁니다. 버전 관리가 안 됩니다.
• ② 사내 마켓플레이스. 비공개 저장소에 카탈로그 파일 한 장을 두고 팀원이 거기서 깝니다. 팀 단위 배포의 표준이고, 버전 관리와 자동 업데이트가 같이 따라옵니다.
• ③ 공개 디렉터리. 외부 공개 자산입니다. 심사를 거쳐 다른 사람도 검색해서 깔 수 있는 형태로 풀립니다.

②가 실질적인 정답입니다. 저장소 하나에 카탈로그를 두면 새 버전을 올리는 일이 커밋 한 번으로 끝납니다. 그 카탈로그를 어디에 두고 어떻게 부르는지가 두 도구의 가장 큰 차이입니다.

받는 사람을 위한 README 5줄

5줄짜리 README가 30분의 설치 안내를 대체합니다

• 한 줄 정의. 이 플러그인이 무엇을 자동화하는지
• 설치 방법. 어느 마켓플레이스에서 어떤 이름으로 까는지 한 줄
• 필요한 환경 변수. API 키 등 사용자가 미리 준비할 것
• 첫 사용 예시. 깐 직후 바로 칠 수 있는 한 마디
• 업데이트 방법. 새 버전을 받는 한 줄

묶음 예시 4가지

스킬과 MCP가 한 묶음으로 만나는 실제 시나리오

한 장 대조표

한쪽 도구로 만든 플러그인을 반대편으로 옮길 때 이 표만 보면 됩니다

플러그인 출시 전 7개 점검

항목을 클릭해서 체크하세요. 7개에 모두 체크가 되면 팀에 뿌릴 준비가 끝난 겁니다