SKILL.md 파일은 AI 에이전트에게 특정 작업을 수행하는 방법을 알려주는 짧은 YAML 헤더가 포함된 마크다운 파일입니다. 이 파일은 스크립트, 참조 문서, 템플릿과 함께 폴더에 저장되며, 에이전트는 작업에 필요할 때만 이 파일을 로드합니다. SKILL.md 파일은 개방형 에이전트 스킬 사양을 따르므로 하나의 스킬이 여러 코딩 에이전트에서 작동합니다. 제품 팀에게 SKILL.md 파일은 에이전트가 제품을 올바르게 사용하는 방법을 학습하는 새로운 관문과 같습니다. 보안 팀에게는 에이전트의 동작을 변경하는 일반 텍스트 파일이므로 코드와 마찬가지로 면밀한 검토가 필요합니다.
SKILL.md 파일이란 무엇인가요? #
AI 에이전트는 유능하지만 일반적입니다. 코드를 작성하고 도구를 호출하는 방법은 알지만, 배포 프로세스, API 규칙 또는 CI에서 CLI를 안전하게 실행하는 데 필요한 세 가지 플래그는 알지 못합니다. 최근까지 이 문제를 해결하기 위해 모든 세션에 로드되어 실제 작업과 컨텍스트를 두고 경쟁하는 시스템 프롬프트에 이 모든 정보를 붙여넣어야 했습니다.
SKILL.md 파일은 이 문제를 다른 방식으로 해결합니다. 에이전트가 검색하고, 관련성이 있을 때 읽고, 그렇지 않을 때는 무시할 수 있는 폴더에 하나의 기능(이 서비스 배포, 이러한 발견 사항 분류, 이 보고서 생성)을 패키징합니다. 이 형식은 Anthropic에서 개발하여 오픈 소스로 공개했습니다. standard 밸리 에이전트 스킬 명세이후 OpenAI Codex, GitHub Copilot, Cursor를 포함한 점점 더 많은 에이전트에서 채택되었습니다.
따라서 SKILL.md 파일이 무엇인지 묻는 팀은 실제로 두 가지 질문을 하는 것입니다. 첫째, 에이전트가 우리 도구를 잘 사용하도록 어떻게 가르칠 것인가? 둘째, 에이전트가 잘못된 것을 배우지 않도록 어떻게 막을 것인가? 에이전트 기반 AI 보안이란 무엇인가요?
SKILL.md의 의미: 파일의 실제 내용 #
SKILL.md의 의미는 그에 얽힌 과장된 설명보다 훨씬 간단합니다. 스킬은 필수 파일 하나가 들어 있는 폴더입니다.

SKILL.md 파일 자체는 두 부분으로 구성되어 있습니다. #
- 마크다운 본문. 지침: 단계, 규칙, 예시 및 에이전트가 필요할 때 열어야 하는 지원 파일에 대한 포인터가 포함되어 있습니다.
- YAML 프런트매터. 최소한
name및description설명은 파일에서 가장 중요한 부분입니다. 왜냐하면 담당자가 해당 기술이 적용 가능한지 여부를 결정할 때 읽는 내용이기 때문입니다.
포함되지 않는 내용은 다음과 같습니다. 자격 증명, 코드로 작성해야 하는 비즈니스 로직 또는 특정 대화에만 적용되는 지침.
SKILL.md 파일이 왜 이렇게 되었을까요? standard #
컨텍스트는 유한하기 때문입니다. 에이전트가 필요로 하지 않는 지침에 소모되는 모든 토큰은 작업에 사용되지 않는 토큰입니다. 스킬은 계층적으로 로드되므로 에이전트는 수십 개의 스킬을 보유할 수 있으며, 관련 스킬이 나타나기 전까지는 거의 비용을 지불하지 않습니다.
이식성이 나머지를 해결했습니다. 한 번 작성된 스킬은 해당 명세를 구현하는 모든 에이전트에서 실행됩니다. 제품 회사 입장에서는 에이전트 지원의 경제성이 달라집니다. 어시스턴트마다 하나의 통합을 구현하는 대신, 하나의 스킬만 게시하면 되기 때문입니다.
그리고 상담원은 사용자가 되었습니다. 개발자들은 점점 더 상담원에게 "스캐너를 설정해 주세요" 또는 "문제를 해결해 주세요"라고 요청합니다. pipeline"문서를 직접 읽는 대신"이라는 문구를 사용하는 경우가 있습니다. 에이전트가 오래된 포럼 게시글에서 제품을 학습하면 제대로 활용하지 못할 가능성이 높습니다. SKILL.md 파일을 사용하면 에이전트가 무엇을 학습할지 직접 결정할 수 있습니다.
설계 원칙은 점진적 공개입니다. 시작 시 메타데이터를 제공하고, 활성화 시 명령어를 제공하며, 실행 시 리소스를 제공합니다. 이것이 바로 설명이 매우 중요한 이유입니다. 설명이 모호하면 스킬이 전혀 작동하지 않거나, 작동해서는 안 될 때 작동할 수 있습니다.
AI 에이전트를 위해 제품을 구성하는 방법
#
에이전트 스킬을 API 참조와 동일한 수준의 주의를 기울여 제품 표면처럼 다루십시오.
- 제품마다 기술이 달라지는 것이 아니라, 직무마다 기술이 달라야 합니다. "CI에서 스캐닝 구성"과 "결과 분류"는 별개의 스킬입니다. 모든 것을 포괄하려는 단일 스킬은 예측할 수 없이 작동하고 로드되는 컨텍스트를 과도하게 복잡하게 만듭니다.
- 설명을 트리거로 작성하세요. 해당 스킬의 기능과 사용 시기를 사용자가 실제로 입력하는 단어로 설명하세요.
- 본문은 간결하고 명료하게 작성하세요. 단계, guardrails 및 기본값. 깊이를 이동
references/그래서 필요할 때만 로드됩니다. - 스크립트에 결정론적 작업을 넣으세요. 만약 어떤 단계가 매번 동일한 방식으로 진행되어야 한다면 (구성 유효성 검사, 출력 형식 지정 등), 모델이 해석해야 하는 텍스트 대신 스크립트를 제공하는 것이 좋습니다.
- 안전 경로를 인코딩합니다. 에이전트가 절대 해서는 안 되는 행동을 명시하세요. 예를 들어 유효성 검사를 건너뛰거나, 검사를 비활성화하거나, 운영 환경의 자격 증명을 사용하는 것 등이 있습니다. 에이전트는 암묵적인 규칙보다 명시적인 규칙을 훨씬 더 잘 따릅니다.
- 코드처럼 버전 관리하고 테스트하세요. 스킬은 저장소에 보관하고, 변경 사항은 검토하세요. pull requests 그리고 출시 전에 실제 작업 환경에서 테스트하십시오.
제품에서 액션을 노출하는 경우 해당 스킬을 MCP 서버와 연결하세요. MCP는 에이전트에게 도구에 대한 접근 권한을 제공하고, 스킬은 에이전트가 이러한 도구를 잘 사용하는 방법을 학습시켜 줍니다. → 모델 컨텍스트 프로토콜(MCP)이란 무엇인가요?
SKILL.md 파일이 아닌 것은 무엇인가요? 관련 용어
#
이러한 것들이 혼동되어 설계 및 검토 논의 모두를 흐리게 만듭니다.
- AGENTS.md 및 CLAUDE.md 항상 활성화되는 파일입니다. 저장소 전체의 규칙이 매 세션마다 로드됩니다. 스킬은 필요에 따라 로드됩니다.
- MCP 서버 도구와 데이터를 제공합니다. SKILL.md 파일에는 지식과 절차가 담겨 있으며, 서로 보완적인 관계입니다.
- 시스템 메시지 하나의 애플리케이션에 대한 고정된 명령어입니다. 스킬은 에이전트 간에 이식 가능하고 재사용할 수 있습니다.
- 규칙 파일 (커서 규칙 파일과 같은) 파일은 하나의 도구 내에서 어시스턴트의 동작을 제어합니다. 위험 프로필은 동일하지만 이식성이 떨어집니다.
- llms.txt 스킬은 모델이 문서를 읽도록 도와줍니다. 스킬은 에이전트에게 해당 스킬을 어떻게 처리해야 하는지 알려줍니다.
이것들은 서로 경쟁하는 관계가 아니라, 계층 구조를 이루고 있습니다. 공통점은 각각이 AI 에이전트의 동작을 변경하는 일반 텍스트이며, 일반적으로 문서로 검토된다는 점입니다.
StandardSKILL.md의 위험의 의미를 형성하는 요소들 #
출처를 판단할 때는 내용이 얼마나 최신처럼 들리는지가 아니라 발행 시기를 기준으로 삼으세요.
이러한 위험은 가설이 아니라 실제로 입증된 사실입니다. MITRE ATLAS는 규칙 파일에 숨겨진 명령어를 통해 어시스턴트가 흔적도 없이 백도어 코드를 생성하도록 유도하는 공격 사례를 기록하고 있습니다. 악성 SKILL.md 파일도 같은 방식으로 작동하며, 스크립트를 묶어 제공하는 스킬은 명령어를 전달하는 것 외에도 코드를 실행할 수 있습니다. 커뮤니티 스킬을 설치하는 것 또한 동일한 신뢰도 검증을 필요로 합니다.cis패키지를 설치하는 것과 같습니다. → 신속 주사란 무엇인가요?
정의부터 프로그램까지 #
SKILL.md 파일이 무엇인지 안다고 해서 저장소에 이미 몇 개의 SKILL.md 파일이 있는지, 누가 추가했는지, 또는 에이전트에게 어떤 작업을 지시하는지 알 수는 없습니다.
그 격차는 예측 가능한 순서로 해소됩니다. 아무도 선언하지 않은 것을 포함하여 코드 전체의 모든 스킬, 규칙 파일 및 MCP 구성을 찾아내십시오. 이를 문서가 아닌 보안 아티팩트로 분석하십시오. 그런 다음 기록을 최신 상태로 유지하여 감사자 또는 사고 대응 담당자가 어떤 에이전트 자산이 존재하고 어떻게 연결되는지 확인할 수 있도록 하십시오.
Xygeni AI 보안 사용자의 코드로부터 해당 레코드를 생성합니다. 스킬은 모델, 데이터셋, 추론 엔드포인트, 에이전트, MCP 서버, 프롬프트와 함께 사용됩니다. guardrails Xygeni는 지속적인 AI 인벤토리에서 AI 코딩 도구를 분석하고, 각 도구에 위험 점수, 제공업체, 유형 및 코드 내 정확한 위치를 표시합니다. 또한 스킬 파일, 규칙 파일 및 MCP 구성을 보안 아티팩트로 분석하여 악성 파일을 식별합니다. AI 그래프는 어떤 에이전트가 어떤 도구에 접근하는지 보여주며, 동일한 검색 결과를 바탕으로 기계 판독 가능한 AI BOM을 내보낼 수 있습니다. AI BOM이란 무엇인가요? 섀도 AI란 무엇인가?
데모 예약 AI 인벤토리에 이미 있는 에이전트 스킬을 확인하려면.
FAQ #
인공지능 에이전트에게 특정 작업을 수행하는 방법을 가르치는 마크다운 파일로, 해당 작업이 발생할 때만 로드됩니다.
스킬별 폴더에 저장되며, 일반적으로 프로젝트 저장소 또는 사용자 에이전트 구성 디렉터리 내에 있습니다. 정확한 위치는 에이전트에 따라 다릅니다.
네, 둘 다 에이전트 스킬 사양을 준수하는 경우 가능합니다. 동일한 SKILL.md 파일은 호환되는 모든 에이전트에서 수정 없이 실행됩니다.
개발자가 AI 에이전트를 사용하여 제품을 설정하거나 운영하는 경우, 그렇습니다. 에이전트가 제품을 올바르고 안전하게 사용하는지 확인하는 가장 직접적인 방법입니다.
그럴 수 있습니다. 스킬은 에이전트가 따르는 지침이며, 실행 가능한 스크립트를 포함할 수 있습니다. 스킬은 코드처럼 검토하고, 신뢰할 수 있는 출처에서 제공하는 커뮤니티 스킬만 설치하며, 저장소 전체에 어떤 스킬이 있는지 목록을 유지 관리하세요.
