Published on
약 3분

프롬프트에서 스킬로

Authors
  • Name
    스타차일드

AI를 오래 쓴 사람의 메모장에는 비슷한 문장들이 쌓여 있다. 회의록을 정리할 때 붙여 넣는 지시, 코드 리뷰를 맡길 때 쓰는 기준, 블로그 글을 다듬을 때 지키게 하는 규칙. 잘 듣는 프롬프트를 찾으면 복사해 두었다가, 필요할 때마다 다시 붙여 넣는다.

이 방식에는 두 가지 불편이 있다. 매번 붙여 넣어야 한다는 것, 그리고 모든 지시를 늘 붙여 둘 수는 없다는 것이다. 지시가 열 개, 스무 개로 늘어나면 대화가 시작될 때마다 그 전부를 읽히는 것은 낭비이고, 지시끼리 서로 부딪히기도 한다.

필요할 때만 펼치는 설명서

2025년 10월 16일 앤트로픽은 에이전트 스킬(Agent Skills)을 내놓았다. 스킬은 폴더 하나다. 그 안에 SKILL.md라는 파일이 있고, 필요하면 참고 문서나 스크립트를 함께 넣는다. 핵심은 스킬을 읽히는 방식에 있다. 앤트로픽은 이것을 점진적 공개(progressive disclosure)라고 불렀다.

에이전트가 스킬을 읽는 세 단계

  1. 처음에는 이름과 설명만

    깔려 있는 모든 스킬의 name과 description 두 줄만 미리 읽어 둔다

  2. 쓸 때가 되면 본문을

    지금 일과 맞는 스킬이라고 판단하면 SKILL.md 전체를 읽는다

  3. 더 필요하면 딸린 파일을

    본문이 가리키는 참고 문서나 스크립트는 정말 필요할 때만 연다

스킬을 백 개 깔아 두어도 평소에 차지하는 자리는 이름과 설명 백 줄뿐이다.

책장에 설명서를 꽂아 두고, 평소에는 책등의 제목만 보다가 필요할 때 그 책을 펼치는 것과 같다. 그래서 스킬은 많이 깔아 두어도 부담이 적다. 반대로 말하면, 책등의 제목에 해당하는 설명이 부실하면 그 스킬은 영영 펼쳐지지 않는다.

두 달 만에 공개 표준으로

스킬은 앤트로픽의 Claude 앱과 Claude Code, API에서 시작했지만 오래 한 회사의 것으로 남지 않았다. 2025년 12월 오픈AI가 ChatGPT와 코딩 도구 Codex에서 같은 꼴의 스킬을 조용히 받아들이기 시작했다는 사실이 알려졌다. 12월 18일 앤트로픽은 스킬 규격을 agentskills.io에 공개 표준으로 내놓았다. 같은 SKILL.md 파일을 여러 회사의 에이전트가 함께 읽을 수 있게 된 것이다. Claude Code는 내 컴퓨터의 ~/.claude/skills 폴더에서 스킬을 찾고, Codex 같은 다른 에이전트도 저마다 정해 둔 스킬 폴더에서 같은 꼴의 파일을 읽는다.

SKILL.md의 생김새

SKILL.md는 맨 위의 머리말 두 줄과 그 아래 본문으로 이루어진다. 머리말의 name은 스킬의 이름이고, description은 이 스킬이 무엇을 하고 언제 써야 하는지다.

회의록을 정리하는 스킬의 SKILL.md. 머리말 두 줄은 늘 읽히고, 본문은 쓸 때만 읽힌다

---
name: meeting-minutes
description: 회의 녹취나 메모를 결정, 할 일, 열린 질문으로 나눠 정리한다. 사용자가 회의록, 회의 정리, 미팅 요약을 말할 때 쓴다.
---

# 회의록 정리

- 회의에서 나오지 않은 결정은 만들지 않는다. 애매하면 열린 질문으로 둔다.
- 할 일에는 누가, 무엇을, 언제까지를 적는다. 정하지 않았으면 미정으로 쓴다.
- 맨 위에 한 줄 요약, 할 일은 표로 정리한다.

좋은 스킬을 쓰는 법

  1. 설명이 절반이다. description에는 무엇을 하는지와 함께 언제 꺼내야 하는지를 적는다. 사용자가 실제로 쓸 법한 말("회의록", "미팅 요약")을 넣어 두면 에이전트가 알맞은 때를 알아본다.
  2. 하나의 스킬에 하나의 일. 글쓰기 규칙과 배포 절차를 한 스킬에 섞으면 어느 쪽 일에서도 엉뚱한 지시가 따라온다.
  3. 일반론은 빼고 나만 아는 것을 쓴다. "꼼꼼히 하라" 같은 말은 모델이 이미 안다. 우리 팀의 커밋 규칙, 자주 하는 실수, 확인할 명령처럼 모델이 모르는 것을 적는다.
  4. 본문은 짧게, 긴 자료는 따로. 본문은 핵심 규칙과 순서만 두고, 긴 참고 자료는 딸린 파일로 빼 둔다. 필요할 때만 열린다.
  5. 끝내는 기준을 넣는다. 무엇이 확인되면 다 된 것인지 적어 두면, 에이전트가 끝났다고 말하기 전에 스스로 점검한다.

남이 만든 스킬을 깔 때

스킬은 에이전트가 그대로 따르는 지시이고, 스크립트를 품을 수도 있다. 앤트로픽도 믿을 만한 곳의 스킬만 깔고, 낯선 스킬은 함께 든 파일과 스크립트를 먼저 읽어 보라고 권한다. 특히 낯선 바깥 주소로 무언가를 보내라는 지시가 들어 있다면 의심해야 한다. 앱을 설치하기 전에 권한을 확인하듯, 스킬도 깔기 전에 한 번 읽어 보는 습관이 필요하다.

이 서재의 스킬 모음에는 한국어로 쓴 스킬과, 널리 쓰이는 공개 스킬을 한국어 설명과 설치 명령으로 정리해 두었다. 프롬프트는 한 번 붙여 넣는 지시이고, 스킬은 깔아 두고 계속 쓰는 지시다. 메모장에 쌓인 프롬프트 가운데 세 번 넘게 붙여 넣은 것이 있다면, 그 프롬프트가 첫 스킬 후보다.

참고한 자료

  • Anthropic, "Introducing Agent Skills" (2025년 10월 16일, 12월 18일 공개 표준 소식 덧붙임)
  • Anthropic Engineering, "Equipping agents for the real world with Agent Skills" (2025년 10월 16일)
  • Agent Skills 규격, agentskills.io
  • Simon Willison, OpenAI의 스킬 도입에 관한 글 (2025년 12월)
  • OpenAI, Codex 스킬 문서

시리즈

AI와 일하는 법 (6/8)

AI가 어떻게 움직이고 어디서 틀리는지 공부하고, 일에 바르게 쓰는 법을 따져 보는 글

  1. 1바이브 코딩의 첫해
  2. 2AI는 왜 그럴듯하게 틀릴까
  3. 3AI에 손발을 다는 표준
  4. 4생각할 시간을 사는 AI
  5. 5개발자는 AI로 정말 빨라졌을까
  6. 6프롬프트에서 스킬로
  7. 7AI의 작업 기억
  8. 8AI 검색 시대에 글이 읽히는 법

기술 라이브러리

혼자 공부한 것을 정리해 두는 개발자의 서재예요. 예제는 직접 돌려 보고 씁니다.

© 2026 기술 라이브러리