클로드 스킬, 조용히 명령을 덮어쓰다: 문서화되지 않은 함정 노출
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를 구축하거나 유지 관리하는 모든 사람, 특히 사용자 입력 흐름이나 크로스 플랫폼 동작에 의존하는 사람에게 해당됩니다.
📖 전체 출처 읽기: r/ClaudeAI
👀 See Also
ESP32 기반 모치 봇과 함께하는 3D 프린팅 클로드 마스코트
한 개발자가 클로드 코드 마스코트에서 영감을 받은 물리적 3D 클로드를 제작했으며, ESP32로 구동되는 모치 봇에 작은 디스플레이가 포함되어 있습니다. 파일과 코드는 MakerWorld와 GitHub에서 확인할 수 있습니다.
T9OS: 클로드 코드로 완전히 구축된 AI 오케스트레이션 시스템
경제학과 학생이 Claude Code를 유일한 프로그래밍 도구로 사용하여 완전한 AI 오케스트레이션 계층인 T9OS를 구축했습니다. 이 시스템은 18개의 프로덕션 파이프라인, 12단계 생명주기 엔진, 모든 출력을 검토하는 7개의 AI '가디언'을 포함합니다.
RAG-Engram 아키텍처로 미세 조정된 Qwen3.5-2B 모델은 8K 컨텍스트에서 근거 기반 답변 정확도를 50%에서 93%로 향상시킵니다.
한 개발자가 '중간에서 길을 잃는' 현상을 해결하기 위해 맞춤형 RAG-Engram 아키텍처로 Qwen3.5-2B를 미세 조정하여, 실제 질의에서 8K 토큰 기준 정답률을 50%에서 93%로 향상시켰습니다. 이 시스템은 정적 개체 임베딩과 동적 청크 탐색이라는 두 단계 접근법을 사용합니다.
OpenHelm: Claude 코드 작업 자동화를 위한 macOS 앱
OpenHelm은 macOS용 무료 로컬 애플리케이션으로, 작업을 예약 실행하고 실패 시 자동 재시도하며 세션 제한을 피하기 위해 작업을 청크로 분할하여 Claude 코딩 작업의 반복성을 자동화합니다. LLM 호출에는 기존 Claude 구독을 사용합니다.