Agent Skills란 무엇인가? 초보자 가이드

Source: Dev.to

위에 제공된 텍스트를 한국어로 번역하려면, 번역하고자 하는 실제 내용(본문)을 알려주시면 도와드릴 수 있습니다.
본문을 공유해 주시면 원본 서식과 코드 블록을 그대로 유지하면서 한국어로 번역해 드리겠습니다.

개요

AI 에이전트는 강력하지만 처음에는 일반적입니다. 많은 일반 정보를 알고 있지만 귀하의 도메인‑특화 지식, 선호도 및 팀 관행은 부족합니다.
스킬은 에이전트에게 특정 작업을 귀하가 원하는 방식대로 수행하도록 가르치는 재사용 가능한 독립형 지시 집합입니다. 재능 있는 셰프를 위한 레시피 카드라고 생각하면 됩니다: 셰프는 무엇이든 요리할 수 있지만, 카드는 귀하만의 비밀 소스를 정확히 만드는 방법을 알려줍니다.

• 스킬이 없을 때 → 에이전트가 일반적인 출력을 생성합니다.
• 스킬이 있을 때 → 에이전트가 귀하의 정확한 지시를 따르고 매번 기대한 대로 결과를 제공합니다.

가장 단순한 형태의 스킬은 SKILL.md 하나의 파일이며, 여기에는 이름, 설명 및 지시 사항이 포함됩니다. 이후에 스크립트, 에셋, 평가 파일 등을 추가할 수 있지만 이는 선택 사항입니다.

아래는 good‑morning 스킬을 만드는 단계별 가이드입니다.

Source: …

단계별 가이드

1️⃣ 폴더 구조 만들기

다음 루트 폴더 중 하나에 스킬을 배치할 수 있습니다: .agents/, .github/, 또는 .claude/. Copilot, Claude Code 및 기타 도구에서 모두 작동하는 관례는 .agents/skills/입니다.

your-project/
└── .agents/
    └── skills/
        └── good-morning/

2️⃣ SKILL.md 파일 추가

good-morning/ 안에 SKILL.md 라는 파일을 생성합니다 (대문자 – 에이전트가 이를 찾는 방식).

your-project/
└── .agents/
    └── skills/
        └── good-morning/
            └── SKILL.md

3️⃣ YAML 프런트‑머터 추가

SKILL.md를 열고 가장 위에 다음 프런트‑머터를 삽입합니다:

---
name: good-morning
description: "A skill that responds to a good‑morning greeting with a cheerful reply"
---

중요 참고 사항

• name 은 폴더 이름(good-morning)과 일치해야 합니다. 다르면 대부분의 편집기(및 에이전트)가 경고를 표시합니다.
• description 은 짧고 구체적이며 평이한 언어로 작성해야 합니다. 이는 에이전트가 언제 이 스킬을 로드할지 판단하는 데 도움이 됩니다.

4️⃣ 스킬 지시문 작성

프런트‑머터 아래에 있는 모든 내용이 스킬 본문입니다. 이 텍스트는 스킬이 호출될 때만 에이전트 컨텍스트에 추가되어 전체 프롬프트 크기를 작게 유지합니다.

---
name: good-morning
description: "A skill that responds to a good‑morning greeting with a cheerful reply"
---

# Good Morning Skill

**Trigger:** When the user says “good morning”.

**Response:**  

1. Greet the user personally.  
   - Example: `Hi Debbie, hope you have a great day!`  
2. Ask about their physical activity today.  
   - Example: `Did you get a chance to do any sport today?`  
3. Include a light‑hearted sports‑related joke.  
   - Example: `Why did the basketball team go to the bank? Because they wanted to get their *rebound*!`

**Formatting guidelines:**  

- Keep the reply concise (2‑3 sentences).  
- Use a friendly, upbeat tone.  
- End with the joke on a new line for emphasis.

**Optional extras (add later if needed):**  

- `script.sh` – a helper script to fetch the user’s name from a config file.  
- `assets/` – images or emojis to sprinkle into the response.  
- `eval.md` – test cases to verify the skill behaves as expected.

Recap

이제 완전한 good‑morning 스킬이 준비되었습니다! 나중에 스크립트, 에셋, 평가 파일 등을 추가해 확장할 수 있지만, SKILL.md만으로도 에이전트가 바로 사용할 수 있습니다. 즐거운 빌딩 되세요!

Source:

예시

사용자: Good morning

에이전트:

Hi Debbie, have you done any sport today? Here's a funny joke about sports: 
Why did the soccer player bring string to the game? Because he wanted to tie the score!

이것이 전체 스킬입니다—파일 하나와 몇 줄의 지시문만 있죠. 자유롭게 개인화해 보세요(이름을 추가하거나 주제를 바꾸는 등).

사용 방법

1. 동일한 디렉터리에서 새 세션을 시작합니다(스킬은 세션 시작 시 발견됩니다).
2. 입력합니다:

Good morning

에이전트가 SKILL.md 파일을 찾아 읽고 응답합니다.

• GitHub Copilot에서는 다음과 같은 결과를 볼 수 있습니다:

  “Hi Debbie, have you done any sport today? Here’s a funny joke about sports! Why did the bicycle fall over? Because it was too tired from all that cycling!”

• Claude Code에서는 다음과 같은 결과를 얻을 수 있습니다:

  “Hi Debbie, have you done any sport today? Here’s a funny joke for you: Why do basketball players love donuts? Because they can always dunk them!”

같은 SKILL.md가 Copilot, Claude Code 및 기타 에이전트에서 모두 작동합니다. 각 에이전트가 스킬을 발견하고, 지시문을 읽고, 이를 따릅니다.

스킬이 할 수 있는 일

간단한 “good morning” 예제를 다음과 같은 지시문으로 교체하세요:

• 다듬어진 README 생성
• 팀 형식에 맞는 커밋 메시지 작성
• 표준에 따라 코드 검토

동일한 패턴이지만, 더 큰 영향을 줍니다.

세 단계 효율적 로딩

컨텍스트 윈도우가 제한되어 있기 때문에, 잘 설계된 스킬은 최상위(Level 1)에서 가볍게 유지되고 필요할 때만 세부 정보를 불러옵니다.

스킬이 설치되는 위치

프로젝트 수준 (프로젝트 디렉터리 내부에서만 사용 가능)

your-project/.github/skills/
your-project/.claude/skills/
your-project/.agents/skills/

전역 (어떤 디렉터리에서도 사용 가능)

~/.copilot/skills/
~/.claude/skills/
~/.agents/skills/

Note:
.agents/skills/ 경로는 Agent Skills 개방 표준(도구 간)을 따릅니다. Claude Code는 자체 .claude/ 구조를 사용하며, .agents/ 를 사용하지 않습니다.

스킬 설치 및 관리

커뮤니티는 **skills.sh**에 스킬 디렉터리를 유지하고 있으며, 이를 탐색할 수 있습니다.

스킬 설치

npx skills add anthropics/skills --skill skill-creator

Anthropic의 skill‑creator 스킬을 설치합니다—다른 스킬을 만들 때 도움을 주는 도구입니다.

설치된 스킬 목록

npx skills list

스킬 검색

npx skills find

skills CLI는 각 에이전트(Copilot, Claude Code, Cursor, Goose 등)에 맞는 올바른 위치에 스킬을 자동으로 배치합니다.

Bottom line

Skills are tiny, portable, and work across many AI agents. By keeping the top‑level description short and loading detailed instructions only when needed, you maximize the usefulness of each skill while staying within token limits.

핵심 요약

스킬은 작고, 휴대 가능하며, 다양한 AI 에이전트에서 작동합니다. 상위 수준 설명을 간결하게 유지하고 필요할 때만 자세한 지침을 로드함으로써, 토큰 제한 내에서 각 스킬의 유용성을 최대화할 수 있습니다.