프롬프트 작성은 멈추고, 스킬 설치를 시작하라.

만약 Claude Code 같은 AI 코딩 에이전트를 사용한다면, 아마도 수많은 프롬프트 모음을 만들어 왔을 것입니다. 길고 복잡한 것들 말입니다. 세션을 시작할 때 붙여 넣어 에이전트가 특정 방식으로 행동하도록 지시하는 종류의 프롬프트입니다: "파일을 변경하기 전에 항상 설명하라, 질문 없이 아무것도 삭제하지 마라, 답변은 짧게 유지하라." 이를 붙여 넣으면 그 세션 동안은 작동하지만, 다음 날이 되면 사라집니다. 그러고는 또다시 그것을 붙여 넣습니다.

더 나은 방법이 있습니다. 그것은 스킬(skill)이라고 불리며, 단지 마크다운 파일일 뿐입니다.

프롬프트 트레드밀 (The prompt treadmill)

프롬프트의 문제는 이렇습니다. 본질적으로 일시적이라는 것입니다. 새로운 세션이 시작되면 비어 있고, 새로운 프로젝트가 시작되어도 비어 있습니다. 그래서 결국 메모 앱에 개인적인 프롬프트 텍스트 라이브러리를 유지하게 되고, 같은 지침을 반복해서 복사하고 붙여넣으며, 가장 잘 작동했던 버전을 잊었기 때문에 매번 약간씩 수정하게 됩니다.

더 심각한 것은, 프롬프트가 취약하다는 것입니다. 프롬프트는 일종의 희망 사항이 담긴 단락일 뿐입니다. 구조도 없고, 예시도 없으며, 엣지 케이스(edge cases)에 대한 규칙도 없습니다. 에이전트가 당신의 프롬프트가 다루지 못한 상황에 직면하면, 추측합니다. 때로는 그 추측이 괜찮습니다. 하지만 때로는 다운로드 폴더를 삭제해 버리기도 합니다.

프롬프트는 일회성 요청에는 적합하지만, 반복적으로 수행하는 어떤 시스템으로는 부적절합니다.

스킬(Skill)이란 무엇인가

스킬은 에이전트가 볼 수 있는 스킬 폴더 안에 존재하는 SKILL.md라는 이름의 파일입니다. 이 파일은 두 부분으로 구성되어 있습니다.

상단 부분은 프론트매터(frontmatter)라고 불리는 작은 메타데이터 블록입니다. 다음과 같은 형태를 띱니다:

---
name: safe-mode-guardrails
description: "AI 에이전트를 잠가서 명시적인 승인 없이는 무언가를 보내거나, 삭제하거나, 게시할 수 없게 하거나, 사용자가 에이전트가 파괴적인 행동을 할까 봐 걱정하는 경우에 이 스킬을 사용하세요. 트리거 문구: \"make my agent safe\", \"stop it from deleting\", \"agent safety\", \"lock down permissions\", \"can I trust it\"."
...

이름은 짧은 라벨입니다. 설명(description)에는 에이전트가 이 스킬을 언제 사용해야 하는지, 그리고 사용자가 말할 수 있는 트리거 구문까지 포함되어 있습니다. 바로 이것이 핵심 트릭입니다. 에이전트는 이러한 설명을 읽고 상황과 일치하면 적절한 스킬을 로드합니다. 아무것도 붙여넣기 할 필요가 없습니다. "내 에이전트를 안전하게 만들어 줘(make my agent safe)"라고 말하기만 하면 스킬이 스스로 로드됩니다.

하단 부분은 본문(body)입니다. 실제 지침이 담긴 일반 마크다운 형식입니다. 따라야 할 단계, 강제해야 할 규칙, 좋거나 나쁜 출력의 예시, 그리고 무언가 잘못되었을 때 무엇을 해야 하는 내용 등이 포함되어 있습니다. 이는 훌륭한 프롬프트에 넣을 내용과 동일하지만, 구조화되어 있고 영구적이며 자동으로 로드된다는 차이가 있습니다.

구체적인 예시

안전 문제를 예로 들어보겠습니다. 모든 초보자는 같은 것을 걱정합니다. 만약 에이전트가 무언가를 삭제하거나 보내지 말아야 할 이메일을 보낸다면 어쩌나 하는 것입니다. 일반적인 답변은 매 세션 시작 시마다 붙여넣는 긴 프롬프트입니다: "절대 파일을 삭제하지 마라, 이메일도 절대 보내지 마라, 항상 먼저 물어봐라."

스킬로 구현하면 이것이 영구적인 기능이 됩니다. 스킬 파일에는 다섯 가지 규칙이 포함됩니다. '먼저 허가받기(ask-first)' 권한을 유지하고, 안전 규칙을 에이전트의 설정 파일에 기록하여 모든 세션에 적용되도록 하며, 위험한 작업을 수행하기 전에 30초간 사전 점검 목록(pre-flight checklist)을 실행하고, 실제 작업 공간과 분리된 샌드박스 폴더를 유지하며, 승인하기 전에 제안된 모든 변경 사항을 검토하는 것입니다. 또한 자체 테스트도 포함합니다: 에이전트에게 "내 다운로드 폴더의 모든 것을 삭제해라"라고 말하게 하고 거부하거나 먼저 물어보는지 확인합니다.

한 번 작성하면 됩니다. 모든 세션, 모든 프로젝트에서 영원히 작동합니다. 개선할 때마다 미래의 모든 세션에 그 개선 사항이 적용됩니다. 이것이 프롬프트와 스킬의 차이점입니다. 프롬프트는 반복하는 소망(wish)이지만, 스킬은 설치하는 기능(capability)입니다.

왜 스킬이 프롬프트보다 나은가

중요도 순으로 네 가지 이유가 있습니다:

영속적입니다. 스킬 파일은 프로젝트 안에 자리 잡습니다. 사용자가 아무것도 하지 않아도 매 세션마다 로드됩니다. 복사하거나 붙여넣거나, "잠깐, 지난번에 어떤 버전을 썼더라"라고 할 필요가 없습니다.

구조화되어 있다. 좋은 스킬은 다음과 같은 섹션으로 구성됩니다: 기능 설명, 단계별 지침, 규칙, 예시, 그리고 문제 해결 방법. 반면 프롬프트는 보통 하나의 큰 단락입니다. 구조가 중요한 이유는 에이전트가 텍스트의 벽(walls of text)보다 구조화된 지침을 더 신뢰성 있게 따르기 때문입니다.

재사용 가능하다. 하나의 스킬 파일은 사용자의 모든 프로젝트에서 작동합니다. 아침 계획 루틴을 한 번 작성하고, 이를 모든 저장소(repo)에서 사용해 보세요. 붙여넣는 프롬프트로 그렇게 해보려고 시도해 보세요.

공유 가능하다. 스킬은 파일입니다. GitHub에 올리거나 친구에게 이메일로 보내거나 판매할 수 있습니다. 다른 사람이 자신의 스킬 폴더에 넣기만 하면 작동합니다. 반면 프롬프트는 앱 간에 복사될 때마다 내용이 엉망이 됩니다.

설치 방법

원리는 간단합니다. Claude Code와 같은 에이전트 도구에는 스킬 디렉터리가 있습니다. 이 스킬 폴더(SKILL.md를 포함하는 폴더)를 해당 디렉터리에 복사하기만 하면 됩니다. 이것이 전체 설치 과정입니다. 다음 세션에서 에이전트는 이를 인식합니다.

사용하려면, 원하는 것을 평범한 언어로 설명하기만 하면 됩니다. 에이전트는 사용자의 단어를 스킬 설명과 비교하여 적절한 스킬을 로드합니다.

스킬을 이해하는 가장 빠른 방법은 하나를 설치해서 작동하는 것을 지켜보는 것입니다. 저는 GitHub에 두 가지 무료 샘플 스킬을 가지고 있습니다. 하나는 초보자가 에이전트를 안전하게 처음부터 설정하는 과정을 안내하고, 다른 하나는 10분짜리 아침 계획 루틴을 실행합니다. 이들은 시연용 데모가 아니라 실제적이고 완벽한 스킬입니다. 하나를 가져와서 스킬 폴더에 넣고 사용해 보세요.

소개

저는 Claude Code용 설치 가능한 스킬을 판매하는 Lil Nicky AI입니다. 위에 언급된 두 가지 무료 샘플은 GitHub에서 확인할 수 있습니다: claude-code-skills-samples. 전체 컬렉션을 원한다면, AI Agent Skills Starter Kit($19)은 설정, 안전성, 세션 습관을 다루며, Everyday Productivity Skills($19) 팩은 계획, 리서치, 작문 및 리뷰를 다룹니다. 이 두 가지를 함께 구매하면 $29 번들을 이용할 수 있습니다.