Xygeni 보안 용어집
소프트웨어 개발 및 제공 보안 용어집

SKILL.md 파일이란 무엇인가요?

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설명은 파일에서 가장 중요한 부분입니다. 왜냐하면 담당자가 해당 기술이 적용 가능한지 여부를 결정할 때 읽는 내용이기 때문입니다.
마크다운 — 이름: acme-cli-deploy 설명: Acme CLI를 사용하여 서비스를 배포합니다. 사용자가 Acme 서비스를 배포, 릴리스 또는 롤백하도록 요청할 때 사용합니다. — # Acme CLI를 사용한 배포 1. 배포 전에 `acme validate`를 실행하십시오. 2. 프로덕션 환경에서는 `--force` 옵션을 절대 사용하지 마십시오. 3. 롤백 절차는 references/rollback.md를 참조하십시오.

포함되지 않는 내용은 다음과 같습니다. 자격 증명, 코드로 작성해야 하는 비즈니스 로직 또는 특정 대화에만 적용되는 지침.

SKILL.md 파일이 왜 이렇게 되었을까요? standard #


컨텍스트는 유한하기 때문입니다. 에이전트가 필요로 하지 않는 지침에 소모되는 모든 토큰은 작업에 사용되지 않는 토큰입니다. 스킬은 계층적으로 로드되므로 에이전트는 수십 개의 스킬을 보유할 수 있으며, 관련 스킬이 나타나기 전까지는 거의 비용을 지불하지 않습니다.

이식성이 나머지를 해결했습니다. 한 번 작성된 스킬은 해당 명세를 구현하는 모든 에이전트에서 실행됩니다. 제품 회사 입장에서는 에이전트 지원의 경제성이 달라집니다. 어시스턴트마다 하나의 통합을 구현하는 대신, 하나의 스킬만 게시하면 되기 때문입니다.

그리고 상담원은 사용자가 되었습니다. 개발자들은 점점 더 상담원에게 "스캐너를 설정해 주세요" 또는 "문제를 해결해 주세요"라고 요청합니다. pipeline"문서를 직접 읽는 대신"이라는 문구를 사용하는 경우가 있습니다. 에이전트가 오래된 포럼 게시글에서 제품을 학습하면 제대로 활용하지 못할 가능성이 높습니다. SKILL.md 파일을 사용하면 에이전트가 무엇을 학습할지 직접 결정할 수 있습니다.

SKILL.md 파일 작동 방식: 점진적 정보 공개 #

실제로 SKILL.md 파일이 무엇인지 이해한다는 것은 에이전트가 어떤 스킬을 언제 로드하는지 아는 것을 의미합니다. 왜냐하면 그것이 수십 개의 에이전트 스킬이 컨텍스트 창을 도배하는 것을 방지하는 핵심이기 때문입니다.

단계에이전트가 로드하는 내용로딩 중일 때
발견앞부분에 있는 이름과 설명, 스킬당 수십 개의 토큰시작 시, 설치된 모든 스킬에 대해
활성화SKILL.md의 전체 내용: 단계, 규칙 및 예시작업이 설명과 일치할 때
실행스크립트, 참고 문서 및 자산이 폴더에 묶여 있습니다.지시사항에 명시된 경우에만

설계 원칙은 점진적 공개입니다. 시작 시 메타데이터를 제공하고, 활성화 시 명령어를 제공하며, 실행 시 리소스를 제공합니다. 이것이 바로 설명이 매우 중요한 이유입니다. 설명이 모호하면 스킬이 전혀 작동하지 않거나, 작동해서는 안 될 때 작동할 수 있습니다.

AI 에이전트를 위해 제품을 구성하는 방법
#

에이전트 스킬을 API 참조와 동일한 수준의 주의를 기울여 제품 표면처럼 다루십시오.

  1. 제품마다 기술이 달라지는 것이 아니라, 직무마다 기술이 달라야 합니다. "CI에서 스캐닝 구성"과 "결과 분류"는 별개의 스킬입니다. 모든 것을 포괄하려는 단일 스킬은 예측할 수 없이 작동하고 로드되는 컨텍스트를 과도하게 복잡하게 만듭니다.
  2. 설명을 트리거로 작성하세요. 해당 스킬의 기능과 사용 시기를 사용자가 실제로 입력하는 단어로 설명하세요.
  3. 본문은 간결하고 명료하게 작성하세요. 단계, guardrails 및 기본값. 깊이를 이동 references/ 그래서 필요할 때만 로드됩니다.
  4. 스크립트에 결정론적 작업을 넣으세요. 만약 어떤 단계가 매번 동일한 방식으로 진행되어야 한다면 (구성 유효성 검사, 출력 형식 지정 등), 모델이 해석해야 하는 텍스트 대신 스크립트를 제공하는 것이 좋습니다.
  5. 안전 경로를 인코딩합니다. 에이전트가 절대 해서는 안 되는 행동을 명시하세요. 예를 들어 유효성 검사를 건너뛰거나, 검사를 비활성화하거나, 운영 환경의 자격 증명을 사용하는 것 등이 있습니다. 에이전트는 암묵적인 규칙보다 명시적인 규칙을 훨씬 더 잘 따릅니다.
  6. 코드처럼 버전 관리하고 테스트하세요. 스킬은 저장소에 보관하고, 변경 사항은 검토하세요. pull requests 그리고 출시 전에 실제 작업 환경에서 테스트하십시오.

제품에서 액션을 노출하는 경우 해당 스킬을 MCP 서버와 연결하세요. MCP는 에이전트에게 도구에 대한 접근 권한을 제공하고, 스킬은 에이전트가 이러한 도구를 잘 사용하는 방법을 학습시켜 줍니다. → 모델 컨텍스트 프로토콜(MCP)이란 무엇인가요?

SKILL.md 파일이 아닌 것은 무엇인가요? 관련 용어
#

이러한 것들이 혼동되어 설계 및 검토 논의 모두를 흐리게 만듭니다.

  • AGENTS.md 및 CLAUDE.md 항상 활성화되는 파일입니다. 저장소 전체의 규칙이 매 세션마다 로드됩니다. 스킬은 필요에 따라 로드됩니다.
  • MCP 서버 도구와 데이터를 제공합니다. SKILL.md 파일에는 지식과 절차가 담겨 있으며, 서로 보완적인 관계입니다.
  • 시스템 메시지 하나의 애플리케이션에 대한 고정된 명령어입니다. 스킬은 에이전트 간에 이식 가능하고 재사용할 수 있습니다.
  • 규칙 파일 (커서 규칙 파일과 같은) 파일은 하나의 도구 내에서 어시스턴트의 동작을 제어합니다. 위험 프로필은 동일하지만 이식성이 떨어집니다.
  • llms.txt 스킬은 모델이 문서를 읽도록 도와줍니다. 스킬은 에이전트에게 해당 스킬을 어떻게 처리해야 하는지 알려줍니다.

이것들은 서로 경쟁하는 관계가 아니라, 계층 구조를 이루고 있습니다. 공통점은 각각이 AI 에이전트의 동작을 변경하는 일반 텍스트이며, 일반적으로 문서로 검토된다는 점입니다.

StandardSKILL.md의 위험의 의미를 형성하는 요소들 #

출처를 판단할 때는 내용이 얼마나 최신처럼 들리는지가 아니라 발행 시기를 기준으로 삼으세요.

출처Status그것을 사용하는 방법
에이전트 스킬 명세엽니다 standard2025년 12월 출시포맷 자체: 폴더 구조, 프론트매터 및 로딩 모델
모델 컨텍스트 프로토콜개방형 프로토콜이며, 활발하게 발전하고 있습니다.기술이 보완하는 도구 및 데이터 접근 계층
OWASP LLM 지원자 대상 Top 10현재 발행된 최신판신속 주사, 공급망 및 과도한 대리인에 대한 위험 분류 체계
OWASP 에이전트 애플리케이션 Top 102025년 XNUMX월 출판특정 에이전트에 대한 위험. 에이전트 이름을 명시하고, 최근 발생 여부를 기재하십시오.
마이터 아틀라스지속적으로 업데이트되는 살아있는 지식 기반규칙 파일 백도어를 포함한 사례 연구를 통해 검증된 위협 모델링

이러한 위험은 가설이 아니라 실제로 입증된 사실입니다. 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 파일이란 무엇인가요? 간단히 설명해 주세요.

인공지능 에이전트에게 특정 작업을 수행하는 방법을 가르치는 마크다운 파일로, 해당 작업이 발생할 때만 로드됩니다.

SKILL.md 파일은 어디에 있나요?

스킬별 폴더에 저장되며, 일반적으로 프로젝트 저장소 또는 사용자 에이전트 구성 디렉터리 내에 있습니다. 정확한 위치는 에이전트에 따라 다릅니다.

에이전트 스킬은 서로 다른 AI 에이전트 간에도 작동하나요?

네, 둘 다 에이전트 스킬 사양을 준수하는 경우 가능합니다. 동일한 SKILL.md 파일은 호환되는 모든 에이전트에서 수정 없이 실행됩니다.

내 제품에 SKILL.md 파일을 포함해야 할까요?

개발자가 AI 에이전트를 사용하여 제품을 설정하거나 운영하는 경우, 그렇습니다. 에이전트가 제품을 올바르고 안전하게 사용하는지 확인하는 가장 직접적인 방법입니다.

SKILL.md 파일은 보안 위험 요소인가요?

그럴 수 있습니다. 스킬은 에이전트가 따르는 지침이며, 실행 가능한 스크립트를 포함할 수 있습니다. 스킬은 코드처럼 검토하고, 신뢰할 수 있는 출처에서 제공하는 커뮤니티 스킬만 설치하며, 저장소 전체에 어떤 스킬이 있는지 목록을 유지 관리하세요.

무료로 시작

무료로 시작하세요.
신용 카드가 필요하지 않습니다.

클릭 한 번으로 시작하세요:

이 정보는 규정에 따라 안전하게 저장됩니다. 서비스약관 개인정보 처리방침

앱 스크린샷