AI TREND

AI 에이전트 만들기 전 꼭 확인해야 하는 것

설명서 프롬프트 · 자가 진단표 클로드 · 제미나이 · 챗GPT

에이전트를 늘리기 전에 업무 설명서부터 만드는 프롬프트를 모았어요.

앤트로픽 공식 문서를 읽고, 에트가 '주간 보고' 업무로 주요 프롬프트를 직접 시험해 봤어요. 목차를 누르면 바로 이동해요.

폰으로 보고 계신다면: 프롬프트는 폰에서도 복사해 쓸 수 있어요. 설명서를 ZIP으로 묶어 스킬로 올리는 단계는 컴퓨터에서 하는 게 편해요.

이 자료로 바뀌는 것

지금따라 하고 나면
매번 순서와 기준을 다시 설명해요설명서에 적어 두면 AI가 꺼내 읽어요
결과를 하나하나 열어 확인해요새 대화창이 기준표로 먼저 걸러 줘요
같은 실수를 채팅으로 계속 고쳐요설명서에 규칙을 더해 실수를 줄여요

다 따라 하면 손에 남는 것

내 업무 하나를 맡길 설명서(SKILL.md) 1개, 그리고 잘 나온 결과물로 뽑은 완료 기준 5개.

스킬이 무엇인가요?

스킬은 일하는 법을 담은 폴더예요.

앤트로픽은 "맞춤형 온보딩 자료"라고 설명해요. AI는 평소 이름과 설명만 보고 있다가, 필요할 때 설명서를 열고, 그래도 부족하면 참고 파일까지 읽어요.

이럴 땐이걸 쓰세요
모든 대화에 같은 말투를 원할 때맞춤 지침
한 프로젝트에서 늘 볼 자료가 있을 때프로젝트
특정 일을 매번 같은 순서로 맡길 때스킬

이렇게 사용하세요

  1. 자주 반복하는 일 하나를 골라 1번 프롬프트로 업무 설명서를 만들어요.
  2. 잘 나온 결과물은 2번으로 양식을 저장하고, 내기 전에 3번으로 새 대화창에서 채점해요.
  3. 같은 실수가 나오면 4번으로 설명서를 고쳐요. 어디서 시작할지 헷갈리면 아래 자가 진단표를 먼저 보세요.

1. 업무 설명서 만들기

① 맡길 일 하나 고르기

자주 반복하고, 잘됐는지 바로 알 수 있는 일 하나로 시작하세요. 스킬 하나에 일 하나가 좋아요.

② AI 채팅창에서 인터뷰받기

이럴 때 써요: 맡길 때마다 순서와 기준을 다시 설명하고 있을 때

클로드, 클로드 코드, 제미나이, 챗GPT 어디서든 채팅창에 붙여 넣기 👇🏻

내가 반복해서 하는 [업무 이름]을 너에게 맡길 설명서로 만들려고 해. 먼저 나를 인터뷰해 줘. 질문은 한 번에 하나만 하고 내 답을 기다려. 이걸 다 물어봐 줘: 언제 이 일을 하는지, 무엇을 받아서 시작하는지, 내가 하는 순서, 순서마다 판단하는 기준, 끝났다고 보는 기준, 예전에 틀렸던 경우, 나쁜 결과물의 모습. 다 물으면 SKILL.md로 정리해 줘. 맨 위에 name(영어 소문자와 하이픈)과 description(무엇을 하는지와 언제 쓰는지)을 적어 줘. 네가 이미 아는 일반 설명은 빼고 내 일에만 해당하는 내용을 적어 줘. 파일을 직접 만들 수 없으면 전체 내용을 복사할 수 있게 보여 줘.

✅ 받는 결과: 질문에 답하면 아래 "견본 설명서"처럼 칸이 나뉜 SKILL.md가 나와요. 쓰는 AI에 따라 칸 이름은 조금 다를 수 있어요.

💡 description이 가장 중요해요. AI는 이 줄을 보고 언제 스킬을 꺼낼지 정해요. "문서를 돕는다"처럼 쓰면 잘 안 꺼내요.

이미 한 번 같이 해 본 일이라면 더 쉬워요. 그 대화창에 이어서 붙여 넣으세요.

그 일을 같이 한 대화창에 이어서 붙여 넣기 👇🏻

방금 같이 한 일을 다음에도 똑같이 하도록 스킬로 만들어 줘. 내가 반복해서 알려 준 내용만 넣고, 네가 이미 아는 설명은 빼 줘.

③ 견본 설명서 바로 써 보기

주간 보고가 아니어도 칸 이름(마감, 입력, 순서, 판단 기준, 완료 기준, 과거 실수, 나쁜 결과물, 미정)은 그대로 두고 내용만 내 업무로 바꾸면 돼요. 맨 위 name과 description 두 줄도 내 업무로 바꾸세요.

복붙용 👇🏻

--- name: weekly-report description: 매출 시트, 회원 가입 시트, 고객센터 내보내기 파일 세 개로 팀장에게 보내는 주간 보고를 작성한다. 매주 금요일 오후 4시 마감 전에 주간 보고를 만들 때 사용한다. --- # 주간 보고 ## 마감 매주 금요일 오후 4시까지 팀장에게 보낸다. ## 입력 다음 파일 세 개를 받아서 시작한다. - 매출 시트 - 회원 가입 시트 - 고객센터 내보내기 파일 지난주 수치와 비교해야 하므로 지난주 보고서나 지난주 수치도 필요하다. 없으면 보고서를 쓰기 전에 요청한다. ## 순서 1. 세 파일에서 숫자를 뽑는다. 2. 각 숫자를 지난주와 비교한다. 3. 가장 많이 움직인 숫자를 맨 위에 쓴다. 4. 다음 주 할 일을 적는다. ## 판단 기준 - 지난주 대비 10% 넘게 움직인 숫자에만 이유를 한 줄 적는다. 나머지는 숫자만 쓴다. - 이유를 파일에서 확인할 수 없으면 추측해서 쓰지 말고 "원인 확인 필요"라고 적는다. - 모든 숫자 옆에 출처 파일 이름을 적는다. ## 완료 기준 아래를 모두 만족해야 끝난 것이다. - 모든 숫자에 출처 파일 이름이 있다. - 합계가 맞다. 보내기 전에 합계를 다시 계산해서 확인한다. - 다음 주 할 일이 2개 이상이다. - 전체가 200자 안쪽이다. ## 과거 실수 (반복 금지) - 합계를 잘못 더한 적이 있다. - 출처 없이 숫자만 쓴 적이 있다. ## 나쁜 결과물 숫자 없이 "좋은 흐름을 보였다" 같은 말만 있는 보고가 가장 나쁘다. 모든 문장은 숫자와 출처로 뒷받침한다. ## 미정 (사용자에게 확인 필요) - 세 파일에서 구체적으로 어떤 항목을 뽑는지(예: 총매출, 신규 가입 수, 문의 건수), 집계 기간 기준, 환불 처리 방식은 아직 정해지지 않았다. 처음 실행할 때 사용자에게 물어서 이 항목을 채운다.

④ 파일로 저장해 스킬로 등록하기

메모장(맥은 텍스트 편집기)에 붙여 넣어 SKILL.md로 저장한 뒤(.txt가 붙지 않게), 아래 순서대로 올리세요.

클로드, 제미나이, 챗GPT 순서로 있어요.

스킬로 등록하기 (claude.ai)

  1. 설정 → Capabilities에서 코드 실행과 파일 만들기(새 설정 화면에서는 Create and edit files)를 켜요.
  2. SKILL.md를 폴더에 넣고 그 폴더를 ZIP으로 묶어요. 폴더 이름은 name과 같게 해요.
  3. Customize → Skills → + → Create skill → Upload a skill에서 ZIP을 올려요.
클로드 설정의 Capabilities 화면. 코드 실행과 파일 만들기 스위치와 스킬 목록, Upload skill 버튼
앤트로픽 공식 글의 설정 화면이에요. 지금은 스킬 메뉴가 Customize → Skills에 있어요.

스킬로 등록하기 (제미나이)

  1. gemini.google.com 왼쪽 메뉴에서 Customize → Skills로 가요. Customize가 안 보이면 More를 먼저 눌러요.
  2. 1번 프롬프트로 받은 SKILL.md 파일이나 그 파일이 든 폴더를 올려요. 채팅에서 "이 내용으로 스킬 만들어 줘"라고 해도 돼요.
  3. 쓸 땐 채팅에 / (또는 @)를 치고 스킬 이름을 고르거나, 제미나이가 알아서 꺼내 쓰게 두세요.

개인 구글 계정(만 18세 이상, Keep Activity 켜기)이면 웹, 맥 앱, 모바일 앱에서 쓸 수 있어요.

스킬로 등록하기 (챗GPT)

  1. 왼쪽 메뉴 Plugins → Skills → Create → Upload from your computer에서 올려요. 채팅에서 스킬을 만들어 달라고 해도 돼요.

챗GPT 스킬은 Business, Enterprise, Edu 같은 업무용 플랜에서 제공돼요. 무료나 Plus라면 1번에서 받은 설명서 내용을 채팅에 붙여 넣고 시작하세요.

⑤ 실제로 해 보면 이렇게 나와요

에트가 클로드 코드에서 설명서 만들기부터 새 대화창 첫 실행까지 돌려 본 결과

① 인터뷰: 질문 8개가 한 번에 하나씩 왔어요.

② 설명서: 답한 내용이 아래 "견본 설명서"로 정리됐어요. 이유를 모르면 "원인 확인 필요"로 적는 줄처럼 AI가 직접 덧붙인 줄도 몇 개 있어요. 끝까지 답하지 않은 "어떤 숫자를 뽑는지"는 지어내지 않고 "미정" 칸에 남겼어요.

③ 새 대화창에서 실행: "이번 주 주간 보고 써 줘…"라고 하자, 바로 쓰지 않고 미정 3가지(뽑을 항목, 집계 기간, 환불 처리)부터 묻고 지금 자료로 계산한 표를 보여 줬어요(시험용 가상 자료).

2. 잘 나온 양식 저장

이럴 때 써요: 같은 양식을 매번 새로 만들고 있을 때

결과물을 만든 대화창에 이어서 붙여 넣기 👇🏻

이번에 잘 나온 [결과물]을 양식 파일로 저장해 줘. 바뀌는 내용은 빈칸으로 바꾸고, 설명서(SKILL.md)에 "[결과물]을 쓸 땐 이 양식부터 열기"라고 한 줄 추가해 줘. 파일을 직접 만들 수 없으면 두 파일 내용을 모두 보여 줘.

✅ 받는 결과: 숫자와 내용만 비운 양식 파일이 생기고, 설명서에 한 줄이 추가돼요.

💡 설명서가 길어지면 자주 안 보는 내용은 다른 파일로 나누세요. 공식 권장은 설명서 본문 500줄 아래예요.

3. 제출 전 완료 검사

이럴 때 써요: 결과를 하나하나 열어 확인하는 데 시간이 많이 들 때

쓴 AI가 자기 결과를 채점하면 통과했다고 말하기 쉬워요. 그래서 채점은 새 대화창에 맡겨요.

먼저 기준 만들기. 잘 나온 결과물을 보여 주면 기준을 뽑아 줘요.

채팅창에 붙여 넣고 [ ] 자리에 결과물 넣기 👇🏻

아래는 잘 나온 [결과물 이름]이야. 왜 잘 나왔는지 분석해서 다음 결과물을 채점할 완료 기준 5개로 바꿔 줘. 기준마다 "무엇을 보여 줘야 통과인지"까지 적어 줘. "꼼꼼하다"처럼 눈으로 확인할 수 없는 말은 쓰지 마. [결과물 붙여넣기]
나쁜 기준좋은 기준
출처를 확인했다숫자마다 시트나 파일 이름이 적혀 있다
내용이 정확하다합계가 항목별 숫자를 더한 값과 맞다
꼼꼼하게 썼다다음 주 할 일이 2개 이상 있다

다음은 새 대화창에서 채점하기. 결과물을 쓴 대화가 아니라 새 대화창에 붙여 넣으세요.

새 대화창에 붙여 넣기 👇🏻

너는 이 결과물을 처음 보는 채점자야. 아래 완료 기준을 하나씩 채점해 줘. 순서를 지켜 줘. 기준마다 먼저 근거 문장을 결과물에서 그대로 옮겨 적고, 숫자는 직접 다시 계산한 다음, 맨 끝에 통과나 실패를 적어. 근거를 못 찾으면 실패야. 칸은 기준, 근거, 다시 계산, 결과 순서의 표로 적어 줘. 맞춤법과 말투는 채점하지 마. [완료 기준] [결과물]

✅ 받는 결과: 기준마다 근거와 결과가 적힌 표가 나와요. 에트가 일부러 틀리게 쓴 주간 보고를 3번 넣었을 때 틀린 합계와 빠진 항목을 3번 다 잡았고, 멀쩡한 보고는 통과시켰어요.

새 대화창 채점 결과 표. 기준, 근거, 다시 계산, 결과 칸에 다섯 기준이 모두 실패로 나온 예시
에트가 일부러 틀리게 쓴 주간 보고를 채점한 결과예요.

❌ 실패가 나오면: 실패 칸을 결과물을 쓴 대화에 붙여 넣고 고쳐 달라고 하세요. 고친 결과는 다시 새 대화창에서 채점해요. 완성본만 채점하세요. 초안을 넣으면 아직 채우지 못한 기준이 실패로 나와요.

4. 틀린 설명서 고치기

이럴 때 써요: 같은 실수를 채팅으로 계속 고치고 있을 때

실수가 나온 대화창에 이어서 붙여 넣기 👇🏻

방금 결과에서 [실수]가 있었어. 채팅으로 고치지 말고, 다음엔 안 빠지게 설명서(SKILL.md)에 규칙을 추가해 줘. 그다음 같은 업무로 다시 해 봐. 모르는 내용은 지어내지 말고 "확인 필요"로 적어 줘.

✅ 받는 결과: 설명서에 규칙이 추가되고, 그 규칙대로 다시 쓴 결과가 나와요.

고친 뒤엔 3가지로 시험하기. 앤트로픽도 시험 상황을 3개 이상 두라고 권해요.

설명서가 있는 대화창에 붙여 넣기 👇🏻

이 설명서를 시험할 실제 요청 3개를 만들어 줘. 평범한 경우 1개, 자료가 빠진 경우 1개, 예외 상황 1개. 요청마다 잘 됐는지 볼 기준도 한 줄씩 적어 줘.

시험은 새 대화창에서 하세요. 설명서를 만든 대화는 맥락을 다 알고 있어서 빈틈이 안 보여요.

한 달에 한 번은 묶어서 복습하기. 이번 달에 고친 내용을 모아 두 번 이상 반복된 실수만 찾게 하세요.

채팅창에 붙여 넣고 [ ] 자리 채우기 👇🏻

아래는 이번 달 결과물에서 내가 고친 내용이야. 한 번만 나온 실수는 빼고, 2번 이상 반복된 실수만 찾아 줘. 그리고 설명서에 추가할 규칙을 한 줄씩 제안해 줘. 설명서를 바로 고치지 말고 수정안만 보여 줘. [고친 내용] [지금 설명서]

✅ 받는 결과: 반복된 실수 표와 설명서 수정안이 나와요. 읽어 보고 맞는 것만 넣으세요.

에이전트 자가 진단표

내 상황에 맞는 줄부터 보세요.

내 상황먼저 할 일
매번 일하는 방식을 다시 설명한다스킬(설명서) 추가 → 1. 업무 설명서 만들기
같은 실수가 반복된다설명서 고치기 → 4. 틀린 설명서 고치기
결과 확인에 시간이 많이 든다완료 기준과 새 대화창 채점 → 3. 제출 전 완료 검사
일이 너무 많아 동시에 나눠 돌려야 한다역할 나누기 → 자주 묻는 질문 "에이전트를 여러 개 꼭 만들어야 하나요?"
권한이나 고객 자료를 섞으면 안 된다역할 나누기 → 자주 묻는 질문 "에이전트를 여러 개 꼭 만들어야 하나요?"

스킬과 에이전트는 함께 쓸 수 있어요. 위 1~3번째 줄을 해 본 뒤에 늘려도 늦지 않아요.

자주 묻는 질문

AI가 스킬을 안 꺼내요
스킬이 켜져 있는지 보고, description에 언제 쓰는지 구체적으로 적어 주세요. 그래도 안 되면 요청에 "주간 보고 스킬을 써서"라고 직접 적으세요.
스킬 메뉴가 안 보여요
클로드는 설정 → Capabilities에서 코드 실행과 파일 만들기가 켜져 있는지 보세요. 제미나이와 챗GPT 조건은 '④ 파일로 저장해 스킬로 등록하기'에 있어요. 회사 계정이면 관리자가 막아 뒀을 수 있어요.
ZIP을 올렸는데 오류가 나요
폴더 이름이 스킬 이름과 같은지, 폴더 안에 설명서 파일이 있는지 보세요. ZIP을 열었을 때 파일이 바로 나오지 않고 폴더가 먼저 나와야 해요. 파일 이름이 SKILL.md인지(.txt가 붙지 않았는지)도 보세요.
채점이 전부 통과로 나와요
기준이 넓으면 그렇게 나와요. "출처를 확인했다" 대신 "숫자마다 시트나 파일 이름이 적혀 있다"처럼 근거를 보여 줘야 통과하는 말로 바꾸세요.
3번 고쳐도 같은 항목이 실패해요
설명서에 통과 조건이 빠져 있을 수 있어요. 그 항목을 어떻게 해야 통과인지 설명서에 적어 주세요.
에이전트를 여러 개 꼭 만들어야 하나요?
일이 너무 많아 동시에 나눠야 하거나 권한을 나눠야 할 때 늘리면 돼요. 앤트로픽 공식 글의 기준도 일이 한 에이전트가 감당할 양을 넘을 때예요.

켜기 전에 확인

설명서와 폴더에 비밀번호, API 키를 넣지 마세요. 남이 만든 스킬은 믿는 곳에서 받고, 동료가 준 것도 켜기 전에 파일을 읽어 보세요.

링크 모음

매일 업데이트되는 가장 정확한 AI 핵심 정보, 지금 팔로우하고 절대 놓치지 마세요.
@ai.trend.kr