Agent Skills

에이전트 스킬은 특정 유형의 작업에 대한 전문성을 AI 에이전트에 제공하는 지침, 스크립트, 참고 파일의 폴더입니다. 작업에서 필요할 때만 에이전트가 불러오도록 패키징됩니다. 각 스킬은 SKILL.md 파일을 중심으로 구성되며, 간단한 설명은 언제 사용할지 알려주고 본문은 사용 방법을 설명합니다. Anthropic은 2025년 10월 Claude용 Agent Skills를 도입하고 2025년 12월 agentskills.io에서 형식을 개방형 표준으로 공개했습니다. Claude Code, OpenAI Codex, Gemini CLI, Cursor, GitHub Copilot, VS Code 및 수십 가지 다른 에이전트가 이제 동일한 폴더를 읽으므로 스킬 하나를 모두에서 사용할 수 있습니다.

Agent Skills의 작동 방식#

스킬은 스킬 이름을 딴 디렉터리이며, 필수 SKILL.md 파일과 선택적 scripts/, references/, assets/ 폴더를 포함합니다. SKILL.md 파일은 필수 필드 두 개를 포함하는 YAML 프런트매터로 시작합니다. 첫 번째는 디렉터리 이름과 일치하는 소문자, 숫자, 하이픈으로 구성된 최대 64자 길이의 name이며, 두 번째는 스킬의 기능과 사용 시점을 설명하는 최대 1,024자 길이의 description입니다. 이어지는 Markdown 본문에는 절차, 예시, 예외 사례가 들어갑니다.

에이전트는 점진적 공개 방식으로 스킬을 불러와 대규모 스킬 라이브러리도 부담 없이 사용할 수 있습니다. 시작 시 에이전트는 각 스킬의 이름과 설명만 읽으며, 스킬당 약 100개의 토큰을 사용합니다. 요청이 설명과 일치하면 전체 SKILL.md을 컨텍스트 창에 읽어 들입니다. 사양은 본문을 500줄 및 5,000토큰 미만으로 유지하도록 권장합니다. 스크립트와 참고 파일은 지침에서 참조할 때만 불러오며, 스크립트를 실행하고 출력만 읽는 경우에는 스크립트 코드가 컨텍스트에 전혀 들어가지 않습니다.

SKILL.md 구성#

소매 팀은 매대 사진을 처리하는 이 스킬을 에이전트에 제공할 수 있습니다. 설명에는 에이전트가 일치 여부를 판단할 트리거 단어가 포함되며, 본문은 필요할 때만 불러오는 스크립트와 참고 표를 가리킵니다.

---
name: shelf-audit
description: Counts products and finds empty facings in retail shelf photos. Use when the user asks about stock levels, gaps, or planogram compliance in store images.
---

# Shelf audit

1. Run `python scripts/detect_products.py <image>` on each photo. It prints one JSON line per product with its class, confidence, and box.
2. Compare the counts with the expected facings in `references/planogram.csv`.
3. Report each empty facing with its shelf position.
4. Send detections below 0.5 confidence to a person for review instead of counting them.

누군가 매대에 관해 묻기 전까지 에이전트는 프런트매터의 두 줄만 확인하며, 2단계에서만 플래노그램 파일을 엽니다.

Agent Skills와 관련 개념의 비교#

• 도구 및 함수 호출: 도구는 데이터베이스 쿼리나 객체 탐지 모델처럼 에이전트가 호출할 수 있는 하나의 작업입니다. 스킬은 도구에 부족한 검증 규칙과 도메인 맥락을 제공해 에이전트가 작업에 맞게 도구를 조합하는 시점과 방법을 알려줍니다.
• Model Context Protocol (MCP): 서버를 통해 에이전트를 실시간 외부 시스템에 연결합니다. 스킬은 절차 지식을 제공하므로 에이전트는 일반적으로 두 가지를 함께 사용합니다. 스킬은 에이전트에 어떤 MCP 도구를 어떤 순서로 호출할지 알려줄 수 있습니다.
• 시스템 프롬프트 및 프로젝트 지침: AGENTS.md와 같은 파일은 모든 세션에 로드됩니다. 스킬 본문은 일치하는 작업에만 로드되므로 에이전트는 컨텍스트를 과도하게 채우지 않고 수백 개의 스킬을 보유할 수 있습니다. 이것이 컨텍스트 엔지니어링의 핵심 개념입니다.
• 파인튜닝: 모델의 가중치를 변경하여 동작을 학습시킵니다. 스킬은 컨텍스트만 변경하므로 코드처럼 편집, 버전 관리, 검토할 수 있으며 즉시 적용됩니다.

실제 환경에서의 스킬#

스킬은 일반 대규모 언어 모델(LLM)이 갖추지 못했거나 일관성 없이 적용하는 노하우를 패키징합니다. 예를 들면 회사 브랜드 규칙, 팀의 릴리스 체크리스트, 파일 형식의 특이 사항 등이 있습니다. Anthropic의 공개 스킬 저장소에는 Claude 자체의 문서 작성을 지원하는 Word, PDF, PowerPoint, Excel 스킬이 포함되어 있습니다. Ultralytics Agent Skills는 컴퓨터 비전 라이프사이클을 다룹니다. yolo 라우터 스킬은 각 요청을 모델 선택, 데이터셋, 학습, 튜닝, 추론 또는 내보내기를 위한 스킬로 전달하고, platform-cli 스킬은 ul cloud 명령줄을 통해 Ultralytics Platform을 자동화합니다. Platform의 Ask AI 어시스턴트도 이 platform-cli 스킬을 사용하며, 동일한 폴더를 claude plugin install yolo@ultralytics를 사용해 Claude Code에 설치하거나 npx skills add ultralytics/skills을 사용해 다른 에이전트에 설치할 수 있습니다. 이를 통해 에이전트 기반 코딩 도구는 자연어 요청만으로 YOLO26 모델을 학습하고 내보낼 수 있습니다.

보안 고려 사항#

스킬은 에이전트의 권한으로 실행되므로 타사 스킬을 설치하는 것은 소프트웨어를 설치하는 것과 유사합니다. 스킬 지침에는 에이전트의 방향을 바꾸는 프롬프트 인젝션이 포함될 수 있으며, 스크립트는 에이전트 환경에서 허용되는 모든 파일을 읽거나 데이터를 전송할 수 있습니다. 팀은 스킬을 설치하기 전에 지침, 스크립트, 종속성을 검토하고 버전을 고정하며, 제한된 네트워크 액세스 권한이 있는 에이전트 샌드박스에서 스킬 스크립트를 실행합니다. 사양에는 실험적 allowed-tools 필드도 정의되어 있습니다. 이 필드는 Bash(git:*) Read처럼 스킬이 요청 없이 실행할 수 있는 도구를 공백으로 구분해 나열하며, 이 필드를 지원하는 에이전트는 에이전트 하네스에서 해당 도구를 사전 승인합니다.