AI 활용 꿀팁, 반복 지시를 스킬 파일 하나로 저장하는 법
AI에게 같은 설명을 매번 다시 타이핑하는 분께 맞습니다. 반복 지시를 스킬 파일 하나로 저장하는 방법과 자동 실행에 대한 오해, 스킬을 짧게 쓰는 기준을 정리했습니다.
반복하는 지시는 폴더 하나와 SKILL.md 파일 하나로 저장해 두면 다시 타이핑하지 않아도 됩니다. 스킬은 관련 있다고 판단될 때만 읽히므로, 반드시 실행하려면 이름을 직접 불러야 합니다.
내가 이 대화에서 두 번 이상 반복해서 시킨 지시를 찾아 줘. 그중 하나를 골라 SKILL.md 초안으로 만들어 줘. - 맨 위에 "언제 이 지침을 쓸지"를 한 문장으로 - 그 아래에 "무엇을 할지"를 짧게 - 본문은 500줄 이하로 만든 뒤 저장할 폴더 위치도 알려 줘.
AI 활용 꿀팁은 별도 설치 없이 오늘 바로 써먹을 수 있는 짧은 사용법을 뜻합니다. 이 글에서는 공식 문서에 나온 기능 중에서, 직접 써 보고 진짜 시간이 줄어든 것만 골라 정리했습니다.
왜 이 팁이 필요한가요
AI를 매일 쓰다 보면 같은 설명을 계속 반복하게 됩니다. "이 파일 검토할 때는 이런 순서로 봐 줘", "커밋 메시지는 이 형식으로 써 줘" 같은 지시를 대화창을 새로 열 때마다 다시 타이핑하는 경우가 많습니다.
저도 처음엔 매번 새로 설명했습니다. 대화가 길어질수록 같은 문장을 복사해 붙여넣는 일이 반복됐고, 그러다 한 번은 지시를 빠뜨려서 원하지 않는 결과를 받은 적도 있습니다.
꿀팁 1. 반복 지시를 파일 하나로 저장합니다
공식 문서에 따르면 에이전트 스킬(Agent Skills)은 반복 작업 지침을 파일 하나에 저장해 두면, 클로드가 특정 작업을 할 때 필요한 순간에 알아서 읽어서 쓰는 기능입니다. 폴더 하나와 SKILL.md 파일 하나만 있으면 됩니다.
스킬 폴더 만들기
~/.claude/skills/원하는이름/ 폴더를 만듭니다.
mkdir -p ~/.claude/skills/원하는이름SKILL.md에 언제, 무엇을 할지 적기
그 안에 SKILL.md 파일을 만들고, 맨 위에 "언제 이 지침을 쓸지"와 "무엇을 할지"를 적습니다.
관련 요청을 해서 확인하기
다음부터는 관련 요청을 하면 AI가 이 파일을 알아서 찾아 읽습니다.
꿀팁 2. 무조건 실행되는 게 아니라는 걸 알아 둡니다
공식 문서는 클로드가 요청과 관련 있다고 판단할 때만 스킬 본문을 읽어 온다고 설명합니다. 즉 파일을 만들어 둔다고 항상 자동 실행되는 게 아닙니다.
반드시 실행시키고 싶으면 /스킬이름처럼 이름을 직접 불러서 수동으로 호출하면 됩니다.
꿀팁 3. 스킬 본문은 500줄 아래로 짧게 씁니다
공식 문서는 SKILL.md 본문을 500줄 이하로 유지하고, 자세한 내용은 별도 파일로 분리하라고 권합니다.
처음부터 완벽하게 쓰려고 하면 오히려 안 씁니다. 자주 반복되는 지시 한두 줄만 먼저 넣고, 쓰면서 늘려 가면 됩니다.
제가 직접 써 본 결과
저는 커밋 메시지 형식과 파일 검토 순서를 스킬 두 개로 만들어 뒀습니다. 처음 만들 때는 "이걸 써서 얼마나 줄어들까" 싶었는데, 반복 지시를 다시 타이핑하지 않게 된 것만으로도 체감이 컸습니다.
자주 하는 실수
스킬을 열 개 넘게 만들었다가, 설명이 서로 겹쳐 AI가 엉뚱한 스킬을 불러온 적이 있습니다. 그 뒤로는 스킬마다 "언제 쓰는지"를 한 문장으로 뚜렷하게 구분해 적습니다.
자주 묻는 질문
스킬을 만들면 클로드 웹이나 다른 도구에서도 그대로 쓰이나요?
아닙니다. 공식 문서에 커스텀 스킬은 서로 자동 동기화되지 않는다고 명시돼 있습니다. 클로드 코드에서 만든 스킬은 파일 기반이라 클로드 코드에서만 쓰입니다.
여러 개 만들면 느려지나요?
공식 문서에 따르면 스킬 설명 목록은 컨텍스트 창(AI가 한 세션에서 기억하는 공간)의 1%만 차지합니다. 개수 자체의 상한은 문서에 없습니다. 다만 설명이 겹치면 잘못 호출될 수 있으므로 개수보다 구분을 신경 써야 합니다.
꼭 개발자만 쓸 수 있나요?
아닙니다. 폴더를 만들고 마크다운(텍스트에 간단한 기호로 서식을 넣는 문서 형식) 파일에 지침을 적는 것뿐입니다. 코드를 몰라도 됩니다.
정리
반복 지시를 파일로 저장하는 방법은 공식 문서로 확인했고 저도 실제로 씁니다. 오늘 바로 폴더 하나 만들어 보는 것부터 시작하면 됩니다.