하나의 SKILL.md로 모든 도구에서: Claude Skills는 Cursor, Windsurf, Gemini CLI에서도 작동합니다

Anthropic이 2025년 10월에 Claude Skills를 출시했을 때, 초기 프레이밍은 명확했습니다: Claude Code에 Skills를 설치하고 Claude와 더 나은 결과를 얻으세요. 이후 일어난 일은 모두를 놀라게 했습니다.

몇 주 안에, 개발자들은 SKILL.md 파일이 Codex CLI에서 작동한다는 것을 발견했습니다. 그 다음 Gemini CLI에서도. Cursor와 Windsurf용 자동 변환 커뮤니티 도구가 등장했습니다. 2026년 초까지 VoltAgent의 awesome-agent-skills 저장소는 SKILL.md를 "Codex, Antigravity, Gemini CLI, Cursor 등과 호환"된다고 설명하며 — 10,000개 이상의 스타를 모았습니다.

Claude Skill 사양은 사실상 AI 에이전트 지침의 오픈 표준이 되었습니다. 실제로 이것이 의미하는 바를 살펴보겠습니다.

SKILL.md가 크로스 플랫폼이 된 이유

SKILL.md 형식은 의도적으로 간단합니다: YAML frontmatter 블록 다음에 일반 Markdown 지침이 옵니다. Claude 전용 API도, 도구별 구문도, 독점 스캐폴딩도 없습니다. 구조화된 텍스트일 뿐입니다.

이 파일을 컨텍스트로 받는 모든 LLM이 지침을 따를 수 있습니다. 유일한 도구별 부분은 파일이 어떻게 로드되는지입니다 — 여기서 에코시스템이 갈라집니다.

도구별: Agent Skills 로딩 방식

1단계: 기본 SKILL.md 지원

Claude Code — 원조. Claude는 세션 시작 시 Skill frontmatter를 스캔합니다(Skill당 ~100 토큰), 관련 있을 때만 전체 지침을 로드합니다.

Codex CLI (OpenAI) — Agent Skills 사양을 직접 지원합니다. Claude Code와 같은 방식으로 Skills를 설치하면 Codex가 자동으로 발견합니다.

Gemini CLI (Google) — 호환 가능한 Skill 디렉토리에서 SKILL.md 파일을 읽습니다.

2단계: 어댑터 필요

Cursor — glob 패턴이 있는 .cursor/rules/*.mdc 파일을 사용합니다.

Windsurf — 매 프롬프트마다 전체적으로 로드되는 단일 .windsurfrules 파일을 사용합니다.

GitHub Copilot — .github/copilot-instructions.md를 사용합니다.

크로스 플랫폼 Skills의 경제학

자주 간과되는 SKILL.md 형식의 장점은 도구 간 토큰 비용 차이입니다.

Claude Code (점진적 공개): 시작 시 Skill당 ~100 토큰, 활성화 시 전체 내용

Windsurf (.windsurfrules, 항상 로드): 매 프롬프트마다 전체 내용, 실용적 한계: 3-5개 규칙

Cursor (.mdc, glob 매칭): 현재 파일 경로에 매칭되는 규칙만

올바른 도구 선택

원하는 것...	사용...
최고의 점진적 로딩	Claude Code
밀접한 IDE 통합	Cursor
단일 설정의 간단함	Windsurf
스크립트 가능한 자동화	Codex CLI 또는 Gemini CLI
크로스 플랫폼 전부	SKILL.md 작성 + agent-skill-creator 사용

도구 간 표준화를 원하는 팀에게 권장 접근 방식은 SKILL.md 형식으로 정식 Skills를 유지하고 각 개발자의 선호 환경에 맞는 자동 변환을 사용하는 것입니다. 한 번 작성하고, 어디서든 실행 — 오픈 Agent Skills 사양의 약속입니다.

---

출처: VoltAgent/awesome-agent-skills · FrancyJGLisboa/agent-skill-creator