클로드 스킬, 조용히 명령을 덮어쓰다: 문서화되지 않은 함정 노출
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
로컬 LLM 추론을 위한 프록시 수준 루프 탐지
vLLM 프록시 뒤에서 Qwen3.6 MoE를 실행하던 개발자가 일반적인 신뢰성 문제에 부딪혔습니다: 모델이 추론 블록 내에서 자신을 반복하며 토큰을 소모하고 에이전트를 지연시키는 폭주 추론 루프입니다. 180+ 토큰/초 속도에서는 20-30초의 루프도 GPU 시간을 낭비하고 클라이언트 요청을 차단합니다. 그들은 프록시 계층에 위치하여 클라이언트에 도달하기 전에 스트리밍 출력에 대해 결정론적 검사를 적용하는 경량 가드를 구축했습니다.
클로드 코드용 789개 다운로드 가능한 스킬 무료 라이브러리
clskills.in은 Claude Code를 위한 789개의 다운로드 가능한 .md 스킬 파일을 제공하는 검색 가능한 허브로, 엔터프라이즈 플랫폼, 프로그래밍 언어, DevOps 도구 등 60개 이상의 카테고리로 구성되어 있습니다. 각 다운로드에는 README 파일과 자동 설치 프롬프트가 포함됩니다.
오크스트라: 오픈클로를 위한 비용 인식 LLM 라우팅 레이어, API 비용을 60-80% 절감
Orkestra는 OpenClaw의 LLM 호출 앞에 위치하는 모듈형 라우팅 레이어로, 의미론적 분류를 통해 프롬프트를 예산, 균형, 프리미엄 모델 계층으로 라우팅합니다. 이 접근 방식은 프롬프트 재작성이나 복잡한 규칙 없이 API 비용을 60-80% 절감했습니다.
LLM 에이전트를 위한 복잡한 검색 파이프라인을 간단한 git 쉘 명령어로 대체하기
한 개발자가 AI 에이전트 검색 파이프라인(sentence-transformers, rank-bm25, 2단계 LLM 파이프라인) 전체를 git 저장소에 대해 읽기 전용 셸 명령을 실행할 수 있는 단일 도구로 교체하여 Docker 이미지 크기를 약 3GB 줄이고 타임아웃 문제를 해결했습니다.