중급 · 3/9강
스킬: 순서를 적어 둔 파일 하나
스킬은 마법이 아니라 "이렇게 하라"고 적어 둔 문서 하나이고, 에이전트는 그 문서를 읽고 따릅니다.
스킬은 문서 하나입니다
스킬의 중심에는 SKILL.md라는 이름의 마크다운 파일이 있습니다. 열어 보면 사람이 읽을 수 있는 절차서이고 메모장으로도 읽을 수 있습니다. 스킬 폴더에는 그 절차에서 쓰는 프로그램이나 참고 자료가 함께 들어갈 수도 있습니다.
이 코스에서 나중에 설치할 문헌 검색 스킬의 내용을 요약하면 이런 식입니다. 질문을 PICO나 PCC 칸으로 나눌 것. 각 칸 안의 말은 또는로 묶고 칸과 칸은 그리고로 묶을 것. 검토 방식으로 돌릴 때는 사람이 검색식을 승인하기 전에 절대 검색을 시작하지 말 것. 검색 결과를 두고 근거 등급이나 비뚤림 평가를 하지 말 것.
읽어 보면 아시겠지만 이것은 코드가 아니라 업무 지침입니다. 신입에게 건네는 표준작업지침서와 성격이 같습니다. 다른 점은 그 지침을 읽는 쪽이 사람이 아니라 에이전트라는 것뿐입니다.
프롬프트와 무엇이 다를까요
| 프롬프트 | 스킬 |
|---|---|
| 필요할 때마다 새로 씁니다 | 한 번 설치하면 남습니다 |
| 입력에 따라 작업 범위가 달라집니다 | 공통 절차와 산출물 형식을 정해 둡니다 |
| 어떻게 시켰는지는 대화창에만 있습니다 | 절차가 파일로 남아 열어 볼 수 있습니다 |
좋은 프롬프트를 찾아 저장해 두는 것은 개인기입니다. 옆자리 동료가 같은 결과를 내지 못하고, 6개월 뒤의 나도 그때 무엇을 어떻게 시켰는지 재현하지 못합니다. 스킬은 그 개인기를 절차로 바꿔 놓은 것입니다. 여러 사람이 같은 방식으로 일해야 하는 기관에서는 후자가 맞습니다.
프롬프트에도 스킬에도 ‘여기서 멈추고 사람에게 물어라’는 지시를 적을 수 있습니다. 스킬의 장점은 그 지시를 반복해서 사용할 파일로 둔다는 점입니다. 다만 지시가 있다고 항상 지켜지는 것은 아닙니다. 첫 검색에서 승인 전에 실제로 멈추는지 확인합니다.
플러그인은 무엇을 묶나요
플러그인은 스킬과 필요한 실행 프로그램, 연결 설정 등을 함께 배포하는 단위입니다. Claude Code 문서와 Codex 문서는 스킬을 플러그인으로 묶는 방식을 안내합니다. 설치한 파일의 역할은 프로그램마다 다르므로 이름만 같다고 그대로 호환되는 것은 아닙니다.
모델 이름, 실행 프로그램, 점검 절차를 구분해서 읽습니다.
출처 · ethosLab 작성 도해, 2026-09-06. Claude Code·Codex의 스킬 문서와 proof 0.1.0 README.md.
그림을 누르면 원본 크기로 볼 수 있습니다.
기본 과정에서 사용할 플러그인
기본 과정에서는 proof의 참고문헌·표·보고 지침 점검 스킬을 사용합니다. 먼저 작업 폴더를 준비하고 proof 설치로 이어 갑니다. Hermes 문헌 검색 스킬은 선택 자료입니다.
선택 자료에서 더 읽을 두 단어
지금 두 용어만 이름으로 알아 두시면 됩니다.
지식 그래프는 개념을 동그라미로, 개념 사이의 관계를 선으로 그린 그림입니다. 태그와의 차이는 선에 이름이 붙는다는 것 하나입니다. 목록으로 적으면 "신호탐지, 비례보고비, 기계학습"이지만, 그래프로 그리면 "신호탐지가 비례보고비를 사용함", "기계학습이 비례보고비를 보완함"이 됩니다. 글을 쓸 때 필요한 것은 그 구분입니다.
LLM 위키는 여러 논문에 흩어진 같은 개념을 모아 개념마다 한 장으로 정리한 것입니다. 논문별 요약 스무 개로는 서론의 첫 문단이 써지지 않습니다. 비례보고비 한 장, 인과성 평가 한 장으로 모여야 쓸 거리가 생깁니다.
둘 다 모듈 5의 내용입니다. 기본 과정의 원고 점검을 위해 지식 그래프를 먼저 만들 필요는 없습니다.
직접 해 보기약 15분
설치하기 전에 스킬을 한 번 읽어 보십시오. github.com/junhewk/hermes-medical-search 저장소에서 skills/medical-literature-search/SKILL.md 파일을 브라우저로 엽니다. 설치도 로그인도 필요 없습니다.
읽으면서 두 가지를 찾아 아래 작성란에 옮겨 적어 보십시오.
- 에이전트에게 하지 말라고 지시한 문장 하나. 예를 들어 검색 결과를 체계적 문헌고찰이라고 부르지 말라는 문장이 있습니다.
- 사람의 승인 없이는 진행하지 말라고 적힌 자리.
| 찾을 것 | 절차서의 문장과 위치 |
|---|---|
1행
2행
내려받은 두 줄은 스킬을 사용할 때 실제로 지시가 지켜졌는지 대조할 기준입니다.
연구에 적용하면
연구실에서 검색 절차를 표준화하려 할 때 지금까지의 방법은 잘 된 프롬프트를 공유 문서에 붙여 두는 것이었습니다. 스킬은 같은 일을 실행 가능한 형태로 합니다. 절차가 파일이므로 함께 검토할 수 있고, 고친 이력이 남고, 프로토콜의 부록으로 첨부할 수도 있습니다. 심사자가 "이 검색은 어떻게 했습니까"라고 물으면 대화창을 뒤지는 대신 파일을 건네면 됩니다.