Claude Code · 2026년 9월 18일 ★★★

공개 클로드 코드 스킬 216개를 린터로 훑은 보고서의 「69% 는 안정적으로 트리거되지 않는다」는 실제 호출 시험이 아니라 설명문을 LLM 이 읽고 매긴 점수예요

Skill Crossroads 라는 스킬 린터가 9월 10일 앤트로픽 공식 저장소 1곳과 커뮤니티 저장소 17곳에서 모은 스킬 216개(채점 215개)를 26개 규칙으로 채점해, 148개(69%)의 description 이 「안정적으로 트리거되지 않는다」고 적었어요. 다만 그 판정(TRIGGER-01)은 스킬 이름·description·본문 앞 1,500자를 클로드 모델에 보내 0~100점을 받아 80점 이상 통과·60점 이상 경고·그 아래 실패로 가른 것이고, 87개 실패와 61개 경고를 합친 숫자예요. 실제 클로드 코드 세션에서 프롬프트를 넣어 스킬이 뜨는지 시험한 것은 아니고, 작성자는 사람이 라벨한 14개 표본과 92.9% 일치했다고만 밝혔어요. 판단 기준 자체는 앤트로픽 공식 문서가 권하는 「무엇을 하는지와 언제 쓰는지를 함께 적고, 사용자가 말할 법한 키워드를 넣어라」와 같은 방향이지만, 보고서와 저장소 어디에도 공식 문서를 인용한 대목은 없어요.

용어 풀이
description
스킬 SKILL.md 머리말(frontmatter)의 설명 필드. 클로드가 스킬을 자동 호출할지 정할 때 읽는 텍스트
LLM
대규모 언어 모델(Large Language Model)
TRIGGER-01
Skill Crossroads 린터의 트리거 신뢰도 검사 항목 이름. 모델이 설명문을 읽고 점수를 매기는 방식
운영자 인사이트

공식 문서는 description 이 스킬 자동 호출을 정하는 유일한 근거라고 적고 있으니, 이 보고서의 수치는 믿기보다 「내 스킬 description 에 '언제 쓰는지'와 사용자 표현이 들어 있는가」를 점검하는 계기로 쓰는 게 맞아요. 트리거 여부를 정말 확인하려면 공식 문서가 권하는 대로 실제 프롬프트 세 개쯤을 만들어 스킬이 뜨는지 직접 돌려 보세요.

여러 관점으로 보기
  • 린터 저장소 TRIGGER-01 소스는 description 과 본문 발췌를 모델에 보내 점수를 받는 구조이고, 결정적 규칙 TRIGGER-03 은 「use when」·「when the user」 같은 문구가 있는지만 봐요. GitHub
  • 앤트로픽 공식 지침 공식 작성 지침은 description 에 무엇을 하는지와 언제 쓰는지를 함께 넣고 사용자가 언급할 키워드를 담으라고 하며, 실제 프롬프트로 평가를 만들어 시험하라고 권해요. Anthropic
  • 클로드 코드 문서 클로드 코드 문서는 description 과 when_to_use 를 합쳐 1,536자에서 자르고, 스킬 본문은 호출될 때만 읽힌다고 적고 있어요. Anthropic

원본 보기 (hn:claude-code)