개요
Agent Skills는 절차적 지식과 컨텍스트를 휴대 가능한 폴더로 패키징하여 에이전트가 필요에 따라 로드할 수 있도록 하는 개방형 표준입니다. 이는 메타데이터와 지침을 포함하는 간단한 SKILL.md 형식을 정의하여, 호환되는 AI 에이전트 간에 도메인 전문 지식과 반복 가능한 워크플로를 구현합니다.
README 미리보기
# Agent Skills\n\n[](https://discord.gg/MKPE9g8aUy)\n\nA standardized way to give AI agents new capabilities and expertise.\n\n## What are Agent Skills?\n\nAgent Skills are a lightweight, open format for extending AI agent capabilities with specialized knowledge and workflows.\n\nAt its core, a skill is a folder containing a `SKILL.md` file. This file includes metadata (`name` and `description`, at minimum) and instructions that tell an agent how to perform a specific task. Skills can also bundle scripts, reference materials, templates, and other resources.\n\n```\nmy-skill/\n├── SKILL.md # Required: metadata + instructions\n├── scripts/ # Optional: executable code\n├── references/ # Optional: documentation\n├── assets/ # Optional: templates, resources\n└── ... # Any additional files or directories\n```\n\n## Why Agent Skills?\n\nAgents are increasingly capable, but often don't have the context they need to do real work reliably. Skills solve this by packaging procedural knowledge and company-, team-, and user-specific context into portable, version-controlled folders that agents load on demand. This gives agents:\n\n- **Domain expertise**: Capture specialized knowledge — from legal review processes to data analysis pipelines to presentation formatting — as reusable instructions and resources.\n- **Repeatable workflows**: Turn multi-step tasks into consistent, auditable procedures.\n- **Cross-product reuse**: Build a skill once and use it across any skills-compatible agent.\n\n## How do Agent Skills work?\n\nAgents load skills through **progressive disclosure**, in three stages:\n\n1. **Discovery**: At startup, agents load only the name and description of each available skill, just enough to know when it might be relevant.\n\n2. **Activation**: When a task matches a skill's description, the agent reads the full `SKILL.md` instructions into context.\n\n3. **Execution**: The agent follows the instructions, optionally exe
FAQ (1)
문제 해결중첩 메타데이터를 사용할 때 SKILL.md가 "cannot unmarshal !!map into string" 오류로 실패하는 이유는 무엇인가요?
문제 해결
중첩 메타데이터를 사용할 때 SKILL.md가 "cannot unmarshal !!map into string" 오류로 실패하는 이유는 무엇인가요?SKILL.md frontmatter의 metadata 필드는 문자열 대 문자열 매핑으로 정의됩니다. 중첩된 객체, 배열, 숫자, 불리언은 이식성이 없으며 엄격한 클라이언트는 이를 거부합니다. 메타데이터를 문자열 키와 문자열 값으로 평탄화하세요. 예를 들면 다음과 같습니다:
metadata:
hermes_tags: "ADHD, Output Style, Productivity, Formatting"
hermes_category: "productivity"
hermes_related_skills: ""배열이나 객체가 필요한 경우, 이를 문자열(쉼표로 구분된 텍스트나 JSON 등)로 직렬화하고 클라이언트가 해당 값을 파싱하도록 하세요. 사양 개요는 상세 필드 정의와 일치하도록 업데이트되었습니다. 즉, 키와 값은 모두 문자열이어야 합니다.