클로드 스킬, 조용히 명령을 덮어쓰다: 문서화되지 않은 함정 노출
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
오픈소스 MCP 메모리 서버 - 지식 그래프 및 학습 기능 포함
Rust로 작성된 오픈소스 MCP 서버가 지식 그래프 아키텍처, 헤비안 학습, 하이브리드 검색을 통해 AI 에이전트에 지속적 메모리를 제공합니다. 7.6MB 크기에 밀리초 미만의 지연 시간을 가지며 모든 MCP 호환 클라이언트와 작동합니다.
Mnemos: 코딩 에이전트를 위한 오픈소스 로컬-퍼스트 메모리 레이어
Mnemos는 스코프 블리드, 오래된 사실, 무제한 전사본 증가와 같은 일반적인 메모리 시스템 실패를 해결하는 솔로 코딩 에이전트 워크플로우를 위한 로컬-퍼스트 메모리 레이어입니다. 공개 베타에는 SQLite 스타터 프로필, Claude Code/Desktop용 MCP 지원, SurprisalGate 및 MutableRAG와 같은 구성 요소를 포함한 생체 모방 파이프라인이 포함되어 있습니다.
Heartbeat-gateway: OpenClaw에서 cron 폴링을 대체하는 이벤트 기반 솔루션
Heartbeat-gateway는 OpenClaw를 위한 cron 기반 폴링을 웹훅 기반 이벤트로 대체하는 오픈소스 Python 도구로, API 비용을 약 $86/월에서 약 $4.50/월로 줄이고 지연 시간을 최대 30분에서 2초 미만으로 개선합니다.
자동 최적화: 자율 성능 최적화를 위한 Claude 코드 플러그인
한 개발자가 코드 성능을 최적화하기 위해 프로파일링 → 계획 → 벤치마크 루프를 자율적으로 실행하는 Claude Code 플러그인인 auto-optimize를 구축했습니다. 한 테스트에서 약 3시간 만에 모든 벤치마크 시나리오에서 27% 더 빠른 해시 테이블을 달성했습니다.