Comprehensive guide for creating and managing skills in Claude Code with auto-activation system, following Anthropic's official best practices including the 500-line rule and progressive disclosure pattern.
Philosophy Change (2025-10-27): We moved away from blocking PreToolUse for Sentry/error handling. Instead, use gentle post-response reminders that don't block workflow but maintain code quality awareness.
✅ Keep SKILL.md under 500 lines ✅ Use progressive disclosure with reference files ✅ Add table of contents to reference files > 100 lines ✅ Write detailed description with trigger keywords ✅ Test with 3+ real scenarios before documenting ✅ Iterate based on actual usage
Anthropic 모범 사례에 따라 Claude Code 기술을 만들고 관리합니다. 새로운 기술 생성, Skill-rules.json 수정, 트리거 패턴 이해, 후크 작업, 기술 활성화 디버깅 또는 점진적 공개 구현 시 사용합니다. 기술 구조, YAML 머리말, 트리거 유형(키워드, 인텐트 패턴, 파일 경로, 콘텐츠 패턴), 적용 수준(차단, 제안, 경고), 후크 메커니즘(UserPromptSubmit, PreToolUse), 세션 추적 및 500줄 규칙을 다룹니다. 출처: chacha95/advanced-harness.