Description 작성법 : 스킬 활성화의 핵심, 황금 공식 마스터하기

작성자: 주아라기

목차

    Description 작성법 : 스킬 활성화의 핵심, 황금 공식 마스터하기

    스킬에서 가장 중요한 한 줄이 있습니다.

    바로 description입니다.

    description이 잘못되면 스킬이 엉뚱한 때 실행되거나, 필요할 때 실행되지 않습니다. 이 글에서는 효과적인 description 작성법을 마스터합니다.

    description이 중요한 이유

    🎭 왜왜씨와 딱딱씨의 대화
    🤔
    왜왜씨

    description이 그렇게 중요한가요? 그냥 설명 아닌가요?

    🎯
    딱딱씨

    description은 단순한 설명이 아니야. Claude가 "이 스킬을 지금 사용할까 말까"를 판단하는 핵심 정보야.

    🤔
    왜왜씨

    keywords가 있는데 왜 description도 봐요?

    🎯
    딱딱씨

    keywords는 1차 필터야. 키워드가 매칭되면 Claude가 description을 읽고 정말 이 스킬이 맞는지 최종 판단해. description이 모호하면 오판이 생겨.

    description의 역할

    ① 스킬 활성화 판단 - 이 요청에 이 스킬이 적합한가?
    ② 스킬 목록 표시 - /help에서 스킬 설명으로 노출
    ③ 동작 범위 정의 - 스킬이 무엇을 하고 무엇을 안 하는지

    황금 공식: 기능 + 트리거

    효과적인 description에는 두 가지 정보가 필요합니다.

    기능 설명 + 트리거 조건 = 완벽한 description

    기능 설명

    이 스킬이 무엇을 하는지 명확히 기술합니다.

    💡 기능 설명 예시

    • "블로그 글 작성"
    • "코드 리뷰 수행"
    • "API 문서 생성"
    • "커밋 메시지 작성"

    트리거 조건

    언제 활성화되어야 하는지 명시합니다.

    💡 트리거 조건 예시

    • "블로그 써줘" 요청 시 활성화
    • "리뷰해줘", "PR 확인" 요청 시 활성화
    • "/api-doc" 명령 시 실행
    • "커밋", "commit" 키워드 포함 시

    좋은 description 예시

    스킬 description 분석
    blog-writer 블로그 글 작성 전문가. "블로그 써줘", "포스팅 작성" 요청 시 활성화 ✅ 기능 + 트리거 명확
    code-reviewer 코드 품질 검토 및 개선점 제안. "리뷰해줘", "코드 확인", "PR 봐줘" 시 활성화 ✅ 다양한 트리거 표현
    commit-helper Conventional Commits 형식 커밋 메시지 생성. "커밋 메시지", "commit" 키워드 시 활성화 ✅ 구체적 형식 언급
    🎯 딱딱씨의 팁

    트리거 조건에는 사용자가 실제로 입력할 표현을 적으세요. "글쓰기 요청 시"보다 "블로그 써줘" 시가 더 명확합니다!

    피해야 할 description

    🎭 왜왜씨와 딱딱씨의 대화
    🤔
    왜왜씨

    "유용한 도우미 스킬"이라고 쓰면 안 되나요?

    🎯
    딱딱씨

    그건 아무 정보도 없는 설명이야. Claude가 "이게 유용한 건 알겠는데, 언제 써야 하지?"라고 혼란스러워 해.

    ❌ 나쁜 description 문제점 ✅ 개선안
    유용한 도우미 기능 불명확 이메일 작성 도우미. "이메일 써줘" 시 활성화
    블로그 너무 짧음 블로그 글 작성. "블로그", "포스팅" 요청 시 활성화
    모든 작업을 도와주는 만능 스킬 범위 무한대 특정 기능으로 범위 좁히기
    코드 작성 트리거 없음 React 컴포넌트 생성. "컴포넌트 만들어" 시 활성화
    나쁜 description 특징

    ① 너무 모호함 - "도우미", "유용한" 같은 추상적 표현
    ② 너무 광범위 - "모든 것", "만능" 같은 무제한 범위
    ③ 트리거 누락 - 언제 활성화되는지 정보 없음
    ④ 너무 짧음 - 한 단어로는 판단 불가

    description 작성 체크리스트

    ✅ 작성 전 체크리스트

    1. 기능이 명확한가? - 이 스킬이 뭘 하는지 한 문장으로 설명 가능?
    2. 트리거가 있는가? - 언제 활성화되는지 적었는가?
    3. 범위가 적절한가? - 너무 넓지도, 좁지도 않은가?
    4. 실제 표현인가? - 사용자가 정말 이렇게 요청할까?

    description 템플릿
    [기능 설명]. "[트리거 표현1]", "[트리거 표현2]" 요청 시 활성화

    💡 템플릿 적용 예시

    기능: 회의록 작성
    트리거: "회의록 정리해줘", "미팅 노트"
    결과: 회의록 작성 및 정리. "회의록 정리해줘", "미팅 노트 작성" 요청 시 활성화

    핵심 정리

    황금 공식 = 기능 설명 + 트리거 조건
    기능 = 무엇을 하는가 (명확하게)
    트리거 = 언제 활성화되는가 (실제 표현으로)
    피할 것 = 모호함, 무제한 범위, 트리거 누락

    다음 글 예고

    👉 나의 첫 스킬 만들기 : 실습으로 배우는 스킬 제작 A to Z

    좋은 description은 스킬 성공의 절반입니다.
    황금 공식을 기억하세요! ✨

    댓글

    댓글 쓰기

    이 블로그의 인기 게시물

    n8n으로 업무 자동화 시작하기 : 왜 필요하고 어떻게 활용할까?

    작성자: 주아라기
    이미지
    저는 매주 금요일마다 3시간씩 리포트를 만들었습니다. 지금은 5분 입니다. 이메일 분류, 데이터 입력, 보고서 작성... 이런 단순 반복 작업 이 우리의 시간과 에너지를 잡아먹고 있었습니다. 이 글에서는 업무 자동화의 필요성 과 강력한 자동화 도구 n8n 의 활용 방법을 알아봅니다. 1년에 5일을 돌려받는 방법 🎭 왜왜씨와 딱딱씨의 대화 🤔 왜왜씨 요즘 업무 자동화 얘기 많이 들리는데... 꼭 해야 하나요? 🎯 딱딱씨 생각해봐. 매일 30분씩 반복 작업을 한다면, 한 달이면 10시간 이야. 1년이면 120시간! 🤔 왜왜씨 120시간이면... 거의 5일치 근무 시간이네요? 🎯 딱딱씨 맞아! 그 시간을 더 중요한 일 에 쓸 수 있다면 어떨까? 업무 자동화의 3가지 핵심 가치 ① 효율성 향상 - 반복 작업을 자동으로 처리하고 중요한 업무에 집중 ② 오류 감소 - 사람은 실수하지만, 기계는 규칙대로 정확하게 실행 ③ 비용 절감 - 인력 투입을 최소화하면서 업무 처리 속도 향상 자동화는 단순히 "편해지는 것"이 아닙니다. 빠르게 변화하는 비즈니스 환경에서 경쟁력을 유지하기 위...
    Read more »

    n8n 데이터 처리 노드 : Set, Split, Merge 완벽 정리

    작성자: 주아라기
    이미지
    Gmail, Slack, Sheets에서 각각 가져온 데이터가 서로 다른 형식 입니다. 어떻게 하나로 합칠까요? 답은 데이터 처리 노드 입니다. n8n 워크플로우의 80%는 데이터를 변환하고, 나누고, 합치는 작업입니다. 이 글을 다 읽으면 어떤 형태의 데이터든 원하는 모양으로 가공할 수 있게 됩니다. ① n8n 데이터 흐름 이해하기 — 모든 건 JSON 🎭 왜왜씨와 딱딱씨의 대화 🤔 왜왜씨 n8n에서 데이터는 어떻게 생겼어요? 🎯 딱딱씨 n8n의 모든 데이터는 JSON 형식 이야. 쉽게 말해 "키: 값" 쌍으로 이루어진 구조지. 🤔 왜왜씨 예시로 보여주실 수 있어요? 🎯 딱딱씨 { "name": "홍길동", "email": "hong@email.com", "age": 30 } 이런 식이야! 핵심 개념 Item = 하나의 데이터 단위 (JSON 객체) Items = 여러 Item의 배열 노드는 Items를 받아서 처리 후 Items를 출력합니다. 예시: Gmail 노드...
    Read more »

    n8n 트리거 노드 : 3가지 유형으로 자동화 시작하기

    작성자: 주아라기
    이미지
    매일 아침 9시, 팀원들에게 자동으로 리포트가 발송됩니다. 1년 넘게 단 한 번도 놓친 적이 없습니다. 비결은 트리거 노드 단 하나입니다. "언제 실행할까?"라는 질문에 답하는 이 노드가, 당신의 워크플로우를 365일 24시간 깨어있게 만듭니다. 이 글에서는 n8n의 3가지 트리거 유형 과 "어떤 상황에 무엇을 써야 하는지" 완벽하게 정리합니다. ① n8n 트리거란? 자동화의 방아쇠 🎭 왜왜씨와 딱딱씨의 대화 🤔 왜왜씨 트리거가 뭔가요? 방아쇠 같은 건가요? 🎯 딱딱씨 딱 맞아! 방아쇠를 당기면 총알이 발사되듯, 트리거가 발동하면 워크플로우가 실행 되는 거야. 🤔 왜왜씨 그러면 모든 워크플로우에 트리거가 있어야 하나요? 🎯 딱딱씨 맞아! 트리거가 없으면 워크플로우가 언제 시작해야 할지 모르니까 . 항상 가장 왼쪽에 트리거 노드가 있어야 해. 핵심 트리거 노드 = 워크플로우를 시작하는 조건을 정의하는 노드 모든 워크플로우는 반드시 하나 이상의 트리거 노드가 필요합니다. ② n8n 트리거 3가지 유형 — 이것만 알면 전부 보인다 n8n의 트리거는 크게 세 가...
    Read more »