Agent Skills

Agent Skills(에이전트 스킬)는 AI 에이전트에게 특정 작업의 절차와 전문 지식을 폴더 하나로 묶어 가르치는 패키징 방식입니다. 핵심은 SKILL.md라는 마크다운 파일에 "이 일은 이렇게 처리해라"라는 설명서를 적어두고, 필요할 때만 AI가 그 설명서를 꺼내 읽게 하는 구조입니다. 그래서 매번 긴 지시를 다시 입력하지 않아도, 회사 보고서 양식이나 사내 규칙 같은 반복 작업 방법을 AI가 그대로 따릅니다.

이 방식은 Anthropic이 2025년 10월 16일 공개했습니다. 그전까지는 특정 작업 방법을 알려주려면 대화창에 매번 길게 설명하거나 복잡한 코드를 붙여야 했습니다. 같은 설명을 사람마다, 작업마다 반복하는 건 비효율적입니다. Agent Skills는 그 노하우를 폴더에 저장해 한 번 만들어두면 계속 재사용하게 만들었습니다. 2025년 12월에는 오픈 표준으로 풀려서 다른 회사 도구에서도 같은 형식을 쓸 수 있게 됐습니다.

구조를 들여다보면 생각보다 단순합니다. 폴더 안 SKILL.md 맨 위에는 스킬의 이름과 설명을 적고, 그 아래에 단계별 지침과 예시를 마크다운으로 씁니다. 복잡한 작업이면 실행할 코드를 담은 scripts 폴더나 참고 문서를 담은 references 폴더, 이미지나 양식 파일을 담은 assets 폴더를 곁들입니다. 코드를 넣을 때는 AI가 그 코드를 직접 실행할지, 아니면 참고용으로 읽기만 할지 분명히 적어두는 게 좋습니다.

여기서 중요한 특징이 점진적 로딩(progressive disclosure)입니다. AI는 평소엔 모든 스킬의 이름과 한 줄 설명만 가볍게 들고 있다가, 지금 작업에 맞는 스킬이라고 판단했을 때만 그 SKILL.md 전체를 꺼내 읽습니다. 더 깊은 내용이 필요하면 그때 references 폴더의 문서까지 펼칩니다. 이렇게 단계를 나눠 꺼내 쓰는 덕분에, 스킬이 수십 개여도 컨텍스트 윈도우라 부르는 작업 기억 공간이 한꺼번에 가득 차지 않습니다.

MCP와 자주 비교되는데, 둘은 역할이 다릅니다. MCP(Model Context Protocol)는 AI를 데이터베이스나 외부 서비스 같은 도구에 연결하는 통로입니다. Agent Skills는 연결이 아니라, 그 도구들을 가지고 일을 어떻게 처리할지 알려주는 지식과 절차입니다. 사람에 비유하면 MCP는 손에 쥐어주는 연장이고, Agent Skills는 그 연장으로 작업하는 방법을 적은 설명서입니다. 둘은 경쟁이 아니라 같이 씁니다.

실제로는 Claude 앱과 Claude Code에서 스킬을 설치해 씁니다. 예를 들어 PDF를 회사 양식에 맞춰 채우는 스킬을 한 번 만들어두면, 다음부터는 파일만 주고 "이 양식으로 정리해줘"라고 하면 AI가 저장된 절차대로 처리합니다. 브랜드 글쓰기 말투, 엑셀 보고서 형식, 디자인 가이드처럼 회사마다 다른 규칙을 스킬로 묶어두면, 누가 작업하든 같은 기준으로 결과가 나옵니다.

잘 만드는 요령도 있습니다. 처음부터 거창하게 쓰기보다, AI가 자주 틀리거나 매번 똑같이 설명해야 하는 지점을 찾아 그 부분만 스킬로 정리하는 게 좋습니다. SKILL.md가 너무 길어지면 내용을 여러 파일로 나눠 필요할 때만 불러오게 합니다. 이렇게 해야 작업 기억 공간을 아끼면서도 지침이 정확하게 전달됩니다.

정리하면 Agent Skills는 AI에게 "이 일은 이렇게 한다"를 폴더로 묶어 가르치고, 필요할 때만 펼쳐 읽게 하는 방식입니다. 외부 도구에 연결하는 MCP와 손발을 맞추면, AI는 연장도 갖추고 그 연장을 제대로 쓰는 방법까지 익힌 일꾼이 됩니다. 두 가지가 함께 있어야 실제 업무에 바로 투입할 수 있는 에이전트가 완성됩니다. 한 번 잘 만든 스킬은 팀 전체가 두고두고 나눠 쓸 수 있어서, 노하우를 쌓아 재사용하는 자산으로도 의미가 큽니다.