AI에 작업법을 가르치는 파일 'SKILL.md', 주요 5개 코딩 도구가 공용 채택

한 번 만든 스킬이 다섯 도구에서 그대로 돌아간다

SKILL.md는 AI에게 특정 작업의 절차·맥락·예시를 알려주는 마크다운 문서 한 장이다. 이 파일 포맷이 주요 AI 코딩 도구 5종 — Claude Code, OpenAI Codex, Cursor, Gemini, GitHub Copilot — 에서 공통 표준으로 채택됐다. 작년만 해도 각자 자기 포맷으로 갈라져 있었다.

한 파일 = 다섯 도구

SKILL.md는 AI에게 특정 작업을 시킬 때 따라야 할 절차·맥락·예시를 마크다운 한 파일에 담는 포맷이다. Anthropic이 Claude Code용으로 먼저 정의했고, 다른 회사들이 같은 구조를 채택하면서 사실상 공용 규격이 됐다.

이로 인해 한 번 작성한 스킬을 어떤 도구에서도 그대로 쓸 수 있다. 회사 사내 코드 컨벤션, 배포 절차, 디버깅 워크플로우 같은 자산이 도구 갈아탈 때마다 사라지지 않는다. Agent Skills라는 이름의 오픈 표준이 그 뒤를 받친다.

왜 다들 같은 포맷을 쓸까

첫째, 사용자가 스킬을 옮길 수 없으면 도구 자체가 안 팔린다. 사내에 100개 스킬이 쌓인 팀은 그걸 못 가져가는 도구로 못 옮긴다. 호환을 막는 게 오히려 채택을 막는 시대다.

둘째, 마크다운이라는 가장 단순한 포맷을 쓴 게 결정적이다. JSON 스키마나 회사별 DSL이 아니라 사람이 그냥 읽고 쓰는 글이다. 진입 장벽이 0에 가까우니 표준이 빠르게 굳었다.

누구한테 어떤 신호인가

• 일반인 — 회사가 어떤 AI 도구를 쓰든 같은 스킬 자료가 통한다, 도구 교체 부담이 사라진다
• 개발자/실무자 — 한 번 잘 만든 SKILL.md가 평생 자산이 된다, 도구 종속에서 자유
• 학습자 — SKILL.md 작성법은 이제 도구별이 아니라 보편 기술이다, 배우면 어디서나 쓴다

마크다운의 승리

가장 단순한 포맷이 표준 전쟁에서 이긴다.

🔧 기술 내용 알아보기

• SKILL.md: AI에게 특정 작업을 수행하는 방법·절차·예시를 마크다운으로 정리한 파일. 도구가 자동으로 인식해 작업 시 참조
• Agent Skills: SKILL.md 포맷을 중심으로 한 오픈 스킬 표준. 도구 간 호환을 보장하는 규약
• Claude Code / Codex CLI / Cursor / Gemini CLI / Copilot: 각각 Anthropic·OpenAI·Anysphere·Google·GitHub의 대표 AI 코딩 도구
• DSL (Domain Specific Language): 특정 목적에 맞게 만든 전용 언어. 회사별 DSL은 진입 장벽을 높여 표준화에 불리