클로드 스킬, 조용히 명령을 덮어쓰다: 문서화되지 않은 함정 노출

Claude Skills를 조사하던 Reddit 사용자가 명시적 지침을 무시하는 여러 숨겨진 동작을 발견했으며, skill-creator에는 이에 대한 문서가 없습니다. 사용자가 밝혀낸 내용은 다음과 같습니다.

Claude Skills의 주요 함정

• ask_user_input_v0 하드 제한: 이 도구는 최대 3개의 질문과 질문당 4개의 옵션을 강제합니다. 스킬이 더 많은 항목을 요청하면 Claude가 자동으로 축소합니다. 오류가 발생하지 않습니다.
• 파일 쓰기 불일치: Code/Desktop에서는 Write가 기존 파일을 자동으로 덮어씁니다. Claude.ai에서는 create_file이 덮어쓰기를 거부합니다. 동일한 지침인데 반대 동작을 보입니다.
• references/의 상대 경로 문제: 공식 권장 사항인 references/ 패턴이 어떤 플랫폼에서도 스킬 디렉토리의 상대 경로를 제대로 해석하지 못합니다.
• 도구 부재 시 자동 대체: 스킬이 현재 플랫폼에 없는 도구를 참조하면 Claude가 오류나 경고 없이 자동으로 일반 텍스트로 대체합니다.

실용적인 해결 방법

저자의 해결 방법: 더 많은 입력이 필요할 때 여러 라운드의 질문을 하도록 스킬을 업데이트하여 ask_user_input_v0 제한을 우회합니다. 파일 작업의 경우 Code/Desktop에서는 항상 Write를 사용하고, Claude.ai에서는 플랫폼 확인 후 create_file을 사용합니다. references/에서 상대 경로를 피하고 절대 경로나 인라인 콘텐츠를 대신 사용합니다.

커뮤니티 공유 레포지토리

발견 사항은 GitHub 레포지토리에 수집되고 있습니다: github.com/livlign/claude-skills-pitfalls. 기여를 환영합니다.

관련 대상

Claude Skills를 구축하거나 유지 관리하는 모든 사람, 특히 사용자 입력 흐름이나 크로스 플랫폼 동작에 의존하는 사람에게 해당됩니다.