Skill 특집 입문: 프롬프트에서 재사용 가능한 AI 워크플로우로

과거에는 많은 사람이 AI를 쓸 때, 같은 프롬프트를 반복해서 복사해 붙여 넣는 방식이었다. 글을 고정된 형식으로 쓰게 하거나, 데이터를 정리하고, 보고서를 만들고, 코드를 점검하고, MDX를 출력하고, PPT를 만들고, 이력서를 수정하는 식이다. 이런 방식은 확실히 동작하지만, 문제도 분명했다. 매번 규칙을 새로 설명해야 했고, 모델이 형식을 잊어버리기 쉬웠으며, 복잡한 절차는 안정적으로 재현하기 어려웠다.

Skill이 등장한 목적은 바로 이 문제를 해결하기 위해서다.

한마디로 Skill은 일종의 재사용 가능한 AI 워크플로우 명세서다. 특정 유형의 과제를 수행하는 방법, 형식 요구사항, 예시, 스크립트, 템플릿, 리소스 파일을 하나로 묶어 AI가 관련 작업을 만났을 때 자동으로 호출하게 함으로써 반복 작업을 더 안정적으로 수행하게 만든다.

OpenAI에서 ChatGPT Skill을 정의할 때도 비슷하게 말한다. Skill은 재사용 가능하고 공유 가능한 워크플로우로, ChatGPT가 특정 작업을 더 좋고 일관되게 수행하도록 돕는다. Skill은 설명, 예시, 심지어 코드를 포함할 수 있다.

Anthropic의 Claude Skill 정의도 거의 동일하다. Skill은 보통 설명, 스크립트, 리소스를 담은 폴더로 구성되며, Claude가 적절한 작업에서 동적으로 로드해 특정 상황의 성능을 끌어올린다.

이 관점에서 보면 Skill은 단순한 “고급 프롬프트”가 아니라, 프롬프트·템플릿·프로세스·도구 자원을 묶어 반복 호출 가능한 능력으로 굳혀 놓은 것이다.

1. Skill은 정확히 무엇인가?

Skill은 세 가지를 합친 것이라고 볼 수 있다.

1. 설명서: AI가 언제 이 Skill을 사용해야 하며, 사용할 때 어떤 규칙을 지켜야 하는지 알려 준다. 2. 템플릿과 예시: 고정된 출력 형식, 참고 케이스, 스타일 요구사항을 제공한다. 3. 스크립트와 리소스: 더 고급 시나리오에서는 Python 스크립트, 설정 파일, 브랜드 자료, 데이터 처리 도구 등을 추가할 수 있다.

단순한 작업이라면 Skill이 SKILL.md 파일 하나로 끝나기도 한다. 복잡한 작업은 Skill이 전체 폴더로 구성될 수 있으며, 안에 이런 내용이 들어갈 수 있다.

• my-skill/
• SKILL.md
• scripts/process_data.py
• templates/report_template.md
• references/style_guide.md

가장 핵심은 SKILL.md다. 대체로 다음 내용을 담당한다.

• 이 Skill이 무엇을 위한 것인지
• 언제 트리거되어야 하는지
• 작업 수행 단계
• 출력 형식
• 주의사항
• 어떤 스크립트를 호출하거나 어떤 파일을 참고할 수 있는지

OpenAI API 문서에서도 Skill을 SKILL.md 매니페스트를 가진 파일 패키지로 설명한다. 즉, 프로세스와 규칙을 정착시키는 데 쓰인다. Codex Agent Skills 문서도 마찬가지로, Skill은 보통 SKILL.md가 들어간 디렉터리이며 스크립트, 참고자료, 리소스 파일을 함께 가질 수 있다고 강조한다.

2. Skill과 프롬프트의 차이

많은 사람이 처음 Skill을 보면 “고급 프롬프트 아닌가?”라고 생각한다. 반은 맞고, 반은 모자란 이해다.

프롬프트는 일회성 지시인 반면, Skill은 장기적으로 재사용 가능한 프로세스 자산이다.

예를 들어 매번 이렇게 입력한다고 해보자.

이 글을 MDX 형식으로 바꿔주고, 원문은 유지하되 생략하지 말고, 제목 계층을 고치고, 링크는 클릭 가능한 형식으로 바꿔줘.

이건 프롬프트다.

하지만 이런 작업을 자주 한다면, 규칙을 mdx-formatter Skill로 작성해둘 수 있다. 이후 “MDX로 바꿔줘”라고 말하면 AI가 해당 Skill을 기반으로 고정된 절차를 자동으로 실행한다.

OpenAI Cookbook은 Skills의 위치를 잘 잡아준다. Skill은 프롬프트와 도구의 중간층이다. 프롬프트가 일반 동작을 정의하고, 도구가 원자적 능력을 제공하며, Skill은 반복 실행 가능한 프로세스·설명·스크립트·자원을 패키징한다.

즉 Skill의 가치는 말이 이쁘게 쓰였느냐가 아니라, 특정 유형의 작업을 반복한 경험을 축적해 AI가 비교적 안정적으로 같은 흐름으로 실행하게 만들 수 있느냐에 있다.

3. Skill, Custom GPT, Project, Tool의 차이

빠르게 구분하려면 다음 표를 보면 된다.

예를 들어 보면:

• AI에게 “이 글 다듬어줘”라고 하는 건 프롬프트다.
• “공식 계정 글 다듬기 Skill”을 만드는 건 Skill이다.
• “AI 글을 전담으로 쓰는 GPT”를 만드는 건 Custom GPT다.
• 모든 사이트 글·이미지·코드를 한 공간에 넣고 장기 유지관리하는 건 Project다.
• AI가 Python으로 표를 자동 처리하게 하는 건 Tool이다.

Skill이 특히 잘 맞는 문제는 동일한 유형의 작업이 반복되고, 매번 더 안정적인 출력을 원할 때다.

4. Skill의 일반적인 형태

아래는 Markdown 글을 배포 가능한 MDX 글로 정리하는 초간단 Skill 예시다.

---
name: mdx-article-formatter
description: 이 Skill은 사용자가 글을 MDX 형식으로 변환, 다듬기, 또는 게시용 MDX 작성 의도로 요청할 때 사용한다.
---

## MDX Article Formatter

## 이 Skill 사용 시점

사용자가 블로그나 웹사이트에 게시할 글을 MDX 형식으로 변환해 달라고 요청하면 사용한다.

## Workflow

1. 원문의 핵심 의미를 보존하고 중요한 내용을 삭제하지 않는다.
2. 제목 계층을 정리해 글은 첫 줄 `#` 제목으로 시작하고, `##`, `###`를 일관되게 사용한다.
3. 일반 URL을 클릭 가능한 Markdown 링크로 변환한다.
4. 목록 형식, 공백, 문장부호, 코드 블록 구문을 정리한다.
5. 최종 글이 유효한 MDX인지 확인한다.
6. 구조가 부족한 글이면 간결한 서론과 결론을 추가한다.

## 출력 규칙

- 근거 없는 사실을 만들어내지 않는다.
- 톤은 명확하고 자연스럽게, 온라인 게시에 적합하게 유지한다.
- 과도한 불릿 포인트 사용은 피한다.
- 링크가 있으면 유지하고, 클릭 가능하게 만든다.

이 예시는 Skill의 핵심을 보여준다.

• name은 Skill 이름이다.
• description은 모델이 언제 이 Skill을 호출해야 하는지 알려 준다.
• 본문은 구체적인 프로세스와 규칙을 적는다.
• 출력 규칙은 매번 결과를 더 안정적으로 만든다.

실제 Skill을 작성할 때 description 필드는 매우 중요하다. 단순 소개가 아니라 모델이 “이 작업에서 이 Skill을 써야 하는지”를 판단하는 핵심 트리거다. 설명이 명확할수록 오탐/누락 호출 가능성이 낮아진다.

5. 실전에서 쓸 만한 Skill을 설계하려면?

처음부터 너무 복잡하게 짜기보다, 매일 반복되는 작업부터 시작해 복붙하던 프롬프트를 고정된 절차로 정리하는 방식이 가장 실용적이다.

1. 사용 시나리오를 명확히

먼저 이런 질문부터 던져본다. 이 Skill이 어떤 반복 작업을 해결하나?

예를 들면:

• 글을 MDX로 변환
• 소셜 글쓰기: 작은글·공식 계정·블로그를 특정 톤으로 작성
• 이력서와 채용 공고 기반의 자기소개서 생성
• 음성 전사를 구조화된 노트로 정리
• 회사 템플릿 기반 주간보고 생성
• 데이터 테이블 기반 분석 리포트 생성
• 브랜드 규칙에 맞는 PPT 제작
• 코드 규칙 점검

한 개의 Skill은 한 가지 문제에 초점을 두는 것이 좋다. “글쓰기, 코딩, PPT, 분석”을 하나에 다 넣으면 안 된다. 범위가 좁을수록 안정성이 좋아진다.

2. 트리거 조건을 분명히

트리거가 명확할수록 AI가 올바른 시점에 호출한다.

비추천:

This skill helps with writing.

권장:

Use this skill when the user asks to polish, restructure, or convert Chinese blog articles into MDX format for publishing on a personal website.

즉 “이 Skill은 유용하다”로 끝내지 말고, 무슨 작업인지, 입력은 무엇인지, 결과는 무엇인지, 어떤 맥락인지를 분명히 써야 한다.

3. 절차를 단계로 쪼갠다

좋은 Skill은 “잘 해줘” 같은 한 줄 요청이 아니라, 실행 가능한 단계로 나뉜다.

예를 들어 글 처리 Skill은 다음처럼 나눌 수 있다.

1. 원문을 읽고 주제와 구조를 파악한다. 2. 제목 계층을 고친다. 3. 핵심 내용은 유지한다. 4. 필요한 경우 보충 설명을 덧붙인다. 5. 노출된 링크를 Markdown 링크로 바꾼다. 6. MDX 문법을 점검한다. 7. 최종 글을 출력한다.

이 방식은 “글을 다듬어줘” 같은 추상 요청보다 훨씬 안정적이다.

4. 예시를 넣는다

Skill에는 1~3개의 예시를 넣는 것이 좋다. AI에게 입력/출력의 대략적 형태를 보여주는 것이다.

예시는 길지 않아도 좋고, 스타일을 보여주는 정도면 충분하다.

## Example

Input:
다음 AI 학습 리소스를 게시물로 정리해줘:
- https://github.com/datawhalechina/happy-llm
- https://github.com/karpathy/minGPT

Expected output:
- LLM, Agent, 엔지니어링 실무로 구분해 정리
- 각 프로젝트는 소개, 대상 독자, GitHub 링크 포함
- 마지막에 학습 순서를 제시

실제 사용 맥락에 가까울수록 Skill이 더 유용해진다.

5. 계속 반복 개선

Skill은 한 번 쓰고 끝나는 문서가 아니다. 코드처럼 운영하면 된다.

• 트리거가 정확하지 않으면 description을 개선한다.
• 특정 형식이 계속 깨지면 규칙을 보강한다.
• 반복되는 절차는 스크립트로 분리한다.
• 자주 쓰는 참고 자료는 references 폴더로 옮긴다.

Anthropic 공식 자료도 Skill 구축 과정이 보통 기획·테스트·반복 개선·배포·문제 해결을 포함하며, 단순 문장 하나로 끝나는 게 아님을 강조한다.

6. Skill이 특히 잘 맞는 실제 활용처

Skill은 고정된 흐름, 높은 반복 빈도, 안정성 요구가 있는 작업에 가장 적합하다.

1. 콘텐츠 제작

예:

• MDX 글 포맷 정리
• 공식 계정 글 다듬기
• 소셜 플랫폼 제목 생성
• SEO 제목/요약 개선
• 참고자료 링크 정리
• 한·영 번역 톤 통일

이 영역의 핵심은 말투, 구조, 형식, 금기어, 링크 처리다.

2. 업무 문서

예:

• 회사 템플릿 기반 주간보고 작성
• 회의록을 액션 아이템으로 정리
• 자료 기반 PPT 아웃라인 생성
• 브랜드 기준에 맞는 보고서 작성
• 고객 정보를 영업 브리핑으로 정리

이 영역의 핵심은 템플릿, 브랜드 규칙, 고정 항목, 출력 형식이다.

3. 데이터 분석

예:

• CSV를 자동 읽고 분석 요약 생성
• 고정 산출 논리에 따라 지표 계산
• 시각화 차트 생성
• 분석 보고서 출력
• 이상치와 결측치 확인

이 영역은 Python 스크립트와 결합해 분석 절차를 표준화할 수 있다. OpenAI API Skill은 재사용 가능한 파일 패키지를 업로드해 호스팅 또는 로컬 쉘 환경에서 사용할 수 있어 코드 실행이 필요한 시나리오와 잘 맞는다.

4. 개발 업무

예:

• 프로젝트 규칙에 맞는 코드 작성
• PR 자동 점검
• 단위 테스트 생성
• 특정 컴포넌트 리팩터링
• 에러 로그 기반 문제 추적

Claude Code와 OpenAI Codex는 이미 Skill 기반의 엔지니어링 시나리오 기능을 제공한다. 개발자 관점에서 Skill은 코딩 Agent가 특정 과업 능력을 갖추게 하는 도구다. 즉 어떤 프로젝트는 어떤 규칙을 따라야 하고, 어떤 순서로 문제를 추적하며, 어떤 스크립트/문서를 우선 참고해야 하는지 알려준다.

7. 초보자가 첫 Skill을 만드는 방법

초보자라면 처음부터 복잡한 API를 파고들 필요가 없다. 가장 단순한 SKILL.md부터 시작하면 된다.

아래 템플릿을 따라 써볼 수 있다.

---
name: your-skill-name
description: 이 Skill은 사용자가 [구체적 작업]을 [구체적 시나리오]에서 요청할 때 사용한다.
---

## Skill Name

## 목적

This skill helps with ...

## 사용 시점

Use this skill when ...

## 입력

The user may provide ...

## Workflow

1. 먼저 ...
2. 다음으로 ...
3. 마지막으로 ...

## 출력 형식

The final output should include ...

## 규칙

- Do ...
- Do not ...

실무적인 조언은 이렇다. 만능 Skill을 만들려 들지 말고, 작고 안정적인 Skill부터 만든다.

예를 들어:

• 글쓰기 마스터 Skill은 만들지 말고
• 중문 블로그 글 MDX 변환 Skill을 만든다.
• 데이터 분석 Skill은 만들지 말고
• CSV 판매 데이터 월간 리포트 Skill을 만든다.
• 코드 어시스턴트 Skill은 만들지 말고
• Next.js 프로젝트 PR 체크 Skill을 만든다.

범위가 구체적일수록 결과가 안정적이다.

8. 추천 학습 순서

Skill을 체계적으로 이해하려면 아래 순서를 추천한다.

1. 먼저 Skill의 본질 파악

OpenAI와 Anthropic의 입문 자료를 먼저 읽고 기본 개념을 잡는다. 핵심은 이렇다: Skill은 일회성 프롬프트가 아니라 재사용 가능하고 공유 가능한 워크플로우이며, 설명·예시·코드를 포함할 수 있다.

권장 순서:

• OpenAI ChatGPT Skills
• OpenAI Academy: Using skills
• Anthropic Skills GitHub

2. Skill 파일 구조 보기

다음은 SKILL.md 작성법, 특히 description, 트리거 조건, 워크플로우, 출력 규칙을 보는 단계다.

권장 순서:

• Anthropic Skill Builder
• OpenAI Skill Creator
• OpenAI API Skills Guide

3. API와 코드 실행 시나리오 학습

Skill을 Agent, 자동화, 데이터 분석, 코드 실행에 쓰고 싶다면 OpenAI API와 Cookbook을 이어서 본다.

이 단계의 핵심은 세 가지다.

1. Skill을 어떻게 생성하고 업로드할지 2. 모델이 작업 중 적절한 Skill을 선택하게 하는 방법 3. 스크립트, 리소스 파일, 실행 환경을 어떻게 묶을지

권장 읽기:

• OpenAI API Skills Guide
• OpenAI Cookbook: Skills in API
• OpenAI API Reference: Skills
• OpenAI Blog: Shell + Skills + Compaction

4. Claude Code와 Codex 시나리오 심화

AI 코딩·코드 어시스턴트·Agent 엔지니어링이 주 관심사라면 Claude Code와 Codex를 집중적으로 본다.

이 자료들은 Skill이 실제 프로젝트에서 어떻게 쓰이는지 이해하는 데 적합하다. 프로젝트 규칙, 자동 점검, 코드 생성, 문서 생성, 테스트 흐름, 배포 흐름 같은 사례가 특히 유용하다.

권장 읽기:

• Claude Code Skills
• Claude Code Overview
• Claude Code Common Workflows
• OpenAI Codex Agent Skills

9. 유용한 GitHub와 문서 링크 정리

아래는 내가 특히 보관해두고 싶은 Skill 학습 자료들이다.

1. OpenAI: Skills in ChatGPT

대상 독자: ChatGPT Skills 기본 개념을 이해하고 싶은 초보자.

이 글은 Skill의 위치를 이해하는 데 좋다. 일회성 프롬프트가 아니라 재사용·공유 가능한 워크플로우이며, 설명·예시·코드를 포함할 수 있다는 점을 잘 정리한다.

2. OpenAI Academy: Using skills

대상 독자: Skill 사용 시나리오를 쉬운 방식으로 이해하고 싶은 사람.

OpenAI Academy 글은 제품 관점·실무 관점이 강해, Skill을 왜 써야 하는지, 그리고 Skill·GPT·Projects가 어떻게 조합되는지 비프로그래머도 이해하기 쉬운 구성이었다.

3. OpenAI API Skills Guide

대상 독자: 개발자, Agent 엔지니어 입문자.

API에서 Skill을 업로드·관리·부착하는 방법을 이해하기에 적합하며, 특히 데이터 분석·코드 실행·자동화 워크플로우에 유용하다.

4. OpenAI Cookbook: Skills in API

대상 독자: 완성된 코드 예시를 보고 싶은 사람.

개념 설명에 그치지 않고 Skill을 만드는 방법, 업로드, 호출 방식까지 보여주는 점이 장점이다.

5. OpenAI Codex Agent Skills

대상 독자: Codex를 쓰거나 AI 코딩 어시스턴트에 관심 있는 사람.

Codex Skills은 코딩·엔지니어링 시나리오 중심으로, Codex에 작업 특화 능력을 붙이는 방식으로 이해하면 된다.

6. Anthropic Skills GitHub

대상 독자: Skill 폴더 구조와 실전 예시를 보고 싶은 사람.

Claude Skills을 학습하기에 매우 중요한 자료다. 설명·스크립트·리소스 파일이 결합돼 특정 작업에서 모델 성능을 끌어올리는 방식이 잘 보인다.

7. Anthropic Skill Builder Guide

대상 독자: Skill 설계를 체계적으로 배우고 싶은 사람.

이 PDF는 일종의 핸드북으로, Skill 기초, 기획·설계, 테스트 반복, 배포/공유, 패턴, 장애 처리까지 다룬다.

8. Claude Code Skills

대상 독자: Claude Code로 개발을 하는 사람.

이 문서는 Claude Code의 능력을 Skills로 확장하고, 커스텀 프로세스를 엔지니어링 가능한 능력으로 정착하는 방법을 이해하기 좋다.

9. openai/skills

대상 독자: OpenAI Skills 예시와 시스템 Skill 작성법을 보고 싶은 사람.

이 저장소는 Skill 명명 방식, 디렉터리 구성, SKILL.md 작성법을 참고하기 좋은 자원이다.

10. Simon Willison: OpenAI Skills API Hands-On Demo

대상 독자: 개발자 실습 기록을 보고 싶은 사람.

개발자 입문에 적합한 실전 기록으로, Skill을 구성·압축·업로드하고 OpenAI API로 호출하는 과정을 보여준다.

10. 바로 사용할 수 있는 한글 작성 Skill 예시

한글 기술 글을 자주 쓰면 아래 Skill부터 가져와 수정해 쓰면 된다.

---
name: chinese-tech-blog-writer
description: 이 Skill은 사용자가 온라인 게시를 위한 중국어 기술 블로그 글의 작성, 다듬기, 재구성, 또는 준비를 요청할 때 사용한다. 이 Skill은 특히 AI, 프로그래밍, GitHub 프로젝트 소개, 튜토리얼, 도구 리뷰에서 유용하다.
---

## Chinese Tech Blog Writer

## 목적

사용자가 산만한 메모, 링크, 스크린샷, 조각난 아이디어를 온라인 게재 가능한 명확한 중국어 기술 글로 정리하는 것을 돕는다.

## Workflow

1. 글의 주제와 타깃 독자를 파악한다.
2. 사용자의 핵심 의미와 중요한 링크를 보존한다.
3. 제목, 서론, 본문 섹션, 결론을 갖춘 구조로 정리한다.
4. 기술 용어를 쉬운 중국어로 설명한다.
5. GitHub 링크가 제공되면 간결한 프로젝트 소개를 추가한다.
6. 일반 URL을 클릭 가능한 Markdown 링크로 바꾼다.
7. 과장된 주장이나 근거 없는 주장을 피한다.
8. 어조를 자연스럽고 실용적으로 유지해 공개 게시물에 적합하게 만든다.

## 출력 형식

- Markdown 또는 MDX 호환 문법을 사용한다.
- 첫 제목은 `#`를 쓴다.
- 주요 섹션은 `##`를 쓴다.
- 가독성을 높일 때만 표를 사용한다.
- 단락은 읽기 쉽게 유지하고 과도하게 쪼개지 않는다.

## 규칙

- 사용자의 원본 핵심 내용을 삭제하지 않는다.
- 프로젝트 기능을 임의로 만들어내지 않는다.
- 온라인 소스를 사용했다면 참고 링크를 반드시 넣는다.
- 내용이 불확실하면 신중한 표현을 쓴다.

이 Skill은 아래 같은 글에 쓰기 좋다.

• GitHub 프로젝트 추천 글
• AI 도구 튜토리얼
• 기술 학습 경로
• 개인 사이트 글
• MDX 블로그 콘텐츠

11. Skill 작성의 흔한 실수

1. 범위를 너무 넓힘

처음부터 “만능 작성 Skill”을 만들면 모든 걸 다루려다 결국 아무 것도 안정적으로 못 만든다.

더 나은 방식은 작은 Skill로 쪼개는 것이다.

• mdx-formatter
• github-project-intro-writer
• resume-polisher
• ai-tool-review-writer
• data-report-generator

2. description이 애매함

description에 “작성 도움”이나 “효율 향상” 같은 표현만 넣으면 안 된다. 모델이 언제, 어떤 입력을, 어떤 결과를 내야 하는지 분명히 적어야 한다.

3. 요구사항만 쓰고 프로세스를 안 씀

나쁜 Skill은 이렇게 쓴다.

좀 더 전문적으로 써 줘.

좋은 Skill은 이렇게 쓴다.

먼저 대상 독자를 파악하고, 다음으로 구조를 정리한 뒤 배경 설명을 보강하고, 마지막으로 링크와 형식을 점검한다.

4. 테스트하지 않음

Skill을 작성한 뒤에는 꼭 3~5개의 실제 작업으로 테스트하는 게 좋다.

• 제대로 트리거되나?
• 출력 형식이 안정적인가?
• 링크가 빠지는 경우가 있는가?
• 내용이 무작정 삭제되지 않는가?
• 존재하지 않는 정보를 지어내지는 않는가?

테스트 후에 계속 수정한다.

12. 내 결론: Skill은 AI 워크플로우 자산화의 시작이다

과거 AI를 사용할 때는 임시 프롬프트에 의존하는 경우가 많았다. 프롬프트의 치명적 한계는 관리 불가, 재사용 불가, 팀 확장 불가였다. Skill의 의의는 바로 경험·프로세스·템플릿·도구를 정착시켜 반복 사용 가능한 능력으로 바꾼다는 점에 있다.

개인에게 Skill은 반복 프롬프트를 줄여 준다. 팀에게 Skill은 출력 기준을 통일해 준다. 개발자에게 Skill은 Agent 시스템의 모듈형 능력으로 진화한다. 콘텐츠 제작자에게 Skill은 자신만의 글쓰기 톤, 글 구조, 게시 규범을 누적해 둔다.

따라서 Skill은 단순한 신기능이 아니라, 새로운 작업 방식이다.

일회성 프롬프트를 재사용 가능한 워크플로우로 업그레이드하고, 개인 경험을 AI가 안정적으로 호출할 수 있는 능력으로 정착한다.

동일한 유형의 작업을 자주 AI에 맡긴다면, 이제는 본인만의 Skill을 직접 만들기 시작할 시점이다.

이 시리즈는 또한 실제 구현 사례도 정리해두었다. 예를 들어 《Skill 인스턴스: Superpowers로 코딩 Agent에 워크플로우 한 벌 붙이기》를 통해 실제 엔지니어링에서 Skill이 어떻게 적용되는지 함께 볼 수 있다.

자주 묻는 질문

Skill과 프롬프트(Prompt)는 무엇이 다른가?

프롬프트는 일회성 지시로, 매번 규칙을 다시 설명해야 한다. Skill은 설명·템플릿·프로세스·스크립트·자원을 묶은 장기 재사용 가능한 프로세스 자산이며, 관련 작업에서 AI가 자동으로 호출해 복잡한 흐름을 더 안정적으로 재현한다.

Skill과 Custom GPT, Project, Tool의 차이점은?

Skill은 고정된 프로세스를 재사용 가능한 능력으로 캡슐화한다. Custom GPT는 특정 용도의 채팅 어시스턴트다. Project는 장기 작업 공간과 컨텍스트를 제공한다. Tool은 AI가 외부 능력을 호출하거나 동작을 실행하도록 한다. Skill은 프롬프트와 도구 사이의 “중간층”으로 보면 된다.

하나의 Skill에 꼭 들어가야 하는 요소는?

핵심은 SKILL.md다. 이 파일이 Skill이 무엇을 하고 언제 트리거되는지(description이 특히 중요), 실행 단계와 출력 규칙을 담당한다. 복잡한 작업은 scripts/, templates/, references/ 같은 디렉터리를 추가할 수 있다.

초보자가 첫 Skill은 어떻게 써야 하나?

매일 반복되는 작업부터 시작한다. 작은 SKILL.md를 먼저 만들고(예: “중국어 블로그 글을 MDX로 변환” 정도), 트리거 조건, 입출력, 단계까지 명확히 적은 뒤 3~5개 실제 작업으로 테스트하고 계속 개선한다.

참고 자료

• OpenAI Help: Skills in ChatGPT
• OpenAI Academy: Using skills
• OpenAI API Docs: Skills
• OpenAI Cookbook: Skills in API
• OpenAI API Reference: Skills
• OpenAI Blog: Shell + Skills + Compaction
• OpenAI Codex: Agent Skills
• GitHub: openai/skills
• GitHub: openai/openai-cookbook
• GitHub: anthropics/skills
• Anthropic Skill Creator
• Anthropic: The Complete Guide to Building Skills for Claude
• Anthropic Docs: Claude Code Skills
• Anthropic Docs: Claude Code Overview
• Anthropic Docs: Claude Code Common Workflows
• Anthropic Docs: Claude Tool Use Overview
• Simon Willison: OpenAI Skills API Hands-On Demo