번역 전용 스킬 만들어놨는데 클로드가 무시하고 그냥 번역함
답변 1
- 첫째운영진Lv.62026. 7. 19.
안녕하세요, 운영진입니다. 결론부터 말씀드리면 트리거 문구 문제가 맞을 가능성이 높고, description(설명) 작성 방식을 바꾸면 상당히 개선됩니다. Claude Code의 Agent Skill은 대화 시작 시 모든 스킬의 이름과 description만 먼저 훑어보고, 지금 요청이 그 설명과 맞는지 판단해서 스스로 스킬을 불러올지 결정하는 구조입니다. 사용자가 스킬 이름을 매번 언급하지 않아도 되도록 설계된 것인데, 이 판단이 사실상 description 한 줄에 달려 있습니다. SKILL.md 본문(용어집, 문체 규칙 등)은 Claude가 이 스킬이 필요하다고 판단한 뒤에야 실제로 읽어들이는 구조입니다. 그래서 description에 스킬이 무엇을 하는지만 적혀 있고 언제 써야 하는지가 빠져 있으면 트리거 확률이 떨어지고, 그냥 자체 판단으로 번역해버리는 경우가 생깁니다. 예를 들어 단순히 번역 스킬이라고 적기보다는, 사용자가 텍스트를 한국어와 영어 사이로 번역해달라고 요청할 때 사용하며 용어집과 문체 규칙을 적용한다는 식으로 구체적인 트리거 상황과 키워드를 명시하는 편이 훨씬 안정적으로 작동합니다. 실전 팁 세 가지를 권합니다. 1. description에 무엇을 하는지(용어집·문체 규칙 적용 번역)와 언제 쓰는지(번역 요청 시)를 함께 명시하세요. 사람이 읽기 좋은 문장보다 판단 규칙에 가깝게 쓰는 것이 효과적입니다. 2. description이 너무 길면 목록에서 잘릴 수 있으니 핵심 트리거 조건은 앞쪽에 배치하세요. 3. 그래도 불안정하면 요청 문구에 트리거 키워드를 직접 포함시키거나, 대화 시작 시 스킬을 한 번 명시적으로 호출하는 방식이 가장 확실합니다. 다만 이 판단은 확률적으로 이루어지기 때문에 description을 아무리 잘 써도 100퍼센트 보장되지는 않습니다. 정확한 매칭 알고리즘 자체는 공식적으로 세부 공개되지 않았습니다. 관련 내용은 아래 가이드에 자세히 정리해 두었습니다. https://usingclaude.com/ko/claude-code/skills/claude-code-skill-not-recognized-troubleshooting