Claude Code에 디자인 스킬 만들어서 넣었는데 이거 진짜 적용되는 거 맞나요?
답변 1
- 첫째운영진Lv.62026. 7. 14.
안녕하세요, 운영진입니다. 결론부터 말씀드리면 스킬 폴더에 파일만 넣어둔다고 매번 자동으로 결과에 반영되는 구조는 아닙니다. Claude Code는 SKILL.md의 description 필드를 보고 지금 요청과 관련이 있다고 판단될 때만 그 스킬의 내용을 실제로 불러와서 적용합니다. 파일이 있으면 세션 시작 시 스킬 목록에는 올라가지만, 실제 적용 여부는 description 매칭에 달려 있다는 뜻입니다. 결과물이 스킬 넣기 전과 비슷했다면 가장 흔한 원인은 description이 모호하게 적혀 있는 경우입니다. description에는 이 스킬이 무엇을 하는지와 언제 써야 하는지를 앞부분에 구체적으로 적어야 매칭이 잘 됩니다. description을 아예 안 적었다면 SKILL.md 첫 문단이 대신 쓰이는데, 이 경우 트리거 조건이 애매할 가능성이 큽니다. 확인하는 방법은 두 가지입니다. 1. 새 대화를 열고 description과 맞아떨어지는 자연스러운 요청을 그대로 던져본 뒤, 스킬 내용이 반영되는지 확인합니다. 2. 자동 인식과 별개로 슬래시 명령으로 직접 호출할 수 있습니다. 스킬 폴더 이름이 곧 명령어가 되므로, 예를 들어 폴더명이 design-guideline이면 대화창에 /design-guideline이라고 입력하면 그 내용이 무조건 로드됩니다. 이때 결과가 확실히 달라진다면 스킬 자체는 정상이고, 자동 트리거 쪽 문제로 좁혀집니다. 참고로 세션이 시작된 뒤 상위 skills 디렉터리를 새로 만든 경우에는 재시작을 해야 인식되고, 이미 있던 폴더 안에서 SKILL.md 내용만 고친 거라면 재시작 없이 바로 반영됩니다. 스킬 작성법은 아래 가이드에 자세히 정리해 두었습니다. https://usingclaude.com/ko/claude-code/skills/claude-code-skills-guide 스킬이 실제로 트리거되지 않을 때 점검할 것들은 아래에 따로 정리해 두었습니다. https://usingclaude.com/ko/claude-code/skills/claude-code-skill-not-recognized-troubleshooting