FreeAILab free-ai-lab

SKILL.md 작성 가이드

심화 튜토리얼

필드 안내 + 복사 가능한 템플릿 10종 + 더 안정적인 스킬을 위한 심화 팁.

한 문장으로 요약하면: SKILL.md는 세 부분만으로 이뤄져요. 헤더는 "AI에게 나를 소개하고 언제 쓰이는지"를 알려 주고, 본문은 "정확히 어떻게 할지"를 말하며, 예시는 "결과물이 어떤 모습인지"를 보여 줘요. 이 글은 필드마다 설명한 뒤 바로 복사해 쓸 수 있는 템플릿 10종을 제공해요.

완전 입문자라면 먼저 4단계 만들기 튜토리얼부터 시작하세요. 이 글은 심화 참고자료예요.

구조 한눈에 보기

--- name: skill-name ← 소문자 kebab-case 식별자 description: 무엇을 하는지 + 언제 사용하는지 ← 가장 중요해요. AI가 이를 보고 활성화 여부를 판단해요 --- # 대제목 (본문: 단계, 규칙, 경계) ## 예시 (입력 → 출력, AI에게 목표 수준을 보여 줘요)
프론트매터 (헤더)

name + description, YAML 형식

본문

구체적 단계 + 경계 + 규칙. 구체적일수록 안정적이에요

예시

입력 → 이상적인 출력, AI가 내놓아야 할 기준을 정의해요

헤더 필드를 잘 쓰기

description이 열쇠예요

description은 "AI가 언제 이 스킬을 떠올리는지"를 결정해요. 사용자의 표현과 닮을수록 성공률이 높아져요.

❌ 너무 막연함 (AI가 언제 써야 할지 몰라요)
description: 광고 문구 작성을 도와줘요
✅ 정밀함 (트리거 시나리오를 빠짐없이 커버)
description: 짧고 바이럴한 스타일로 제품 소개 게시물을 써요. 사용자가 "SNS용 게시물 써 줘", "제품 광고 문구 작성 도와줘"라고 말하거나 제품 정보를 붙여 넣을 때 사용해요.
name의 작명 규칙

소문자 + 하이픈(예: weekly-report-writer)로 기능이 한눈에 보이게 하세요. 공백, 대문자, 비라틴 문자는 쓰지 마세요.

바로 복사해 쓰는 시나리오 템플릿 10종

아래 템플릿 중 하나를 폴더로 저장하면(같은 이름의 SKILL.md 포함) 바로 동작해요 — 예시만 바꾸면 돼요:

1️⃣ 회의록 스킬
--- name: meeting-notes description: 회의 내용을 구조화된 회의 노트로 정리해요. 사용자가 회의 메모를 붙여 넣거나 "오늘 회의 정리해 줘"라고 말할 때 사용해요. --- # 회의 노트 1. 식별 후 표시: 주제, 시간, 참석자 2. 세 섹션으로 정리: "결정 사항 / 남은 할 일 / 미해결 질문" 3. 사람당 할 일 하나, 형식: 담당자 + 할 일 + 기한 (빠진 정보는 [TBD]로 표시) 4. 메모에 없는 정보를 임의로 보충하지 않아요 ## 예시 입력: 오늘 회의에서 제품에 내보내기 기능을 추가하기로 결정했어요. 저는 백엔드를, 동료는 프론트엔드를 담당하고, 금요일에 데모가 있어요... 출력: ### 결정 사항 - 제품에 내보내기 기능 추가 ### 남은 할 일 - 민: 백엔드에서 내보내기 구현 (기한 [TBD])
2️⃣ 이메일 다듬기 스킬 (전문 어조)
--- name: email-polisher description: 엉성한 이메일 초안을 전문적인 이메일로 다듬어요. 사용자가 이메일 초안을 붙여 넣거나 "내 이메일 다듬어 줘"라고 말할 때 사용해요. --- # 이메일 다듬기 1. 핵심 정보는 모두 유지해요 2. 인사, 도입, 마무리의 예의를 높여요 3. 긴 문장은 줄이고, 한 단락에는 하나의 생각만 담아요 4. 출력: 다듬은 이메일 + 3줄 이내의 변경 요약 ## 예시 입력: 부장님, 논의했던 협업 확정됐는데 언제 서명 가능하세요? 출력: 부장님, 앞서 논의한 협업이 확정되었습니다. 진행 일정을 말씀해 주시면 원하시는 시기에 맞춰 서명 절차를 준비하겠습니다. 감사합니다!
3️⃣ 주간 보고서 스킬
--- name: weekly-report description: 흩어져 있는 업무 메모를 명확하고 구조화된 주간 보고서로 바꿔요. 사용자가 메모를 붙여 넣거나 "내 주간 보고서 써 줘"라고 말할 때 사용해요. --- # 주간 보고서 작성 1. 메모를 "이번 주 성과 / 발생한 문제 / 다음 주 계획"으로 정리해요 2. 성과는 중요도순으로 정렬하고 각각 뒷받침 수치를 붙여요 (빠진 것은 [TBD]로) 3. 골라 쓸 수 있는 제목 2가지를 제안해요 4. 사실에만 근거하고 일어나지 않은 일을 지어내지 않아요 ## 예시…
4️⃣ 이력서 다듬기 스킬
--- name: resume-polisher description: 이력서 문장을 더 전문적이고 정량적으로 다듬어요. 사용자가 이력서를 붙여 넣거나 "제 이력서 다듬어 줘"라고 말할 때 사용해요. --- # 이력서 다듬기 1. 행동 동사로 시작해요 (예: "주도했다", "구현했다"), 1인칭 표현은 피해요 2. 가능하면 결과를 수치로 정량화해요 (숫자, 퍼센트). 안 되면 원문을 유지해요 3. 경력 항목은 1~2줄로 유지하고 잔소리와 군더더기를 없애요 4. 출력: 다듬은 목록 + 무엇을 왜 바꿨는지에 대한 한 줄 메모
5️⃣ 프론트엔드 코드 리뷰 스킬
--- name: frontend-code-review description: 프론트엔드 코드의 유지보수성과 접근성을 검토해요. 사용자가 "이 코드 좀 봐 줘"라고 말하거나 코드를 붙여 넣을 때 사용해요. --- # 프론트엔드 코드 리뷰 1. 요소마다 검토: 가독성 / 접근성(aria) / 성능(반복 렌더링) / 보안(XSS) 2. 문제마다 표기: 파일 + 줄, 문제 내용, 제안하는 해결 코드 3. 심각도 순으로 출력을 정렬해요 4. 문제가 없으면 "발견된 문제 없음"이라고 명확히 말해요
6️⃣ 이미지 프롬프트 작성 스킬
--- name: image-prompt-writer description: 장면 묘사를 고품질 영어 이미지 생성 프롬프트로 바꿔요. 사용자가 "이미지 프롬프트 써 줘"라고 말할 때 사용해요. --- # 이미지 생성 프롬프트 1. 영어로 구조화해 출력: 피사체 + 환경 + 조명 + 구도 + 스타일 + 품질 태그 2. 고정 품질 태그로 마무리: high quality, 4k 3. 시나리오에 맞는 스타일 서술을 자동으로 선택해요 (사실적 / 일러스트 / 3D / 포스터) 4. 프롬프트 뒤에 2줄짜리 설명을 붙여요
7️⃣ 강의 노트 정리 스킬
--- name: study-notes description: 흩어진 학습 자료를 구조화된 노트와 학습 카드로 정리해요. 사용자가 자료를 붙여 넣거나 "제 강의 노트 정리해 줘"라고 말할 때 사용해요. --- # 강의 노트 1. 핵심 개념을 추출하고 각각 "한 문장 정의"로 시작해요 2. 주제별로 계층화하고 예시를 보충해요 3. 질문-답 형식의 학습 카드 5장을 만들어요 4. 마크다운으로 출력해 노트 앱에 바로 가져갈 수 있게 해요
8️⃣ 데이터 분석 해석 스킬
--- name: data-interpreter description: 데이터셋(표/숫자)을 해석해 결론과 제안을 제공해요. 사용자가 데이터를 붙여 넣거나 "이 데이터 분석해 줘"라고 말할 때 사용해요. --- # 데이터 해석 1. 먼저 전체 요약을 하고 눈에 띄는 추세/이상치를 나열해요 2. "데이터가 말하는 사실"과 "결론"을 구분하고 결론마다 표시해요 3. 실행 가능한 다음 단계를 최소 3개 제안해요 4. 비교는 표로 보여 줘요
9️⃣ 숏폼 대본 스킬
--- name: short-video-script description: 주제를 30~60초 입담 숏폼 대본으로 바꿔요. 사용자가 "숏폼 대본 써 줘" 또는 "이 글을 영상 대본으로 바꿔 줘"라고 말할 때 사용해요. --- # 숏폼 대본 1. 구성: 3초 훅 + 15초 핵심 + 마무리 행동 유도 2. 입말: 짧은 문장, 편한 어조, 호흡 표시 3. 10초마다 시각 힌트를 줘요 (화면 전환 / 자막) 4. 45초 이내, 약 300단어를 유지해요
🔟 여행 계획 스킬
--- name: travel-planner description: 기간/예산/취향에 맞춰 여행 일정을 만들어요. 사용자가 "여행 계획 도와줘" 또는 "여행 가이드 만들어 줘"라고 말할 때 사용해요. --- # 여행 계획 1. 먼저 조건을 확인해요: 일수, 예산, 출발·도착지, 취향 (미식 / 자연 / 문화) 2. 하루를 오전/오후/저녁으로 나눠 계획해요: 명소 + 교통 + 식사 3. 명소마다 예상 관람 시간을 표시해요 4. 포함: 예상 예산 표 + 실용 팁 3가지 (예: 예약/날씨)

템플릿화의 요점은 이거예요: "반복되는 일상 워크플로"를 스킬로 만드는 건 프롬프트를 즐겨찾기에 저장하는 것보다 한 단계 진한 활용이에요 — 한 번 설치하면 AI가 매번 내 기준을 따라와요.

심화 팁: 스킬을 더 안정적으로 만들기

  • "반대 예시" 추가: 본문에 "~하지 마"를 적으면 과장이 눈에 띄게 줄어요 (예: "데이터를 지어내지 마", "확실하지 않으면 이름을 바꾸지 마")
  • 출력 형식을 지정: "표 형식", "### 제목", "3줄 이내"를 명시적으로 요구하세요 — AI의 출력 구조가 더 안정돼요
  • 예시로 기준 고정: 예시는 장식이 아니에요. AI를 생산 기준에 맞춰 주는 참고본이에요
  • 기계적 작업은 scripts/로: 계산과 반복 포맷팅은 스크립트에 맡기고 SKILL.md는 "지휘"만 하게 하세요
  • 반복하며 다듬기: 입력 3개 테스트 → AI가 틀린 부분을 본문에 추가 → 다시 테스트. 스킬은 쓸수록 정확해져요

더 읽을거리