에이전트 스킬 설치하고 관리하는 법: SKILL.md 읽는 법부터

스킬은 파일 묶음입니다

스킬북에서 소개하는 스킬은 대부분 SKILL.md라는 설명 파일과, 그 파일이 참조하는 스크립트·예시·참고 문서로 이루어져 있습니다. AI 에이전트는 SKILL.md의 설명을 읽고 ‘이 작업에는 이 스킬을 써야겠다’고 판단한 뒤, 적힌 절차대로 일을 합니다. 그래서 SKILL.md 한 파일만 복사하면 보조 파일이 빠져 제대로 동작하지 않을 수 있습니다.

SKILL.md를 읽는 순서

맨 위의 이름(name)과 설명(description)을 먼저 봅니다. 설명은 에이전트가 스킬을 언제 쓸지 고르는 기준이 되므로, 내가 원하는 상황이 여기에 적혀 있는지 확인하세요.

본문에서는 준비물과 절차를 봅니다. 어떤 프로그램이 설치되어 있어야 하는지, 어떤 외부 서비스에 연결하는지, 어떤 파일을 만들거나 고치는지가 적혀 있습니다.

마지막으로 참조 파일 목록을 확인합니다. scripts, references, assets 같은 폴더가 언급되어 있다면 함께 내려받아야 합니다.

설치 전에 보안부터 확인하세요

스킬은 에이전트에게 명령을 실행하게 할 수 있습니다. 출처가 분명한 저장소인지, 최근에 관리되고 있는지, 스크립트가 무엇을 하는지 한 번은 열어 보세요. 특히 외부 주소로 데이터를 보내거나, 비밀번호·API 키를 읽거나, 파일을 지우는 명령이 있다면 이유가 납득될 때만 설치하세요.

잘 모르겠다면 에이전트에게 ‘이 스킬의 스크립트가 어떤 동작을 하는지 설치 전에 설명해 줘’라고 먼저 물어보는 것도 방법입니다.

설치 위치와 방법

에이전트마다 스킬을 두는 폴더가 다릅니다. 개인용으로 모든 프로젝트에서 쓸 스킬은 사용자 폴더 아래의 스킬 디렉터리에, 특정 프로젝트에서만 쓸 스킬은 프로젝트 안의 스킬 폴더에 두는 방식이 일반적입니다. 정확한 경로는 쓰는 에이전트의 공식 문서를 확인하세요.

스킬북의 각 스킬 페이지에는 에이전트에게 그대로 붙여 넣을 수 있는 설치 요청 문장이 있습니다. 이 문장을 쓰면 에이전트가 저장소에서 필요한 파일을 함께 가져오고, 설치 후 인식 여부까지 확인합니다.

설치 후 확인할 것

에이전트에게 ‘지금 쓸 수 있는 스킬 목록을 보여 줘’라고 해서 새 스킬이 보이는지 확인합니다. 그다음 간단한 예제로 한 번 실행해 보세요. 처음부터 중요한 작업에 쓰기보다, 결과를 쉽게 확인할 수 있는 작은 작업으로 시험하는 편이 안전합니다.

스킬이 많아지면 생기는 문제

비슷한 설명을 가진 스킬이 여러 개 있으면 에이전트가 엉뚱한 스킬을 고를 수 있습니다. 쓰지 않는 스킬은 정리하고, 겹치는 스킬은 하나만 남기세요. 스킬마다 어떤 용도로 설치했는지 짧게 메모해 두면 나중에 정리할 때 편합니다.

원본 저장소가 업데이트되면 내 스킬은 자동으로 바뀌지 않는 경우가 많습니다. 자주 쓰는 스킬은 몇 달에 한 번 원본의 변경 내역을 확인해 보세요.

내 스킬 직접 만들기

반복해서 설명하는 작업이 있다면 직접 스킬을 만들어도 됩니다. 언제 쓰는지(설명), 무엇이 필요한지(준비물), 어떤 순서로 하는지(절차), 결과가 어떤 모양인지(형식)를 적으면 기본 형태가 완성됩니다. 스킬의 개념은 AI 스킬이란 무엇인가에서, 다양한 예시는 전체 스킬 목록에서 볼 수 있습니다.

참고

서비스의 요금, 기능, 약관은 바뀔 수 있으니 중요한 결정 전에는 각 서비스의 공식 안내를 다시 확인하세요. 내용에 오류가 있으면 문의·오류 제보로 알려 주세요. 다른 가이드 보기