에이전트 스킬과 프롬프트: 각각 언제 사용해야 할까

매주 금요일 AI 도우미에게 업무 메모를 주고 주간 업데이트로 정리해 달라고 한다고 해 봅시다. 완료한 일과 계획을 구분하고, 막힌 일은 드러내며, 마감일을 지어내지 말라는 규칙을 매번 반복합니다. 이번 주의 사실은 바뀌지만 보고 규칙은 그대로입니다.

이때는 저장해 둔 프롬프트로 충분할 수 있습니다. 같은 규칙을 해당 형식을 지원하는 에이전트가 재사용할 수 있는 패키지로 관리하고 싶다면 **에이전트 스킬(Agent Skill)**을 고려할 만합니다. 스킬을 사용한다고 프롬프트가 없어지는 것도, 빠진 사실이 채워지는 것도, 보고서의 정확성이 보장되는 것도 아닙니다.

Agent Skills 개요는 재사용 가능한 지식과 작업 절차를 폴더에 담는 형식을 설명합니다. 이 글에서 “스킬”은 이러한 기술 형식을 뜻하며, 모델이 훈련을 통해 새 능력을 익혔다는 일반적인 주장이 아닙니다. 형식의 세부 사항은 2026년 9월 7일에 확인했습니다.

고정되는 것과 바뀌는 것 비교하기

프롬프트도 길고 재사용 가능할 수 있으며, 스킬도 지침만 담아 짧을 수 있습니다. 길이가 둘을 가르는 기준은 아닙니다. 실질적인 차이는 반복 지침을 어떻게 저장하고, 사용할 수 있게 하고, 관리하는가에 있습니다.

패키지를 만들기 전에 반복 요청부터 시험하기

다음은 가상의 주간 메모입니다.

Help-page draft completed on Monday.
Review requested from Mina; no reply yet.
Publish after review. No publication date agreed.
Search bug reproduced; fix not started.

한 번만 업데이트를 작성한다면 다음 요청만으로도 필요한 작업을 충분히 설명할 수 있습니다.

Turn these notes into a weekly update with three sections:
Completed, Waiting on others, and Next work.
Preserve the difference between finished work and planned work.
Do not invent owners, dates, approvals or progress.
If an essential fact is missing, mark it as not confirmed.

[Paste this week's notes.]

보고서에 “Mina가 초안을 승인했으므로 금요일에 게시한다”고 적혔다면 두 가지 오류가 있습니다. 세련된 보고서를 요청했다고 해서 승인이나 게시일을 만들어 내도 된다는 뜻은 아닙니다. 기준에 따라 확인할 사실은 초안이 완료되었고, 검토 답변을 기다리고 있으며, 합의된 게시일이 없고, 버그는 재현했지만 수정하지 않았다는 것입니다.

이 업데이트를 가끔만 쓴다면 요청문을 문서에 저장했다가 필요할 때 붙여 넣으세요. 새로운 설치나 유지 관리 작업을 추가하지 않고도 지침을 재사용할 수 있습니다.

스킬은 반복되는 부분을 따로 저장합니다

이를 지원하는 에이전트에서는 같은 보고 규칙을 weekly-update 폴더 안의 SKILL.md 파일에 저장할 수 있습니다. 형식 명세에 따르면 YAML 메타데이터에 이름과 설명을 적고, 그 뒤에 Markdown 지침을 작성해야 합니다.

아래는 저자가 작성한 최소 설계 예시이며, 설치된 스킬이나 벤치마크 결과가 아닙니다.

---
name: weekly-update
description: Turn work notes into a factual weekly update. Use when drafting a recurring weekly status report from supplied notes.
---

# Weekly update

Read the supplied notes. If none are provided, ask for them.

Write three sections:
- Completed
- Waiting on others
- Next work

Keep planned work separate from completed work.
Do not invent owners, dates, approvals or progress.
Mark essential missing information as not confirmed.
Before returning the report, check each status against the source notes.
Return a draft; do not send it to anyone.

이번 주 메모를 이 지침에 영구적으로 넣으면 안 됩니다. “Mina가 아직 답하지 않았다”는 내용을 스킬에 고정하면 다음 주에는 낡은 정보가 될 수 있습니다. 새 사실은 요청할 때마다 제공하고, 반복되는 절차는 패키지에서 관리하세요.

이제 현재 요청은 달라지는 입력에 집중할 수 있습니다. “weekly-update 스킬을 사용해 이 메모로 이번 주 보고서를 작성해 줘”라고 요청하면 됩니다. 그래도 에이전트는 스킬을 찾아 지침을 따라야 합니다. 선택한 클라이언트의 설치 및 호출 지침을 따르세요. 컴퓨터 어딘가에 폴더를 만들었다고 해서 스킬을 사용할 수 있게 되는 것은 아닙니다.

패키징은 테스트를 대신하지 않습니다

이 형식에서는 필요할 때 전체 지침을 불러오기 전에 짧은 설명을 먼저 찾아볼 수 있습니다. 방대한 재사용 지침이 무관한 작업에 끼어드는 일을 줄일 수 있지만, 모든 클라이언트가 어떤 표현의 요청에서도 올바른 스킬을 활성화한다는 증거는 아닙니다.

같은 가상 메모를 사용해 저장된 프롬프트와 스킬을 비교하세요. 제목이 같은지만 보지 말고 앞에서 확인한 정확한 사실을 찾으세요. 그다음 메모를 완전히 빼 보세요. 작업 절차가 입력을 요청하는지, 아니면 가상의 상태 보고서를 만들어 내는지 확인합니다. 마지막으로 검토 완료 사실을 제공하고 보고서에서 해당 상태만 바뀌는지 살펴봅니다.

이는 권장 인수 사례입니다. 이 예시를 여러 클라이언트에서 측정하지 않았으므로 정확도나 속도가 향상된다고 주장하지 않습니다. Anthropic의 스킬 엔지니어링 설명도 큰 패키지가 더 좋다고 가정하기보다 대표 과제와 관찰된 문제에서 시작하라고 권합니다.

스킬에는 스크립트도 포함될 수 있습니다. 다른 사람이 만든 패키지는 사용 전에 스크립트의 동작을 읽어 보세요. 특히 파일 접근이나 외부 연결을 요구할 때는 주의해야 합니다. 보고서 작성 지침과 실제로 보고서를 전송하는 코드는 서로 다릅니다. 패키지가 존재한다는 사실은 그 안에 언급된 모든 행동을 실행할 권한이 있다는 뜻이 아닙니다.

언제 스킬을 관리할 가치가 있을까?

보고 규칙과 템플릿, 허용 가능한 결과의 예시, 도구를 사용하는 절차처럼 여러 요소가 함께 반복될 때 스킬을 고려하세요. 관리되는 패키지 하나에 이런 요소를 모으면 한곳에서 업데이트하고 변경 후 점검을 반복할 수 있습니다.

과제가 가끔 발생하거나 규칙이 짧거나 앱이 해당 형식을 지원하지 않는다면 저장된 프롬프트를 계속 사용해도 됩니다. 모호한 지침을 파일로 옮긴다고 의미가 분명해지지는 않습니다. 먼저 직접 확인할 수 있는 보고서 하나를 완성한 다음, 반복되는 지침과 매주 달라지는 사실을 분리하세요.

참고 자료

• Agent Skills 개요: 재사용 형식과 단계적 로딩 모델을 설명합니다.
• Agent Skills 명세: 필수 메타데이터, 지침 파일, 선택적 리소스를 정의합니다.
• Anthropic: 실제 환경의 에이전트를 위한 Agent Skills: 개발, 평가, 보안 고려 사항을 다룹니다.