kostja94/marketing-skills

AI 에이전트(AI agents)를 위한 마크다운(Markdown) 기술 라이브러리 - SEO, 콘텐츠, 페이지, 유료 광고, 채널, 전략. 프로젝트 컨텍스트(project context)와 기술(skills)을 추가하면, 에이전트가 맞춤화된 프로덕션 수준(production-ready)의 결과물을 제공합니다. Cursor, Claude Code, OpenClaw, Lovable 및 마크다운을 읽을 수 있는 모든 AI와 함께 작동합니다.

By kostja | 기술 작성(skill-authoring) | 변경 이력(CHANGELOG) | zyjstc@gmail.com

# 특정 기술 설치 (권장 - 작업당 2-3개; SkillsBench 참조, 논문 1편 기준)
npx skills add kostja94/marketing-skills --skill robots-txt title-tag meta-description
# 모든 기술 설치
...

컨텍스트 (Context) (맞춤형 출력을 위해 필수): project-context.md 파일을 .cursor/ 또는 .claude/ 폴더로 복사한 후 내용을 채우세요. 템플릿(Templates) | 프로젝트 작업 트래커(Project Task Tracker)

참고: CLI는 기술(skills)만 설치하며(평면 구조), templates/나 docs/는 설치하지 않습니다. 템플릿이 필요한 경우 'Clone + 복사' 방식을 사용하세요.

기술(Skills)은 AI 에이전트에게 집중된 지식과 워크플로(workflows)를 제공하는 **마크다운 파일(markdown files)**입니다. 프로젝트에 기술을 추가하면, 에이전트가 프롬프트(prompt)에서 적절한 기술을 선택하여 SEO, 콘텐츠 및 마케팅 모범 사례(best practices)를 적용합니다.

SkillsBench (2025, 참조용으로만 사용 - 논문 1편의 결과): 사람이 큐레이션한 기술은 작업 성공률을 +16.2pp 향상시키며, 수직적 도메인(예: 마케팅, SEO)에서 가장 큰 이점을 얻습니다.

Skills = 에이전트용. 인간 가이드(Human guides) -> Alignify.

시나리오	링크
개인 사이트 / 포트폴리오	usage.md S7.1
...
파트너십: 바이브 코딩(vibe coding) 제품이나 AI 마케팅 에이전트를 구축 중이신가요? 통합을 위해 연락해 주세요.

이 내용이 유용했나요? Star를 누르거나 동료들과 공유해 주시면 다른 사람들이 발견하는 데 도움이 됩니다. 감사합니다.

방법	시점
CLI	전체 또는 선택적 설치; 기술만 설치, 평면 구조
Clone + 복사	템플릿 또는 전체 구조가 필요한 경우: cp -r marketing-skills/skills/* .cursor/skills/ 및 cp -r marketing-skills/templates .cursor/
Git 서브모듈 (Git submodule)	git submodule add https://github.com/kostja94/marketing-skills.git .cursor/marketing-skills

기술 디렉토리 (Skill directories) (에이전트 기술 사양 (Agent Skills spec)): .agents/skills/, .cursor/skills/, .claude/skills/, ~/.cursor/skills/

. 플랫폼 (Platforms): Cursor, Claude Code, OpenClaw, Lovable, v0, Bolt - 네이티브로 사용하거나 프로젝트로 복사; ChatGPT/Claude Web - 스킬 마크다운을 붙여넣기. 전체 가이드

에이전트에게 물어보세요 - 에이전트가 적절한 스킬을 선택합니다. 예시:

사용자의 입력	스킬 (Skill)
"SEO 전략" / "SEO 계획" / "SEO를 어디서부터 시작해야 할까요"	seo-strategy
...
컨텍스트 (Context)가 없으면 결과물은 일반적인 수준에 머뭅니다. 제품, 타겟 고객, 브랜드 정보를 위해 project-context.md를 추가하세요 - 스킬들이 이를 자동으로 읽습니다.

컨텍스트 (Context)	목적 (Purpose)
project-context.md	제품, 타겟 고객, 브랜드, 키워드 - 스킬이 자동으로 읽음
project-task-tracker.md	작업 상태, 우선순위 - 에이전트가 다음 단계를 제안
프로젝트 규칙 (.cursor/rules/)	코드 스타일, 컨벤션 (Conventions)
AGENTS.md	프로젝트 지침 (Instructions)

시작하기: 개요 (Overview), 1-4, 8번부터 시작하세요. 5-7번은 준비되는 대로 추가하세요. 정기적으로 업데이트하세요 - 오래된 컨텍스트는 품질을 저하시킵니다. 템플릿 | 스킬 작성 (skill-authoring) S8

9개 카테고리, 160개 이상의 스킬. 전체 목록 | npx skills add kostja94/marketing-skills --list

카테고리 (Category)	범위 (Scope)
SEO	기술적 SEO (robots, sitemap, canonical, 크롤링 가능성), 온페이지 (On-Page) SEO (제목, 메타, 스키마, 헤딩), 콘텐츠 (키워드, 콘텐츠, 경쟁사), 오프페이지 (Off-Page) SEO, 로컬 (Local) SEO, 전술 (Tactics)
콘텐츠 (Content)	카피라이팅 (Copywriting), 비디오, 비주얼, 번역
유료 광고 (Paid Ads)	전략 + 12개 플랫폼 (Google, Meta, LinkedIn, TikTok 등)
페이지 (Pages)	40개 이상의 유형 - 브랜드, 콘텐츠, 마케팅, 법적, 유틸리티; 기능(Features) vs 유스케이스(Use cases) vs 솔루션(Solutions)
컴포넌트 (Components)	네비게이션 (Nav), 브레드크럼 (Breadcrumb), 푸터 (Footer), 히어로 (Hero), CTA, 로고, 고객 후기 (Testimonials) 등
채널 (Channels)	제휴 (Affiliate), 이메일, 인플루언서, 추천 (Referral), 디렉토리, PR
플랫폼 (Platforms)	X, Reddit, LinkedIn, TikTok, YouTube, Medium, GitHub, Grokipedia
전략 (Strategies)	출시 (Launch)
분석 (Analytics)	트래픽, 트래킹 (Tracking), Search Console, AI 트래픽

워크플로우 (Workflow): 기술적 SEO -> 온페이지 (On-Page) -> 콘텐츠 -> 오프페이지 (Off-Page). seo-strategy가 이를 조율합니다. 각 스킬에는 **관련 스킬 (Related Skills)**이 있습니다. 반복적인 작업의 경우 "서론은 건너뛰어" 또는 "그냥 실행해"라고 말하세요. 의존성 맵 (Dependency maps)

+-------------------------------------------------------------+
| 기술적 SEO (Technical SEO) (기초) |
| robots | sitemap | canonical | indexing | indexnow |
| ... |
+-------------------------------------------------------------+

팁 (Tip)	실행 (Action)
프로젝트 컨텍스트 (Project Context)	맞춤형 출력을 위해 project-context.md를 추가하세요
서론 건너뛰기 (Skip intro)	"skip intro" 또는 "just do it" 입력 시 -> 바로 실행 (Action) 단계로 이동
관련 기술 (Related Skills)	각 기술은 의존성 (dependencies)을 위한 관련 기술 (Related Skills)을 포함합니다

모든 기술은 순수 마크다운 (Markdown) 형식이며, 실행 가능한 코드는 포함되지 않습니다. 범위는 SEO, 콘텐츠, 마케팅으로 제한됩니다. 데이터 유출 (data exfiltration)은 허용되지 않습니다. 전체 감사 (Full audit) 완료.

문서 (Doc)	목적 (Purpose)
usage	플랫폼, 설치, 사용 사례, 로드맵
...

생태계 (Ecosystem): 에이전트 기술 사양 (Agent Skills Specification) | skills.sh | Vercel skills CLI