- Published on
- 약 3분
프롬프트에서 스킬로
- Authors
- Name
- 스타차일드
AI를 오래 쓴 사람의 메모장에는 비슷한 문장들이 쌓여 있다. 회의록을 정리할 때 붙여 넣는 지시, 코드 리뷰를 맡길 때 쓰는 기준, 블로그 글을 다듬을 때 지키게 하는 규칙. 잘 듣는 프롬프트를 찾으면 복사해 두었다가, 필요할 때마다 다시 붙여 넣는다.
이 방식에는 두 가지 불편이 있다. 매번 붙여 넣어야 한다는 것, 그리고 모든 지시를 늘 붙여 둘 수는 없다는 것이다. 지시가 열 개, 스무 개로 늘어나면 대화가 시작될 때마다 그 전부를 읽히는 것은 낭비이고, 지시끼리 서로 부딪히기도 한다.
필요할 때만 펼치는 설명서
2025년 10월 16일 앤트로픽은 에이전트 스킬(Agent Skills)을 내놓았다. 스킬은 폴더 하나다. 그 안에 SKILL.md라는 파일이 있고, 필요하면 참고 문서나 스크립트를 함께 넣는다. 핵심은 스킬을 읽히는 방식에 있다. 앤트로픽은 이것을 점진적 공개(progressive disclosure)라고 불렀다.
에이전트가 스킬을 읽는 세 단계
처음에는 이름과 설명만
깔려 있는 모든 스킬의 name과 description 두 줄만 미리 읽어 둔다
쓸 때가 되면 본문을
지금 일과 맞는 스킬이라고 판단하면 SKILL.md 전체를 읽는다
더 필요하면 딸린 파일을
본문이 가리키는 참고 문서나 스크립트는 정말 필요할 때만 연다
책장에 설명서를 꽂아 두고, 평소에는 책등의 제목만 보다가 필요할 때 그 책을 펼치는 것과 같다. 그래서 스킬은 많이 깔아 두어도 부담이 적다. 반대로 말하면, 책등의 제목에 해당하는 설명이 부실하면 그 스킬은 영영 펼쳐지지 않는다.
두 달 만에 공개 표준으로
스킬은 앤트로픽의 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: 회의 녹취나 메모를 결정, 할 일, 열린 질문으로 나눠 정리한다. 사용자가 회의록, 회의 정리, 미팅 요약을 말할 때 쓴다.
---
# 회의록 정리
- 회의에서 나오지 않은 결정은 만들지 않는다. 애매하면 열린 질문으로 둔다.
- 할 일에는 누가, 무엇을, 언제까지를 적는다. 정하지 않았으면 미정으로 쓴다.
- 맨 위에 한 줄 요약, 할 일은 표로 정리한다.
좋은 스킬을 쓰는 법
- 설명이 절반이다. description에는 무엇을 하는지와 함께 언제 꺼내야 하는지를 적는다. 사용자가 실제로 쓸 법한 말("회의록", "미팅 요약")을 넣어 두면 에이전트가 알맞은 때를 알아본다.
- 하나의 스킬에 하나의 일. 글쓰기 규칙과 배포 절차를 한 스킬에 섞으면 어느 쪽 일에서도 엉뚱한 지시가 따라온다.
- 일반론은 빼고 나만 아는 것을 쓴다. "꼼꼼히 하라" 같은 말은 모델이 이미 안다. 우리 팀의 커밋 규칙, 자주 하는 실수, 확인할 명령처럼 모델이 모르는 것을 적는다.
- 본문은 짧게, 긴 자료는 따로. 본문은 핵심 규칙과 순서만 두고, 긴 참고 자료는 딸린 파일로 빼 둔다. 필요할 때만 열린다.
- 끝내는 기준을 넣는다. 무엇이 확인되면 다 된 것인지 적어 두면, 에이전트가 끝났다고 말하기 전에 스스로 점검한다.
남이 만든 스킬을 깔 때
스킬은 에이전트가 그대로 따르는 지시이고, 스크립트를 품을 수도 있다. 앤트로픽도 믿을 만한 곳의 스킬만 깔고, 낯선 스킬은 함께 든 파일과 스크립트를 먼저 읽어 보라고 권한다. 특히 낯선 바깥 주소로 무언가를 보내라는 지시가 들어 있다면 의심해야 한다. 앱을 설치하기 전에 권한을 확인하듯, 스킬도 깔기 전에 한 번 읽어 보는 습관이 필요하다.
이 서재의 스킬 모음에는 한국어로 쓴 스킬과, 널리 쓰이는 공개 스킬을 한국어 설명과 설치 명령으로 정리해 두었다. 프롬프트는 한 번 붙여 넣는 지시이고, 스킬은 깔아 두고 계속 쓰는 지시다. 메모장에 쌓인 프롬프트 가운데 세 번 넘게 붙여 넣은 것이 있다면, 그 프롬프트가 첫 스킬 후보다.
참고한 자료
- 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에 손발을 다는 표준말은 잘하지만 아무것도 만질 수 없던 AI에게 파일과 달력과 데이터베이스를 쥐여 주는 공통 규격이 있다. 2024년 11월 앤트로픽이 내놓은 MCP는 1년 만에 경쟁사들까지 받아들이는 표준이 되었다. 표준이 왜 이렇게 빨리 퍼졌는지, 그리고 손발이 생긴 AI를 어떻게 안전하게 부릴지 정리한다.
- 블로그개발자는 AI로 정말 빨라졌을까2025년 여름, 한 연구소가 숙련된 개발자 16명을 데리고 AI 도구의 효과를 무작위 실험으로 쟀다. 개발자들은 AI 덕에 20% 빨라졌다고 믿었지만 실제로는 19% 느려져 있었다. 반년 뒤 같은 실험을 다시 하려 하자 이번에는 AI 없이 일하겠다는 사람을 구하기 어려웠다. 느낌과 측정이 어긋나는 자리에서 생산성을 재는 법을 생각해 본다.
- 가이드북AI에게 일을 잘 시키는 법: 프롬프트와 맥락 설계LLM과 생성형 AI 트랙
시리즈
AI와 일하는 법 (6/8)
AI가 어떻게 움직이고 어디서 틀리는지 공부하고, 일에 바르게 쓰는 법을 따져 보는 글
함께 읽을 글
- 노트북으로 필기하면 덜 배울까2014년 한 논문은 노트북으로 필기한 학생이 손으로 쓴 학생보다 개념 문제를 못 푼다고 보고했고, 이 결과는 강의실 노트북 금지의 근거로 널리 쓰였다. 그런데 2019년과 2021년에 같은 실험을 다시 해 보니 뚜렷한 차이가 나오지 않았다. 필기 도구보다 학습을 더 크게 가르는 것이 무엇인지 연구들을 나란히 놓고 따져 본다.
- 잊어버리는 속도에 맞춰 복습한다: 라이트너 상자에서 SM-2까지간격을 두고 복습하면 오래 남는다는 것은 140년 전부터 알려진 사실이다. 어려운 것은 언제 복습할지 정하는 일이다. 종이 카드를 상자 칸으로 옮기던 1970년대의 방법부터, 대답의 질에 따라 다음 날짜를 계산하는 1987년의 알고리즘, 그리고 지금의 암기 앱까지. 복습 날짜를 정하는 코드를 직접 돌려 본다.
- 종이로 읽을 때와 화면으로 읽을 때같은 글을 종이와 화면으로 나눠 읽힌 연구 54건, 17만 명의 결과를 모아 보니 종이 쪽의 이해도가 조금 높았다. 차이는 시간에 쫓길수록, 정보가 빽빽한 글일수록 커졌고, 화면에 익숙한 세대라고 줄어들지 않았다. 더 흥미로운 것은 화면으로 읽은 사람들이 자기가 더 잘 이해했다고 믿었다는 점이다. 화면 앞에서 우리가 놓치는 것에 대하여.