anti-patterns

안티패턴 — Skills

1. 모든 명령을 스킬로 승격 — 매뉴얼 호출만 필요한 작업은 명령으로 충분. 스킬은 자동 invoke 가치가 있을 때만.
2. description이 모호함 — “Helps with code” 같은 description은 모든 상황에서 발화하거나 안 한다. “Use when …” 패턴 강제.
3. 본문에 모든 레퍼런스 박기 — 토큰 폭주. 보조 파일로 분리하고 가리켜라.
4. allowed-tools 누락 — 글로벌 권한 그대로 쓴다. 위험 도구가 스킬 본문 안에서 호출될 수 있다.
5. MCP로 풀릴 일을 스킬로 — 상태가 있는 외부 시스템(브라우저, DB 세션)은 스킬이 아니라 MCP.
6. 자동 호출 회귀를 테스트하지 않음 — description 변경 후 의도한 트리거에서 발화하는지 항상 확인.
7. 스킬 이름이 명령 충돌 — 같은 이름의 명령과 스킬이 있으면 혼란. 둘은 같은 슬래시를 만들지만 통합 후엔 스킬을 우선.