.claude/skills/ 안에 깔린 광고 자동화 스킬과 에이전트를 팀원용 말로 정리한 문서
.claude/skills/ 안에 깔린 광고 자동화 스킬 34개와 그걸 뒤에서 도와주는 일꾼(에이전트) 25개를 팀원이 알아볼 수 있는 말로 정리한 것입니다.전체 34개 스킬은 모두 .claude/skills/<이름>/SKILL.md 파일을 직접 읽고 분류했습니다. 아래 3그룹 배정은 조사자(AI)의 판단입니다 — 사용자가 최종 확인해주세요.
| 스킬 이름 | 한 줄 설명 | 우리(아마존 셀러)한테 쓸모 | 비고 |
|---|---|---|---|
ads | 나머지 33개 스킬을 상황에 맞게 골라서 불러주는 "관제탑" 역할 | "구글 광고 감사해줘"라고만 말해도 알아서 맞는 스킬로 연결해줌 | 이 스킬 하나만 알아도 나머지는 자동 라우팅됨 |
ads-amazon | 아마존 광고 계정(스폰서드 프로덕트/브랜드/디스플레이·DSP)을 점검 | 우리 핵심 업무와 100% 직결 | 아래 상세 참고 |
ads-audit | 아마존 포함 최대 12개 채널을 한 번에 종합 점검해 점수화 | 아마존 하나만 또는 여러 채널 묶어서 정기 점검할 때 | 아래 상세 참고 |
ads-budget | 예산을 어디에 얼마나 쓸지, 입찰가를 어떻게 조정할지 설계 | 광고비 배분·증액/감액 판단할 때 | 아래 상세 참고 |
ads-math | CPA·ROAS·손익분기점 같은 광고 숫자 계산 | "이 캠페인이 이득인지" 숫자로 확인할 때 | 아래 상세 참고 |
ads-report | 감사/기획 결과를 사람이 읽는 문서(마크다운/HTML/PDF)로 변환 | 상사·거래처에 보여줄 보고서 뽑을 때 | 아래 상세 참고 |
ads-creative | 광고 소재(카피·이미지·영상)의 피로도와 빈틈을 점검 | 어떤 이미지/카피를 갈아야 할지 판단할 때 | 아래 상세 참고 |
ads-competitor | 경쟁사가 어떤 광고를 하는지 공개 자료로 조사 | 경쟁사 벤치마크, 신제품 런칭 전 조사 | 아래 상세 참고 |
ads-optimize | 캠페인 성과를 보고 무엇을 바꿀지 제안(예산 재배분, 입찰 조정 등) | CPA가 안 좋을 때 "뭘 고쳐야 하나" 진단 | 아래 상세 참고 |
ads-monitor | 최근 데이터 두 시점을 비교해 이상 신호를 잡아냄 | 매일/매주 계정 이상 여부 체크 | 아래 상세 참고 |
ads-test | A/B 테스트(실험) 설계와 결과 판독 | "이미지 A vs B 뭐가 더 나은지" 제대로 검증할 때 | 아래 상세 참고 |
ads-plan | 목표부터 채널·예산·소재·측정까지 아우르는 전체 전략 문서화 | 신제품/신시즌 광고 전략 처음 짤 때 | 아래 상세 참고 |
ads-setup | 새 브랜드/계정을 시스템에 등록(목표, KPI, 승인 권한자 기록) | 새 프로젝트·새 브랜드 시작할 때 | 아래 상세 참고 |
ads-create | 캠페인 카피(제목·설명·후크) 여러 안을 생성 | 스폰서드 브랜드 헤드라인, 광고 카피 초안 필요할 때 | 아래 상세 참고 |
ads-generate | 브리프를 바탕으로 광고 이미지를 AI로 생성 | 배너·카드뉴스용 이미지 필요할 때 | 아래 상세 참고 |
ads-photoshoot | 제품 사진 한 장으로 스튜디오컷·라이프스타일컷 등 여러 버전 생성 | 아마존 메인 이미지·A+ 콘텐츠 이미지 다양화 | 아래 상세 참고 — 아마존 셀러에게 특히 유용 |
ads-launch | 승인된 계획을 실제 캠페인으로 게시하는 단계 | 광고를 실제로 올릴 준비가 됐을 때 | 아마존 계정에 실제로 연결돼 작동하는지는 미확인(아래 참고) |
| 스킬 이름 | 한 줄 설명 | 우리한테 쓸모 | 비고 |
|---|---|---|---|
ads-google | 구글 광고(검색·쇼핑·PMax) 계정 점검 | 아마존 외 구글 검색광고로 외부 트래픽 유입 시작하면 필요 | |
ads-meta | 메타(페이스북·인스타그램) 광고 점검 | 인스타/페북으로 브랜드 인지도 광고 시작하면 필요 | |
ads-youtube | 유튜브 영상 광고 점검 | 유튜브 광고 시작하면 필요 | |
ads-tiktok | 틱톡 광고 점검 | 틱톡샵 등으로 채널 확장하면 필요 | |
ads-microsoft | 마이크로소프트(빙) 광고 점검 | 검색광고 채널 다변화 시 필요 | |
ads-linkedin | 링크드인 광고 점검(B2B 채널) | 우리는 B2C 상품 중심이라 당장 우선순위 낮음 | |
ads-attribution | 여러 채널의 전환 기록이 서로 비교 가능한지 검증 | 아마존+메타+구글을 동시에 돌리기 시작하면 필요해짐 | 예: 메타는 7일 기준, 구글은 30일 기준으로 세는데 이걸 그냥 더하면 안 된다고 막아줌 |
ads-landing | 광고 클릭 후 도착하는 페이지(랜딩페이지) 품질 점검 | 아마존은 리스팅 자체가 랜딩페이지라 지금은 덜 필요, 별도 브랜드 사이트 운영 시 유용 | |
ads-server-side-tracking | 서버 쪽에서 전환 데이터를 보내는 방식(예: 메타 CAPI) 점검 | 메타/구글 광고를 본격적으로 돌릴 때 유용 | |
ads-dna | 회사 웹사이트에서 브랜드 톤·색상·문체를 자동으로 뽑아냄 | 별도 브랜드 사이트가 있으면 유용 | |
ads-validate | 이 시스템(스킬 도구) 자체가 제대로 설정됐는지 점검 | 광고 실무보다는 이 도구를 관리하는 담당자용 | |
ads-research | 이 시스템이 들고 있는 광고 플랫폼 지식을 최신으로 갱신 | 도구 자체의 내부 유지보수용 |
| 스킬 이름 | 한 줄 설명 | 비고 |
|---|---|---|
ads-apple | 애플 서치 애즈(앱스토어 광고) 점검 | 우리는 앱이 없음 |
ads-reddit | 레딧 광고 점검 | 안 씀 |
ads-pinterest | 핀터레스트 광고 점검 | 안 씀 |
ads-snapchat | 스냅챗 광고 점검 | 안 씀 |
ads-x | X(옛 트위터) 광고 점검 | 안 씀 |
ads — 총괄 지휘 스킬무엇을 하나: 나머지 33개 스킬을 상황에 맞게 골라서 불러주는 "관제탑". 사용자가 "구글 광고 감사해줘"라고만 말해도 알아서 ads-google로 연결해줌.
어떤 입력이 필요한가: 우리 사업 모델, 목표, 활성 플랫폼, 예산, 계정 접근 권한 같은 기본 정보.
무엇이 나오나: 요청에 맞는 세부 스킬의 결과물(감사 보고서, 예산안, 소재 등).
언제 부르나: 어떤 스킬을 써야 할지 애매할 때, 그냥 "/ads ~"라고 말하면 알아서 라우팅해줌.
ads-amazon — 아마존 광고 감사무엇을 하나: 아마존 광고 계정(스폰서드 프로덕트/브랜드/디스플레이·DSP)을 점검해서 문제와 기회를 찾아줌.
어떤 입력이 필요한가: 계정 익스포트나 화면 캡처, 목표 ACOS(광고비를 매출로 나눈 비율 — 낮을수록 효율 좋음)·TACOS(전체 매출 대비 광고비 비율), 기간, 통화.
무엇이 나오나: 항목별 통과/실패 판정과 우선순위가 매겨진 개선 제안 목록. 계정을 바로 고치지는 않고 제안만 함.
언제 부르나: 정기 점검, 신규 계정 인수, "왜 ACOS가 올랐지" 같은 진단이 필요할 때.
예시: 검색어 보고서에서 돈만 쓰고 안 팔리는 키워드를 찾아 "이건 제외 키워드로 넣으라"고 근거와 함께 알려줌 — 단, 진짜 검색어 데이터가 있어야만 작동하고, 데이터 없이 키워드를 지어내지는 않도록 설계돼 있음.
ads-audit — 통합 광고 감사무엇을 하나: 아마존을 포함한 최대 12개 채널을 동시에 또는 선택적으로 훑어 계정 건강도를 점수로 만들고, 사람이 읽을 보고서로 뽑아줌.
어떤 입력이 필요한가: 감사할 플랫폼 목록과 각 플랫폼 데이터.
무엇이 나오나: 플랫폼별 점수 + 전체 종합 점수, "이 부분은 증거가 부족하다"는 표시, 우선순위 액션 플랜.
언제 부르나: 여러 채널을 한 번에 종합 점검해야 할 때 (예: 아마존+구글+메타 동시 점검).
특징: 한 플랫폼 데이터가 없으면 그 플랫폼은 "실패"로 표시하고 전체 점수 계산에서 빼지, 억지로 0점 처리해서 점수를 깎지 않음 — "모르는 건 모른다"고 정직하게 표시하는 설계.
ads-budget — 예산/입찰 설계무엇을 하나: 예산을 어디에 얼마나 쓸지, 입찰가를 어떻게 조정할지 설계.
어떤 입력이 필요한가: 목표 CPA(전환 1건당 비용)·ROAS, 마진율, 현금 여력, 계절성.
무엇이 나오나: 플랫폼/캠페인별 배분 금액, 실행 시점, 안전장치(예: "여기까지만 늘려라" 상한선), 잘못됐을 때 되돌리는 기준까지 포함한 실행안.
언제 부르나: 광고비를 늘리거나 줄이거나 채널 간 옮길 때.
주의: "무조건 예산을 70/20/10 비율로 나눠라" 같은 고정 공식을 정답처럼 적용하지 않고, 우리 상황에 맞춰 계산해줌.
ads-math — 광고비 계산기무엇을 하나: CPA·ROAS·손익분기점·LTV:CAC(고객 한 명이 평생 벌어다 주는 돈 대비 그 고객을 얻는 데 든 비용) 같은 광고 관련 숫자를 계산.
어떤 입력이 필요한가: 매출, 광고비, 마진율, 기간 등 숫자.
무엇이 나오나: 계산식 + 결과값 + 상황이 나쁠 때/좋을 때 시나리오까지 함께 제시.
언제 부르나: "이 캠페인이 손익분기점을 넘으려면 전환율이 몇 퍼센트여야 하나" 같은 계산이 필요할 때.
ads-report — 보고서 출력무엇을 하나: 이미 만들어진 감사·기획 결과 데이터를 사람이 읽는 문서(마크다운/HTML/PDF)로 변환.
어떤 입력이 필요한가: 다른 스킬이 만든 검증된 결과 데이터.
무엇이 나오나: 보고서 파일.
언제 부르나: 감사나 기획이 끝난 뒤 고객·상사에게 보여줄 문서가 필요할 때.
ads-creative — 광고 소재 감사무엇을 하나: 광고 소재(카피·이미지·영상)를 점검해서 뭐가 지쳤는지(반응이 떨어진 것), 어떤 포맷이 빠졌는지 찾아줌.
어떤 입력이 필요한가: 소재 목록과 시간에 따른 노출·반응 데이터.
무엇이 나오나: 우선순위가 매겨진 "이 소재를 갱신하라"는 지시서.
언제 부르나: 광고 성과가 떨어지는데 원인이 소재 피로 때문인지 확인하고 싶을 때.
예시: "이 이미지는 만든 지 오래돼서가 아니라, 노출 대비 반응이 실제로 떨어지고 있어서 교체가 필요하다"처럼 진짜 데이터로 판단함 — 날짜만 보고 "오래됐으니 바꿔라"고 하지 않음.
ads-competitor — 경쟁사 광고 조사무엇을 하나: 경쟁사가 어떤 광고를 하는지 공개된 광고 라이브러리 등에서 조사.
어떤 입력이 필요한가: 경쟁사 이름, 시장, 조사 목적.
무엇이 나오나: 경쟁사의 메시지·소재 패턴 정리와 우리가 파고들 틈새 제안.
언제 부르나: 신제품 런칭 전 경쟁 구도 파악, 광고 카피 아이디어가 필요할 때.
주의: 비공개 계정을 몰래 훔쳐보거나 저작권 있는 이미지를 그대로 베끼지 않음 — 공개된 자료만 사용하도록 설계됨.
ads-optimize — 광고 최적화 실행무엇을 하나: 캠페인 성과를 보고 무엇을 바꿔야 할지 제안 (예산 재배분, 입찰 조정, 소재 교체 등).
어떤 입력이 필요한가: 최근 계정 데이터, 지난 결정 이력, 비용 구조.
무엇이 나오나: 기본은 "초안(draft)"만 나옴 — 실제로 계정을 바꾸려면 여러 승인 단계를 거쳐야 실행되도록 막혀 있음.
언제 부르나: "이 캠페인 CPA가 높은데 뭘 바꿔야 하나" 판단이 필요할 때.
중요: 캠페인을 영구 삭제하는 요청은 아예 거부하도록 설계돼 있음 — 대신 일시중지·보관·백업처럼 되돌릴 수 있는 방법만 제안함.
ads-monitor — 광고 모니터링무엇을 하나: 두 시점 이상의 데이터를 비교해서 이상한 변화를 잡아냄 (예산 소진 속도, 성과 급락, 트래킹 오류 등).
어떤 입력이 필요한가: 최소 두 시점의 계정 스냅샷.
무엇이 나오나: 관찰된 이상 신호, 원인 후보, 확인해야 할 것 목록. 계정 자체는 건드리지 않고 보고만 함.
언제 부르나: 매일/매주 정기 점검, 캠페인 런칭 직후 확인할 때.
ads-test — A/B 테스트 설계무엇을 하나: 광고 실험(A/B 테스트) 설계와 결과 판독.
어떤 입력이 필요한가: 가설, 비교군, 목표 지표, 최소 필요 표본 수 조건.
무엇이 나오나: 실험 설계서 또는 "이 실험 결과가 통계적으로 믿을 만한지" 판정.
언제 부르나: "이미지 A와 B 중 뭐가 더 나은지" 제대로 검증하고 싶을 때.
주의: 표본이 부족한데 우연히 좋아 보이는 결과를 성급하게 "이겼다"고 결론 내지 않도록 막아줌.
ads-plan — 광고 전략 기획무엇을 하나: 목표부터 채널 선택, 예산, 소재, 측정 방법까지 아우르는 전체 광고 전략을 문서로 작성.
어떤 입력이 필요한가: 사업 목표, 고객, 예산, 기간.
무엇이 나오나: 누가·언제·무엇을·어떤 조건에서 멈출지까지 포함한 단계별 실행 계획.
언제 부르나: 새 시즌/신제품 광고 전략을 처음부터 짤 때.
ads-setup — 계정/브랜드 온보딩무엇을 하나: 새 브랜드나 계정을 이 시스템에 등록 — 사업 정보, 목표, KPI, 승인 권한자를 기록.
어떤 입력이 필요한가: 사업 모델, 목표, 활성 채널, 계정 ID.
무엇이 나오나: 저장된 "브랜드 프로필". 단, API 키·비밀번호 같은 진짜 비밀 값은 여기에 저장하지 않고 "환경변수에 있다"는 표시만 남기게 돼 있음(보안 설계).
언제 부르나: 새 프로젝트·새 클라이언트를 처음 시작할 때.
ads-create — 광고 카피/컨셉 제작무엇을 하나: 캠페인 카피(제목·설명·후크)와 컨셉 아이디어를 여러 개 생성.
어떤 입력이 필요한가: 브랜드 정보, 목표, 타겟 고객, 증명할 수 있는 사실(과장 광고 방지용).
무엇이 나오나: 서로 다른 접근의 카피 여러 안.
언제 부르나: 스폰서드 브랜드 헤드라인, 광고 카피 초안이 필요할 때.
주의: 검증 안 된 후기·인증마크·할인 문구를 지어내지 않음 — 반드시 사람이 최종 검수해야 한다고 못 박혀 있음.
ads-generate — 광고 이미지 생성무엇을 하나: 브랜드 프로필과 카피 브리프를 바탕으로 광고 이미지를 AI로 생성.
어떤 입력이 필요한가: 승인된 브리프, 브랜드 톤, 이미지 생성 도구(제공처) 설정.
무엇이 나오나: 이미지 파일 + 어떤 프롬프트·모델로 만들었는지 기록.
언제 부르나: 배너·카드뉴스용 이미지가 필요할 때.
주의: 이미지 생성 도구가 미리 설정돼 있어야 작동함 — 설정이 안 돼 있으면 "이렇게 설정하라"고만 안내함 (미확인: 우리 계정에 실제로 어떤 이미지 생성 도구가 연결돼 있는지는 이번 조사에서 안 봄).
ads-photoshoot — 제품 사진 생성무엇을 하나: 실제 제품 사진 한 장을 바탕으로 스튜디오컷·라이프스타일컷 등 다양한 버전을 AI로 만들어줌.
어떤 입력이 필요한가: 우리가 쓸 권리가 있는 원본 제품 사진.
무엇이 나오나: 여러 버전의 제품 이미지 — 제품 모양·로고·라벨·색상은 우리가 명시적으로 허락하지 않는 한 임의로 바꾸지 않도록 설계됨.
언제 부르나: 아마존 메인 이미지, A+ 콘텐츠, 라이프스타일 이미지가 여러 개 필요할 때.
주의: 사람이 반드시 최종 확인해야 함. 과장된 "before/after" 비교 이미지는 만들지 않도록 막혀 있음.
ads-launch — 캠페인 실제 게시무엇을 하나: 승인된 계획을 실제 캠페인으로 올리는 단계.
어떤 입력이 필요한가: 계정 권한, 예산 상한, 승인자 서명.
무엇이 나오나: 기본은 "초안"만 생성됨. 실제로 계정에 반영하려면(--apply) 그 정확한 기능이 미리 테스트돼 있고 승인까지 받아야만 실행되도록 설계돼 있음.
언제 부르나: 광고를 실제로 게시할 준비가 됐을 때.
미확인: 이 스킬이 실제로 아마존 광고 계정에 API로 연결돼 캠페인을 자동으로 올릴 수 있는지는 SKILL.md만으로는 확인 안 됨 — "승인 게이트가 있다"는 설계 문서만 확인했고, 실제 연결 여부는 별도 확인이 필요함.
이 표에 있는 "에이전트"는 스킬이 혼자 다 하지 않고 세부 작업을 대신 시키는 전문 일꾼입니다. 예를 들어 "아마존 광고 감사" 스킬(ads-amazon)은 실제 항목 체크를 audit-amazon이라는 일꾼에게 맡깁니다. 우리는 이 일꾼들을 직접 부를 일은 거의 없고, 위의 스킬을 실행하면 자동으로 뒤에서 동원됩니다.
| 에이전트 이름 | 하는 일 (한 줄) |
|---|---|
audit-amazon | 아마존 광고 계정을 점검해 항목별 통과/실패를 근거와 함께 돌려주는 일꾼 |
audit-google | 구글 광고 계정을 점검하는 일꾼 |
audit-meta | 메타(페이스북·인스타그램) 광고 계정을 점검하는 일꾼 |
audit-youtube | 유튜브 광고를 점검하는 일꾼 |
audit-linkedin | 링크드인 광고를 점검하는 일꾼 |
audit-tiktok | 틱톡 광고를 점검하는 일꾼 |
audit-microsoft | 마이크로소프트(빙) 광고를 점검하는 일꾼 |
audit-apple | 애플 서치 애즈를 점검하는 일꾼 |
audit-reddit | 레딧 광고를 점검하는 일꾼 |
audit-pinterest | 핀터레스트 광고를 점검하는 일꾼 |
audit-snapchat | 스냅챗 광고를 점검하는 일꾼 |
audit-x | X(옛 트위터) 광고를 점검하는 일꾼 |
audit-budget | 예산·입찰·수익성(마진 대비 광고비 등)을 점검하는 일꾼 |
audit-creative | 광고 소재(카피·이미지·영상)의 품질과 피로도를 점검하는 일꾼 |
audit-tracking | 전환 추적(픽셀, 서버사이드 이벤트 등)이 제대로 작동하는지 점검하는 일꾼 |
audit-policy-compliance | 플랫폼 정책 위반 여부(광고 자격, 규제 카테고리 등)를 점검하는 일꾼 |
audit-regulatory-compliance | 개인정보보호법 등 법규 준수 여부를 점검하는 일꾼 |
copy-writer | 광고 카피 초안을 여러 개 써서 후보로 제출하는 일꾼 (최종 문서는 직접 안 씀) |
creative-strategist | 캠페인 컨셉·브리프 아이디어를 내는 일꾼 |
visual-designer | 이미지 소재 후보를 만들어 제출하는 일꾼 |
format-adapter | 만들어진 소재가 각 플랫폼 규격(사이즈·글자 수 제한 등)에 맞는지 검증하는 일꾼 |
research-worker | 특정 플랫폼·정책·API에 대한 자료를 찾아오는 일꾼 |
source-verifier | 조사된 정보의 출처가 진짜 믿을 만한지 검증하는 일꾼 |
release-verifier | 이 시스템 자체를 새 버전으로 내보내기 전에 최종 점검하는 일꾼 (개발자용) |
skill-reviewer | 스킬 설계 자체(라우팅·안전장치 등)를 검토하는 일꾼 (개발자용) |
ads/references/ 폴더에는 참고자료 38개 파일이 있습니다(플랫폼별 감사 기준, 크리에이티브 규격, 컴플라이언스 문서 등). 파일 이름 목록만 확인했고 내용을 전부 읽지는 않았습니다 — 필요하면 개별 요청 시 추가로 확인 가능합니다.ads-google, ads-meta, ads-youtube, ads-linkedin, ads-tiktok, ads-microsoft, ads-apple, ads-reddit, ads-pinterest, ads-snapchat, ads-x)은 모두 거의 같은 틀(절차/경계/출력 구조)을 쓰는 것을 확인했고, 각 파일의 앞부분(설명·제목)만 개별 확인했습니다. 전체 SKILL.md 본문까지 한 글자씩 다 읽은 건 아니라는 뜻입니다..md 파일 본문)은 열어보지 않았고, 이름과 한 줄 설명만 수집했습니다(요청사항대로).