허브나 컴패니언을 작업 도구처럼 다루지 마세요.

허브는 팩을 나열합니다. 컴패니언 페이지는 Setup입니다. 복사 또는 다운로드. 어느 쪽도 와이어프레임을 그리거나, 점검을 돌리거나, 브레이크포인트를 찍지 않습니다. 그 일은 맞는 브라우저 도구를 열거나, 설치된 스킬이 에이전트에서 실행되게 하세요.

한 번 설치한 뒤 같은 스킬을 두 번째 워크플로로 다운로드하지 마세요.

npx skills@latest add iruhdam1/skills를 실행하거나, 또는 컴패니언에서 팩 하나를 다운로드하세요 — 같은 스킬에 둘 다 쓰지 마세요. 복사본이 둘이면 어긋나고, 에이전트가 오래된 쪽을 불러올 수 있습니다.

1인칭이나 모호한 description을 쓰지 마세요.

Claude와 다른 호스트는 description 필드에서 스킬을 찾습니다. 1인칭(“I help you…”)이나 빈 범위면 에이전트가 파일을 고르지 않습니다. 무엇을 하는지, 언제 쓰는지 3인칭으로 쓰세요. Anthropic의 작성 노트도 같은 규칙입니다.

SKILL.md에 모든 것을 넣지 마세요.

본문은 절차로 두세요. 긴 메모는 한 단계 아래의 옆 참조 파일에 두어, 호스트가 필요할 때만 불러오게 하세요. 텍스트 벽은 컨텍스트를 태우고 트리거를 숨깁니다.

샵의 .agents/skills를 복사하거나 Analog를 편집하지 마세요.

이 샵의 .agents/skills 폴더(COSS, Phosphor, 기타 에이전트 헬퍼)는 공개 팩이 아닙니다. 복사하지 마세요. Analog를 편집하지 마세요. 공개 세트는 허브에 올라 있는 GitHub 팩입니다.

빠진 skills.sh 목록을 쫓지 마세요.

skills.sh는 공개 목록과 설치 텔레메트리입니다. 배지가 없다고 해서 GitHub push가 실패한 것이 아닙니다. 팩이 아직 없으면 GitHub나 샵 컴패니언을 쓰세요. skills.sh vs GitHub를 보세요.