에이전트 스킬이란? SKILL.md 하나로 클로드(Claude)·코덱스 함께 쓰기

아직도 클로드에 써 둔 업무 지침을 코덱스와 제미나이 CLI에서 쓰려고, 도구마다 설정 파일을 따로 만들어 같은 내용을 복사해 붙여 넣고 계신가요? 도구가 늘어날수록 지침이 여러 벌로 갈라지고, 한 곳만 고친 탓에 도구마다 결과가 조금씩 달라지기 쉽습니다.

에이전트 스킬(Agent Skills)은 SKILL.md 파일 하나로 AI에게 업무 절차를 가르치는 공개 규격입니다. Anthropic이 2025년 12월에 공개했고, 2026년 10월 22일 리눅스 재단 산하 Agentic AI Foundation(AAIF)에 기증했습니다. 발표 기준으로 ChatGPT, Cursor, GitHub Copilot, VS Code 등 70개가 넘는 에이전트 도구가 이 규격을 지원합니다. 이 글에서는 스킬의 구조와 관리 주체가 바뀐 의미, 한 번 만든 스킬을 여러 도구에서 쓰는 순서, 설명 문구 쓰는 법과 보안 점검표, 다글로로 받아쓴 회의 기록을 스킬의 입력으로 쓰는 흐름을 정리합니다.

에이전트 스킬이란? SKILL.md 하나로 AI에게 업무를 가르치는 규격

에이전트 스킬은 폴더 하나에 SKILL.md와 참고 자료를 담은 업무 설명서입니다. AI는 평소 스킬의 이름과 설명만 알고 있다가, 요청이 설명과 맞을 때 본문을 읽고 그 절차대로 일합니다.

• SKILL.md: 맨 위 머리말(YAML)에 이름(name)과 설명(description)을 쓰고, 아래 본문에 절차를 마크다운으로 씁니다. 이 파일 하나만 있어도 스킬이 됩니다.
• scripts 폴더: AI가 실행할 코드를 둡니다. 계산처럼 매번 같은 결과가 나와야 하는 일은 글보다 코드로 맡기는 편이 정확합니다.
• references 폴더: 양식, 용어집, 긴 설명처럼 필요할 때만 읽을 자료를 둡니다.
• 단계적 로딩: 이름과 설명만 항상 읽히고 본문과 참고 자료는 필요할 때 읽히므로, 스킬을 많이 넣어도 AI가 처음에 읽는 분량은 거의 늘지 않습니다.

클로드(Claude) 코드에서 스킬을 처음 만드는 방법은 클로드 코드 스킬 만드는 법에서 자세히 다뤘습니다. 이 글은 같은 스킬을 여러 도구에서 함께 쓰는 관점에 집중합니다.

리눅스 재단 AAIF로 관리 주체가 옮겨진 의미

관리 주체가 한 회사에서 중립 재단으로 옮겨졌다는 것은, 내가 만든 스킬이 특정 회사의 결정에 덜 흔들린다는 뜻입니다. 규격의 이름·로고, GitHub 조직, agentskills.io 주소가 모두 AAIF로 넘어갔습니다.

같은 날 AAIF는 OpenAI의 Open Responses 등 다른 프로젝트도 함께 받아, 첫해에 10개 프로젝트를 맡게 되었습니다. MCP(AI를 외부 도구에 연결하는 표준)도 AAIF가 관리하는 프로젝트라, 도구 연결은 MCP로, 업무 절차는 스킬로 나눠 쓰는 흐름이 더 분명해졌습니다. ChatGPT 쪽 구성 요소와 비교한 내용은 ChatGPT 플러그인과 MCP·스킬 비교 글에 정리했습니다.

SKILL.md 예시 만들고 여러 도구에서 쓰는 순서

스킬 폴더 하나를 만든 뒤 도구마다 읽는 위치에 두면 됩니다. 아래는 회의 받아쓰기 원문으로 후속 메일 초안을 쓰는 스킬을 예로 든 실습입니다.

1. 폴더 구조 만들기: 스킬 이름과 같은 폴더를 만들고 SKILL.md, 양식, 스크립트를 넣습니다.
2. SKILL.md 쓰기: 이름은 영어 소문자와 하이픈만 쓰고 폴더 이름과 맞춥니다. 설명은 1,024자 이내로 씁니다.
3. 도구별 위치에 두기: 같은 폴더를 각 도구가 읽는 스킬 폴더에 복사하거나 링크합니다.
4. 호출 확인: 도구마다 설명과 맞는 요청을 던져 스킬이 불리는지, 결과가 같은지 비교합니다.

meeting-followup-email/
├── SKILL.md
├── references/email-template.md
└── scripts/extract_actions.py

---
name: meeting-followup-email
description: 회의 받아쓰기 원문을 읽고 참석자에게 보낼 후속 메일 초안을 쓴다. "회의 후속 메일", "회의 끝나고 메일 써 줘" 요청에 사용한다.
---
1. 원문에서 결정 사항, 할 일과 담당자, 다음 일정을 찾는다.
2. references/email-template.md 양식에 맞춰 메일 초안을 쓴다.
3. 원문에 없는 내용은 쓰지 않고 [확인 필요]로 표시한다.
4. 메일은 보내지 않고 초안만 보여 준다.

원본은 한 곳(예: .agents/skills)에만 두고 다른 도구의 폴더는 그곳을 가리키는 링크로 만들면, 한 번 고친 내용이 모든 도구에 똑같이 반영됩니다. 지원 도구 목록과 읽는 위치는 자주 바뀌므로 agentskills.io의 도구 목록과 각 도구 공식 문서로 확인하세요. 여러 스킬을 묶어 팀에 나눠 주는 방법은 클로드 코드 플러그인 글을 참고하세요.

잘 불리는 설명 문구 쓰는 법과 보안 점검표

AI는 설명 문구만 보고 스킬을 부를지 정하므로, 설명에는 무엇을 하는지와 어떤 요청에 쓰는지를 함께 씁니다. 다른 사람이 만든 스킬은 설치 전에 폴더 안의 파일을 직접 읽어 봅니다.

설명 문구 쓰는 법

• 첫 문장에 하는 일: "회의 받아쓰기 원문으로 후속 메일 초안을 쓴다"처럼 결과물을 분명히 씁니다.
• 사용자가 실제로 하는 말: "회의 끝나고 메일 써 줘"처럼 요청 표현을 넣으면 자동 호출이 잘 됩니다.
• 비슷한 스킬과의 경계: "회의록 전체 정리는 meeting-summary를 쓴다"처럼 쓰지 않을 상황도 적습니다.

보안 점검표

• scripts 폴더의 코드가 무엇을 실행하는지, 외부 주소로 데이터를 보내지 않는지 확인합니다.
• 본문에 "이전 지시를 무시하라" 같은 숨은 지시가 없는지 읽어 봅니다.
• 메일 발송·삭제·배포처럼 되돌리기 어려운 일은 초안까지만 하게 하고 사람이 확인한 뒤 실행합니다.
• 비밀번호·API 키·고객 정보를 SKILL.md나 참고 자료에 적지 않습니다.
• 출처가 분명한 저장소의 스킬만 쓰고, 업데이트되면 바뀐 부분을 다시 읽습니다.

숨은 지시로 AI를 조종하는 공격은 프롬프트 인젝션 대응 글에서 자세히 다뤘습니다.

다글로 회의 기록을 '회의록→후속 메일' 스킬의 입력으로 쓰기

스킬은 형식이 일정한 입력을 받을 때 가장 안정적으로 작동합니다. 회의를 다글로로 받아쓰면 누가 말했는지 구분된 원문과 요약이 남아, 후속 메일 스킬이 바로 읽을 수 있는 자료가 됩니다.

• 녹음하고 받아쓰기: 회의를 다글로로 녹음하거나 녹음 파일을 올리면 받아쓴 내용과 요약이 함께 만들어집니다.
• 이름이 붙은 원문: 다글로의 보이스매칭은 회의 참석자의 목소리를 기억해 다음 녹음부터 '참석자 1' 대신 실제 이름을 자동으로 넣어 줍니다. 모든 사용자에게 이 기능을 제공하는 것은 국내 최초입니다. 이름이 붙어 있으니 스킬이 할 일마다 담당자를 정확히 적습니다.
• 스킬에 넘기기: 받아쓴 내용을 텍스트로 내보내 작업 폴더에 두고 "이 회의로 후속 메일 써 줘"라고 요청하면, 어느 도구에서든 같은 양식의 메일 초안이 나옵니다.
• 원문과 대조하기: 보드챗에 "결정 사항과 담당자만 다시 정리해 줘"라고 물어 메일 초안과 비교하면 빠진 내용을 바로 찾을 수 있습니다.

회의마다 같은 형식으로 요약받고 싶다면 그 요약 지시를 다글로 '내 템플릿'에 저장해 두세요. 다글로가 프롬프트를 기억하고 녹음이 끝날 때마다 그 형식으로 자동 요약하므로, 스킬에 넘기는 입력도 항상 같은 모양이 됩니다.

정리하면, 에이전트 스킬은 SKILL.md 하나로 여러 AI 도구에 같은 업무 방식을 가르치는 공통 규격이고, 리눅스 재단 이관으로 특정 도구에 묶이지 않는 기반이 생겼습니다. 원본 스킬 하나를 만들어 도구마다 연결하고, 설명 문구와 보안 점검표로 다듬어 보세요. 지원 도구와 세부 규칙은 바뀔 수 있으니 시작 전에 agentskills.io를 한 번 더 확인하세요.

#에이전트스킬 #AgentSkills #SKILLmd #클로드코드 #코덱스 #리눅스재단 #AI업무자동화 #다글로

👉 회의 녹음 무료로 받아쓰기 시작하기