clamp-sh/analytics-skills

analytics-skills은(는) 무엇을 하나요?

Claude, Cursor 및 기타 AI 에이전트가 시니어 분석가처럼 웹 분석 데이터를 읽을 수 있도록 가르치는 스킬입니다. 트래픽 변화 진단, 채널 품질 평가, 퍼널 분석을 일반적인 초보 실수 없이 수행합니다. 모든 분석 소스와 호환되며 Clamp MCP에 대한 일급 지원을 제공합니다.

구성 요소

스킬	설명
analytics-profile-setup	일회성 인터뷰를 통해 비즈니스 컨텍스트(모델, 기본 전환, 트래픽 범위, ICP, 데이터 스택)를 로컬 analytics-profile.md 파일에 기록합니다. 다른 모든 스킬이 이 파일을 읽어 업계와 규모에 맞게 답변을 조정합니다. 먼저 실행하세요.
analytics-diagnostic-method	핵심 방법론. 5단계 절차: 프로필 로드, 질문 프레임, MECE 가설 트리 구성, 삼각 측량, 피라미드 원리로 발표. 신호 대 노이즈 및 심슨의 역설을 다룹니다. 다른 모든 스킬에서 참조합니다.
traffic-change-diagnosis	"트래픽이 왜 변했는가"에 대한 드릴 경로. 추적 문제, 봇 급증, 배포 관련 하락, 캠페인 증가, SEO 하락, 플랫폼 변경에 대한 지문 제공. 항상 측정 검증부터 시작합니다.
channel-and-funnel-quality	볼륨 × 참여 × 전환 행렬. 허위 트래픽 탐지. 퍼널 단계 유형별 예상 이탈 범위. 혼합 변화 처리. 업계별 벤치마크.
metric-context-and-benchmarks	모델별 좋은 이탈률/참여율/체류 시간/CVR/이탈률/LTV:CAC/활성화율 기준. 각 지표가 거짓말하는 경우. 비율 신뢰를 위한 최소 샘플 크기.

설치

설정에 맞는 방법을 선택하세요. 세 가지 모두 동일한 스킬을 설치합니다.

Claude Code, 플러그인 (권장)

# 마켓플레이스 추가
/plugin marketplace add clamp-sh/analytics-skills

# 설치
/plugin install analytics-skills@clamp-sh

스킬은 /analytics-skills:<name> 형태로 사용 가능하며 작업이 일치할 때 자동 호출됩니다.

모든 에이전트 (Cursor, Claude Code, Copilot 등)

Vercel의 오픈 skills CLI를 통해 설치:

npx skills add clamp-sh/analytics-skills

Agent Skills 스펙을 지원하는 모든 도구에서 작동합니다.

Claude Code, 독립형 (플러그인 미사용)

개인 스킬 디렉토리에 클론:

git clone https://github.com/clamp-sh/analytics-skills.git /tmp/analytics-skills
cp -R /tmp/analytics-skills/skills/* ~/.claude/skills/

또는 번들 설치 프로그램 실행 (각 스킬을 심볼릭 링크하므로 git pull로 업데이트):

git clone https://github.com/clamp-sh/analytics-skills.git ~/.analytics-skills
~/.analytics-skills/scripts/install-personal.sh

단일 프로젝트의 경우, 리포지토리 내 .claude/skills/에 클론하세요.

claude.ai

스킬별 zip 파일을 빌드하고 설정 → 기능 → 스킬에서 각각 업로드:

./scripts/build-claude-ai-zips.sh
# dist/analytics-diagnostic-method.zip 등 생성

각 릴리스의 미리 빌드된 zip 파일도 GitHub 릴리스 페이지에 첨부되어 있습니다.

사용법

모델 호출 방식의 스킬입니다. 이름을 직접 호출할 필요 없이 실제 분석 질문을 하면 Claude가 관련 스킬을 로드합니다.

새 프로젝트에서 처음 실행:

설정해줘. 내 비즈니스에 맞게 스킬을 조정하고 싶어.

이렇게 하면 analytics-profile-setup이 로드되어 5분 인터뷰를 진행하고 리포지토리 루트에 analytics-profile.md를 작성합니다. 이후 모든 질문에 업계 인식 답변이 제공됩니다.

설정 후, 실제 질문:

화요일에 트래픽이 30% 떨어졌어. 무슨 일이야?

traffic-change-diagnosis를 로드합니다. 가설 트리(측정 → 시간 패턴 → 채널 → 코호트 → 콘텐츠)를 따라 분석 소스에서 수치를 가져와 진단을 반환합니다. 차트 스크린샷이 아닙니다.

가입 퍼널이 망가졌어? 요금제 → 결제 전환율이 14%야.

channel-and-funnel-quality와 metric-context-and-benchmarks를 로드합니다. 예상 단계 이탈률과 비교하고 코호트별로 분할하며 14%가 귀하의 샘플 크기와 모델에 비해 낮은지, 정상인지, 의심스러운지 플래그를 지정합니다.

우리 이탈률이 68%인데, 나쁜 거야?

metric-context-and-benchmarks를 로드합니다. GA4 대 UA 정의 차이를 처리하고 관련 페이지 유형 범위를 찾아보며 필요한 경우 샘플 크기 주의 사항을 플래그합니다.

Clamp MCP와 함께 사용할 때 가장 효과적

이 스킬들은 분석 도구에 독립적이지만 Clamp 특정 도구 호출을 포함합니다. Clamp MCP가 연결되어 있으면 에이전트는 메서드의 각 단계에서 정확히 어떤 도구(get_overview, get_top_referrers, create_funnel 등)를 사용해야 하는지 알고 있습니다.

다른 분석 소스를 사용하시나요? 메서드는 여전히 적용되며 도구 이름만 변경됩니다.

기여

이슈 및 PR을 환영합니다. 스킬은 skills/<name>/SKILL.md에 위치합니다. 파일 형식은 Agent Skills 스펙을 참조하세요.

이 리포지토리의 스타일 규칙:

• 스킬 description에 주요 사용 사례를 앞부분에 배치하세요 (처음 200자가 로드 여부를 결정합니다).
• SKILL.md를 400줄 미만으로 유지하세요. 긴 참조 테이블은 형제 .md 파일로 옮기세요.
• 방법론을 먼저, 도구 이름은 나중에. 하나의 분석 제품에서만 작동하는 스킬보다 모든 곳에서 작동하는 스킬이 더 가치 있습니다.
• 엠 대시는 사용하지 마세요.

라이선스

MIT. LICENSE를 참조하세요.