arkaos 4.26.0 → 4.28.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (412) hide show
  1. package/README.md +7 -5
  2. package/THE-ARKAOS-GUIDE.md +7 -7
  3. package/VERSION +1 -1
  4. package/arka/SKILL.md +1 -1
  5. package/arka/skills/human-writing/SKILL.md +106 -0
  6. package/arka/skills/human-writing/references/anti-slop-phrases.md +131 -0
  7. package/arka/skills/human-writing/references/checklist.md +66 -0
  8. package/arka/skills/human-writing/references/content-refresh.md +38 -0
  9. package/arka/skills/human-writing/references/plain-english-alternatives.md +394 -0
  10. package/arka/skills/human-writing/references/pt-pt-anti-slop.md +82 -0
  11. package/arka/skills/human-writing/references/stop-slop.LICENSE +21 -0
  12. package/arka/skills/human-writing/references/structural-patterns.md +151 -0
  13. package/config/claude-agents/content-marketer.md +1 -1
  14. package/config/claude-agents/content-strategist.md +1 -1
  15. package/config/claude-agents/eduardo-copy.md +13 -0
  16. package/config/claude-agents/lifecycle-marketer.md +50 -0
  17. package/config/claude-agents/pr-partnerships.md +50 -0
  18. package/config/claude-agents/product-marketer.md +50 -0
  19. package/config/claude-agents/repurpose-distributor.md +1 -1
  20. package/config/claude-agents/sales-copywriter.md +1 -1
  21. package/config/claude-agents/scriptwriter.md +1 -1
  22. package/config/claude-agents/viral-engineer.md +1 -1
  23. package/config/evals/community.yaml +137 -0
  24. package/config/evals/content.yaml +298 -0
  25. package/config/evals/landing.yaml +927 -0
  26. package/config/evals/marketing.yaml +3836 -0
  27. package/config/evals/saas.yaml +616 -0
  28. package/config/evals/sales.yaml +437 -0
  29. package/config/skills-curated.yaml +2 -2
  30. package/config/skills-provenance.yaml +194 -21
  31. package/core/registry/generator.py +7 -0
  32. package/departments/community/SKILL.md +1 -0
  33. package/departments/community/skills/community-marketing/SKILL.md +200 -0
  34. package/departments/content/SKILL.md +1 -0
  35. package/departments/content/agents/content-strategist.yaml +1 -0
  36. package/departments/content/agents/repurpose-distributor.yaml +1 -0
  37. package/departments/content/agents/scriptwriter.yaml +1 -0
  38. package/departments/content/agents/viral-engineer.yaml +1 -0
  39. package/departments/content/skills/image-create/SKILL.md +375 -0
  40. package/departments/content/skills/image-create/references/ai-image-prompting.md +229 -0
  41. package/departments/content/skills/video-produce/SKILL.md +220 -0
  42. package/departments/content/skills/video-produce/references/ai-video-prompting.md +175 -0
  43. package/departments/content/skills/video-produce/references/edit-anatomy.md +84 -0
  44. package/departments/landing/SKILL.md +3 -0
  45. package/departments/landing/agents/sales-copywriter.yaml +1 -0
  46. package/departments/landing/skills/affiliate-bridge/SKILL.md +291 -5
  47. package/departments/landing/skills/affiliate-bridge/references/affiliate-programs.md +167 -0
  48. package/departments/landing/skills/affiliate-bridge/references/program-examples.md +143 -0
  49. package/departments/landing/skills/copy-framework/SKILL.md +241 -0
  50. package/departments/landing/skills/copy-framework/references/copy-frameworks.md +344 -0
  51. package/departments/landing/skills/copy-framework/references/natural-transitions.md +272 -0
  52. package/departments/landing/skills/lead-magnet/SKILL.md +337 -0
  53. package/departments/landing/skills/lead-magnet/references/benchmarks.md +129 -0
  54. package/departments/landing/skills/lead-magnet/references/format-guide.md +196 -0
  55. package/departments/landing/skills/offer-create/SKILL.md +105 -8
  56. package/departments/landing/skills/offer-create/references/bonus-stacking.md +150 -0
  57. package/departments/landing/skills/offer-create/references/examples.md +215 -0
  58. package/departments/landing/skills/offer-create/references/guarantee-design.md +172 -0
  59. package/departments/landing/skills/offer-create/references/offer-anatomy.md +203 -0
  60. package/departments/landing/skills/offer-create/references/offer-formats.md +240 -0
  61. package/departments/landing/skills/offer-create/references/scarcity-urgency.md +175 -0
  62. package/departments/landing/skills/offer-create/references/value-equation.md +134 -0
  63. package/departments/landing/skills/optimize-page/SKILL.md +185 -4
  64. package/departments/landing/skills/optimize-page/references/experiments.md +248 -0
  65. package/departments/landing/skills/optimize-page/references/form.md +422 -0
  66. package/departments/landing/skills/page-architect/SKILL.md +373 -5
  67. package/departments/landing/skills/page-architect/references/mermaid-templates.md +216 -0
  68. package/departments/landing/skills/page-architect/references/navigation-patterns.md +305 -0
  69. package/departments/landing/skills/page-architect/references/site-type-templates.md +293 -0
  70. package/departments/landing/skills/popup-design/SKILL.md +481 -0
  71. package/departments/landing/skills/signup-optimize/SKILL.md +385 -0
  72. package/departments/marketing/SKILL.md +22 -1
  73. package/departments/marketing/agents/content-marketer.yaml +1 -0
  74. package/departments/marketing/agents/growth-marketing/lifecycle-marketer.yaml +75 -0
  75. package/departments/marketing/agents/growth-marketing/pr-partnerships.yaml +74 -0
  76. package/departments/marketing/agents/growth-marketing/product-marketer.yaml +79 -0
  77. package/departments/marketing/agents/marketing-director.yaml +1 -0
  78. package/departments/marketing/skills/ab-test/SKILL.md +322 -3
  79. package/departments/marketing/skills/ab-test/references/sample-size-guide.md +263 -0
  80. package/departments/marketing/skills/ab-test/references/test-templates.md +277 -0
  81. package/departments/marketing/skills/ad-creative/SKILL.md +451 -0
  82. package/departments/marketing/skills/ad-creative/references/creative-review-page.md +106 -0
  83. package/departments/marketing/skills/ad-creative/references/creative-roadmap.md +118 -0
  84. package/departments/marketing/skills/ad-creative/references/generative-tools.md +637 -0
  85. package/departments/marketing/skills/ad-creative/references/hook-system.md +115 -0
  86. package/departments/marketing/skills/ad-creative/references/imessage-video-ads.md +201 -0
  87. package/departments/marketing/skills/ad-creative/references/motion-video-ads.md +126 -0
  88. package/departments/marketing/skills/ad-creative/references/platform-specs.md +213 -0
  89. package/departments/marketing/skills/ad-creative/references/static-ad-templates.md +200 -0
  90. package/departments/marketing/skills/ai-seo/SKILL.md +520 -0
  91. package/departments/marketing/skills/ai-seo/references/citations-vs-recommendations.md +85 -0
  92. package/departments/marketing/skills/ai-seo/references/content-patterns.md +287 -0
  93. package/departments/marketing/skills/ai-seo/references/content-types.md +71 -0
  94. package/departments/marketing/skills/ai-seo/references/okf.md +104 -0
  95. package/departments/marketing/skills/ai-seo/references/platform-ranking-factors.md +154 -0
  96. package/departments/marketing/skills/analytics-report/SKILL.md +310 -1
  97. package/departments/marketing/skills/analytics-report/references/event-library.md +260 -0
  98. package/departments/marketing/skills/analytics-report/references/ga4-implementation.md +300 -0
  99. package/departments/marketing/skills/analytics-report/references/gtm-implementation.md +390 -0
  100. package/departments/marketing/skills/aso/SKILL.md +336 -0
  101. package/departments/marketing/skills/aso/references/apple-specs.md +107 -0
  102. package/departments/marketing/skills/aso/references/benchmarks.md +129 -0
  103. package/departments/marketing/skills/aso/references/google-play-specs.md +131 -0
  104. package/departments/marketing/skills/aso/references/report-template.md +213 -0
  105. package/departments/marketing/skills/aso/references/scoring-criteria.md +213 -0
  106. package/departments/marketing/skills/co-marketing/SKILL.md +316 -0
  107. package/departments/marketing/skills/cold-email/SKILL.md +80 -0
  108. package/departments/marketing/skills/cold-email/references/benchmarks.md +83 -0
  109. package/departments/marketing/skills/cold-email/references/follow-up-sequences.md +81 -0
  110. package/departments/marketing/skills/cold-email/references/frameworks.md +90 -0
  111. package/departments/marketing/skills/cold-email/references/personalization.md +79 -0
  112. package/departments/marketing/skills/cold-email/references/subject-lines.md +53 -0
  113. package/departments/marketing/skills/competitor-analysis/SKILL.md +262 -5
  114. package/departments/marketing/skills/competitor-analysis/references/content-architecture.md +271 -0
  115. package/departments/marketing/skills/competitor-analysis/references/templates.md +223 -0
  116. package/departments/marketing/skills/competitor-profile/SKILL.md +447 -0
  117. package/departments/marketing/skills/competitor-profile/references/templates.md +167 -0
  118. package/departments/marketing/skills/competitor-profile/references/tool-reference.md +179 -0
  119. package/departments/marketing/skills/content-strategy/SKILL.md +398 -0
  120. package/departments/marketing/skills/content-strategy/references/headless-cms.md +194 -0
  121. package/departments/marketing/skills/council/SKILL.md +185 -0
  122. package/departments/marketing/skills/council/references/advisor-template.md +51 -0
  123. package/departments/marketing/skills/council/references/advisors/alex-hormozi.md +43 -0
  124. package/departments/marketing/skills/council/references/advisors/ann-handley.md +43 -0
  125. package/departments/marketing/skills/council/references/advisors/april-dunford.md +41 -0
  126. package/departments/marketing/skills/council/references/advisors/byron-sharp.md +43 -0
  127. package/departments/marketing/skills/council/references/advisors/claude-hopkins.md +42 -0
  128. package/departments/marketing/skills/council/references/advisors/david-ogilvy.md +42 -0
  129. package/departments/marketing/skills/council/references/advisors/eugene-schwartz.md +42 -0
  130. package/departments/marketing/skills/council/references/advisors/gary-halbert.md +43 -0
  131. package/departments/marketing/skills/council/references/advisors/gary-vaynerchuk.md +43 -0
  132. package/departments/marketing/skills/council/references/advisors/rory-sutherland.md +42 -0
  133. package/departments/marketing/skills/council/references/advisors/russell-brunson.md +43 -0
  134. package/departments/marketing/skills/council/references/advisors/seth-godin.md +43 -0
  135. package/departments/marketing/skills/customer-research/SKILL.md +318 -0
  136. package/departments/marketing/skills/customer-research/references/source-guides.md +401 -0
  137. package/departments/marketing/skills/directory-submit/SKILL.md +409 -0
  138. package/departments/marketing/skills/directory-submit/references/directory-list.md +477 -0
  139. package/departments/marketing/skills/directory-submit/references/positioning-variations.md +232 -0
  140. package/departments/marketing/skills/directory-submit/references/submission-tracker-template.csv +266 -0
  141. package/departments/marketing/skills/email-sequence/SKILL.md +309 -2
  142. package/departments/marketing/skills/email-sequence/references/copy-guidelines.md +113 -0
  143. package/departments/marketing/skills/email-sequence/references/email-types.md +515 -0
  144. package/departments/marketing/skills/email-sequence/references/sequence-templates.md +168 -0
  145. package/departments/marketing/skills/free-tools/SKILL.md +203 -0
  146. package/departments/marketing/skills/free-tools/references/tool-types.md +217 -0
  147. package/departments/marketing/skills/marketing-ideas/SKILL.md +191 -0
  148. package/departments/marketing/skills/marketing-ideas/references/ideas-by-category.md +366 -0
  149. package/departments/marketing/skills/marketing-loops/SKILL.md +136 -0
  150. package/departments/marketing/skills/marketing-loops/references/loop-catalog.md +687 -0
  151. package/departments/marketing/skills/marketing-loops/references/loop-guardrails.md +73 -0
  152. package/departments/marketing/skills/marketing-loops/references/loop-orchestration.md +69 -0
  153. package/departments/marketing/skills/marketing-loops/references/loop-state.md +67 -0
  154. package/departments/marketing/skills/marketing-loops/references/loop-template.md +79 -0
  155. package/departments/marketing/skills/marketing-plan/SKILL.md +302 -0
  156. package/departments/marketing/skills/marketing-plan/references/aarrr-framework.md +180 -0
  157. package/departments/marketing/skills/marketing-plan/references/budget-planning.md +168 -0
  158. package/departments/marketing/skills/marketing-plan/references/client-types.md +373 -0
  159. package/departments/marketing/skills/marketing-plan/references/current-state-rubric.md +255 -0
  160. package/departments/marketing/skills/marketing-plan/references/example-quietude.md +972 -0
  161. package/departments/marketing/skills/marketing-plan/references/funding-stage-unlocks.md +230 -0
  162. package/departments/marketing/skills/marketing-plan/references/growth-patterns.md +148 -0
  163. package/departments/marketing/skills/marketing-plan/references/idea-cross-reference.md +265 -0
  164. package/departments/marketing/skills/marketing-plan/references/measurement-framework.md +213 -0
  165. package/departments/marketing/skills/marketing-plan/references/methodology.md +363 -0
  166. package/departments/marketing/skills/marketing-plan/references/ops-stack-mapping.md +197 -0
  167. package/departments/marketing/skills/marketing-plan/references/plan-template.md +494 -0
  168. package/departments/marketing/skills/marketing-plan/references/team-and-agency-model.md +278 -0
  169. package/departments/marketing/skills/marketing-psychology/SKILL.md +479 -0
  170. package/departments/marketing/skills/paid-campaign/SKILL.md +452 -3
  171. package/departments/marketing/skills/paid-campaign/references/abm-playbook.md +93 -0
  172. package/departments/marketing/skills/paid-campaign/references/ad-copy-templates.md +207 -0
  173. package/departments/marketing/skills/paid-campaign/references/audience-targeting.md +243 -0
  174. package/departments/marketing/skills/paid-campaign/references/b2b-paid-playbook.md +115 -0
  175. package/departments/marketing/skills/paid-campaign/references/conversion-tracking.md +361 -0
  176. package/departments/marketing/skills/paid-campaign/references/google-search-playbook.md +120 -0
  177. package/departments/marketing/skills/paid-campaign/references/linkedin-b2b-playbook.md +107 -0
  178. package/departments/marketing/skills/paid-campaign/references/meta-decision-system.md +143 -0
  179. package/departments/marketing/skills/paid-campaign/references/platform-setup-checklists.md +277 -0
  180. package/departments/marketing/skills/paid-campaign/references/rsa-output-spec.md +88 -0
  181. package/departments/marketing/skills/product-marketing/SKILL.md +141 -0
  182. package/departments/marketing/skills/programmatic-seo/SKILL.md +74 -3
  183. package/departments/marketing/skills/programmatic-seo/references/playbooks.md +308 -0
  184. package/departments/marketing/skills/public-relations/SKILL.md +167 -0
  185. package/departments/marketing/skills/public-relations/references/journalist-pitching.md +368 -0
  186. package/departments/marketing/skills/public-relations/references/media-outlets.md +207 -0
  187. package/departments/marketing/skills/public-relations/references/newsjacking.md +218 -0
  188. package/departments/marketing/skills/public-relations/references/press-platforms.md +188 -0
  189. package/departments/marketing/skills/schema-markup/SKILL.md +203 -0
  190. package/departments/marketing/skills/schema-markup/references/schema-examples.md +398 -0
  191. package/departments/marketing/skills/seo-audit/SKILL.md +470 -1
  192. package/departments/marketing/skills/seo-audit/references/ai-writing-detection.md +200 -0
  193. package/departments/marketing/skills/seo-audit/references/international-seo.md +230 -0
  194. package/departments/marketing/skills/sms-campaign/SKILL.md +363 -0
  195. package/departments/marketing/skills/sms-campaign/references/compliance.md +202 -0
  196. package/departments/marketing/skills/sms-campaign/references/platforms.md +318 -0
  197. package/departments/marketing/skills/sms-campaign/references/sequence-templates.md +282 -0
  198. package/departments/marketing/skills/social-strategy/SKILL.md +414 -3
  199. package/departments/marketing/skills/social-strategy/references/carousel-frameworks.md +141 -0
  200. package/departments/marketing/skills/social-strategy/references/listening-sources-template.md +123 -0
  201. package/departments/marketing/skills/social-strategy/references/listening.md +283 -0
  202. package/departments/marketing/skills/social-strategy/references/platform-limits.md +110 -0
  203. package/departments/marketing/skills/social-strategy/references/platforms.md +170 -0
  204. package/departments/marketing/skills/social-strategy/references/post-templates.md +179 -0
  205. package/departments/marketing/skills/social-strategy/references/reverse-engineering.md +195 -0
  206. package/departments/marketing/skills/social-strategy/references/short-form-video.md +237 -0
  207. package/departments/marketing/squad.yaml +10 -1
  208. package/departments/marketing/tools/LICENSE +21 -0
  209. package/departments/marketing/tools/REGISTRY.md +590 -0
  210. package/departments/marketing/tools/clis/README.md +198 -0
  211. package/departments/marketing/tools/clis/activecampaign.js +435 -0
  212. package/departments/marketing/tools/clis/adobe-analytics.js +161 -0
  213. package/departments/marketing/tools/clis/ahrefs.js +192 -0
  214. package/departments/marketing/tools/clis/airops.js +163 -0
  215. package/departments/marketing/tools/clis/amplitude.js +182 -0
  216. package/departments/marketing/tools/clis/apollo.js +142 -0
  217. package/departments/marketing/tools/clis/beehiiv.js +245 -0
  218. package/departments/marketing/tools/clis/brevo.js +368 -0
  219. package/departments/marketing/tools/clis/buffer.js +260 -0
  220. package/departments/marketing/tools/clis/calendly.js +253 -0
  221. package/departments/marketing/tools/clis/clay.js +159 -0
  222. package/departments/marketing/tools/clis/clearbit.js +163 -0
  223. package/departments/marketing/tools/clis/close.js +232 -0
  224. package/departments/marketing/tools/clis/coupler.js +173 -0
  225. package/departments/marketing/tools/clis/crossbeam.js +193 -0
  226. package/departments/marketing/tools/clis/customer-io.js +205 -0
  227. package/departments/marketing/tools/clis/dataforseo.js +257 -0
  228. package/departments/marketing/tools/clis/demio.js +149 -0
  229. package/departments/marketing/tools/clis/dub.js +158 -0
  230. package/departments/marketing/tools/clis/exa.js +147 -0
  231. package/departments/marketing/tools/clis/g2.js +186 -0
  232. package/departments/marketing/tools/clis/ga4.js +194 -0
  233. package/departments/marketing/tools/clis/github-prospects.js +257 -0
  234. package/departments/marketing/tools/clis/google-ads.js +189 -0
  235. package/departments/marketing/tools/clis/google-search-console.js +166 -0
  236. package/departments/marketing/tools/clis/hotjar.js +167 -0
  237. package/departments/marketing/tools/clis/hunter.js +249 -0
  238. package/departments/marketing/tools/clis/instantly.js +270 -0
  239. package/departments/marketing/tools/clis/intercom.js +399 -0
  240. package/departments/marketing/tools/clis/keywords-everywhere.js +185 -0
  241. package/departments/marketing/tools/clis/kit.js +232 -0
  242. package/departments/marketing/tools/clis/klaviyo.js +348 -0
  243. package/departments/marketing/tools/clis/lemlist.js +221 -0
  244. package/departments/marketing/tools/clis/linkedin-ads.js +185 -0
  245. package/departments/marketing/tools/clis/livestorm.js +292 -0
  246. package/departments/marketing/tools/clis/mailchimp.js +220 -0
  247. package/departments/marketing/tools/clis/mention-me.js +161 -0
  248. package/departments/marketing/tools/clis/meta-ads.js +181 -0
  249. package/departments/marketing/tools/clis/mixpanel.js +248 -0
  250. package/departments/marketing/tools/clis/onesignal.js +241 -0
  251. package/departments/marketing/tools/clis/optimizely.js +233 -0
  252. package/departments/marketing/tools/clis/outreach.js +213 -0
  253. package/departments/marketing/tools/clis/paddle.js +385 -0
  254. package/departments/marketing/tools/clis/partnerstack.js +382 -0
  255. package/departments/marketing/tools/clis/pendo.js +221 -0
  256. package/departments/marketing/tools/clis/plausible.js +249 -0
  257. package/departments/marketing/tools/clis/postmark.js +375 -0
  258. package/departments/marketing/tools/clis/rankparse.js +196 -0
  259. package/departments/marketing/tools/clis/resend.js +370 -0
  260. package/departments/marketing/tools/clis/rewardful.js +160 -0
  261. package/departments/marketing/tools/clis/savvycal.js +223 -0
  262. package/departments/marketing/tools/clis/segment.js +192 -0
  263. package/departments/marketing/tools/clis/semrush.js +207 -0
  264. package/departments/marketing/tools/clis/sendgrid.js +211 -0
  265. package/departments/marketing/tools/clis/similarweb.js +214 -0
  266. package/departments/marketing/tools/clis/snov.js +237 -0
  267. package/departments/marketing/tools/clis/supermetrics.js +169 -0
  268. package/departments/marketing/tools/clis/tiktok-ads.js +190 -0
  269. package/departments/marketing/tools/clis/tolt.js +153 -0
  270. package/departments/marketing/tools/clis/trustpilot.js +276 -0
  271. package/departments/marketing/tools/clis/typeform.js +269 -0
  272. package/departments/marketing/tools/clis/wistia.js +301 -0
  273. package/departments/marketing/tools/clis/zapier.js +165 -0
  274. package/departments/marketing/tools/clis/zoominfo.js +223 -0
  275. package/departments/marketing/tools/composio/README.md +105 -0
  276. package/departments/marketing/tools/composio/marketing-tools.md +91 -0
  277. package/departments/marketing/tools/integrations/activecampaign.md +337 -0
  278. package/departments/marketing/tools/integrations/adobe-analytics.md +156 -0
  279. package/departments/marketing/tools/integrations/ahrefs.md +142 -0
  280. package/departments/marketing/tools/integrations/airops.md +128 -0
  281. package/departments/marketing/tools/integrations/amplitude.md +135 -0
  282. package/departments/marketing/tools/integrations/apollo.md +148 -0
  283. package/departments/marketing/tools/integrations/attentive.md +152 -0
  284. package/departments/marketing/tools/integrations/audiencetap.md +125 -0
  285. package/departments/marketing/tools/integrations/beehiiv.md +157 -0
  286. package/departments/marketing/tools/integrations/brevo.md +268 -0
  287. package/departments/marketing/tools/integrations/browserbase.md +111 -0
  288. package/departments/marketing/tools/integrations/buffer.md +138 -0
  289. package/departments/marketing/tools/integrations/calendly.md +161 -0
  290. package/departments/marketing/tools/integrations/clay.md +149 -0
  291. package/departments/marketing/tools/integrations/clearbit.md +142 -0
  292. package/departments/marketing/tools/integrations/close.md +191 -0
  293. package/departments/marketing/tools/integrations/cogny.md +153 -0
  294. package/departments/marketing/tools/integrations/composio.md +190 -0
  295. package/departments/marketing/tools/integrations/contentful.md +160 -0
  296. package/departments/marketing/tools/integrations/coupler.md +142 -0
  297. package/departments/marketing/tools/integrations/crossbeam.md +137 -0
  298. package/departments/marketing/tools/integrations/customer-io.md +187 -0
  299. package/departments/marketing/tools/integrations/dataforseo.md +165 -0
  300. package/departments/marketing/tools/integrations/demio.md +182 -0
  301. package/departments/marketing/tools/integrations/dub-co.md +160 -0
  302. package/departments/marketing/tools/integrations/exa.md +145 -0
  303. package/departments/marketing/tools/integrations/firecrawl.md +144 -0
  304. package/departments/marketing/tools/integrations/firehose.md +159 -0
  305. package/departments/marketing/tools/integrations/g2.md +179 -0
  306. package/departments/marketing/tools/integrations/ga4.md +126 -0
  307. package/departments/marketing/tools/integrations/github.md +182 -0
  308. package/departments/marketing/tools/integrations/gong.md +144 -0
  309. package/departments/marketing/tools/integrations/google-ads.md +159 -0
  310. package/departments/marketing/tools/integrations/google-search-console.md +147 -0
  311. package/departments/marketing/tools/integrations/heygen.md +126 -0
  312. package/departments/marketing/tools/integrations/hotjar.md +147 -0
  313. package/departments/marketing/tools/integrations/hubspot.md +178 -0
  314. package/departments/marketing/tools/integrations/hunter.md +90 -0
  315. package/departments/marketing/tools/integrations/hyperframes.md +180 -0
  316. package/departments/marketing/tools/integrations/instantly.md +104 -0
  317. package/departments/marketing/tools/integrations/intercom.md +292 -0
  318. package/departments/marketing/tools/integrations/introw.md +182 -0
  319. package/departments/marketing/tools/integrations/keywords-everywhere.md +207 -0
  320. package/departments/marketing/tools/integrations/kit.md +167 -0
  321. package/departments/marketing/tools/integrations/klaviyo.md +228 -0
  322. package/departments/marketing/tools/integrations/lemlist.md +110 -0
  323. package/departments/marketing/tools/integrations/linkedin-ads.md +164 -0
  324. package/departments/marketing/tools/integrations/livestorm.md +313 -0
  325. package/departments/marketing/tools/integrations/mailchimp.md +150 -0
  326. package/departments/marketing/tools/integrations/mention-me.md +160 -0
  327. package/departments/marketing/tools/integrations/meta-ads.md +147 -0
  328. package/departments/marketing/tools/integrations/mixpanel.md +137 -0
  329. package/departments/marketing/tools/integrations/nitrosend.md +113 -0
  330. package/departments/marketing/tools/integrations/onesignal.md +229 -0
  331. package/departments/marketing/tools/integrations/optimizely.md +171 -0
  332. package/departments/marketing/tools/integrations/outreach.md +172 -0
  333. package/departments/marketing/tools/integrations/paddle.md +212 -0
  334. package/departments/marketing/tools/integrations/partnerstack.md +222 -0
  335. package/departments/marketing/tools/integrations/pendo.md +208 -0
  336. package/departments/marketing/tools/integrations/plausible.md +177 -0
  337. package/departments/marketing/tools/integrations/plivo.md +140 -0
  338. package/departments/marketing/tools/integrations/posthog.md +151 -0
  339. package/departments/marketing/tools/integrations/postmark.md +234 -0
  340. package/departments/marketing/tools/integrations/postscript.md +126 -0
  341. package/departments/marketing/tools/integrations/rankparse.md +257 -0
  342. package/departments/marketing/tools/integrations/rb2b.md +110 -0
  343. package/departments/marketing/tools/integrations/resend.md +212 -0
  344. package/departments/marketing/tools/integrations/rewardful.md +147 -0
  345. package/departments/marketing/tools/integrations/salesforce.md +150 -0
  346. package/departments/marketing/tools/integrations/sanity.md +148 -0
  347. package/departments/marketing/tools/integrations/savvycal.md +181 -0
  348. package/departments/marketing/tools/integrations/segment.md +159 -0
  349. package/departments/marketing/tools/integrations/semrush.md +121 -0
  350. package/departments/marketing/tools/integrations/sendgrid.md +161 -0
  351. package/departments/marketing/tools/integrations/sequenzy.md +306 -0
  352. package/departments/marketing/tools/integrations/shopify.md +176 -0
  353. package/departments/marketing/tools/integrations/similarweb.md +150 -0
  354. package/departments/marketing/tools/integrations/snov.md +94 -0
  355. package/departments/marketing/tools/integrations/sparktoro.md +127 -0
  356. package/departments/marketing/tools/integrations/strapi.md +167 -0
  357. package/departments/marketing/tools/integrations/stripe.md +148 -0
  358. package/departments/marketing/tools/integrations/supermetrics.md +145 -0
  359. package/departments/marketing/tools/integrations/tiktok-ads.md +161 -0
  360. package/departments/marketing/tools/integrations/tolt.md +144 -0
  361. package/departments/marketing/tools/integrations/truelist.md +184 -0
  362. package/departments/marketing/tools/integrations/trustpilot.md +191 -0
  363. package/departments/marketing/tools/integrations/twilio.md +152 -0
  364. package/departments/marketing/tools/integrations/typeform.md +190 -0
  365. package/departments/marketing/tools/integrations/webflow.md +198 -0
  366. package/departments/marketing/tools/integrations/wistia.md +164 -0
  367. package/departments/marketing/tools/integrations/wordpress.md +175 -0
  368. package/departments/marketing/tools/integrations/zapier.md +244 -0
  369. package/departments/marketing/tools/integrations/zoominfo.md +191 -0
  370. package/departments/quality/agents/copy-director.yaml +1 -0
  371. package/departments/saas/SKILL.md +1 -0
  372. package/departments/saas/skills/churn-analysis/SKILL.md +421 -4
  373. package/departments/saas/skills/churn-analysis/references/cancel-flow-patterns.md +316 -0
  374. package/departments/saas/skills/churn-analysis/references/dunning-playbook.md +408 -0
  375. package/departments/saas/skills/launch-execute/SKILL.md +346 -4
  376. package/departments/saas/skills/onboarding-optimize/SKILL.md +218 -4
  377. package/departments/saas/skills/onboarding-optimize/references/experiments.md +258 -0
  378. package/departments/saas/skills/paywall-design/SKILL.md +256 -0
  379. package/departments/saas/skills/paywall-design/references/experiments.md +164 -0
  380. package/departments/saas/skills/pricing-strategy/SKILL.md +224 -0
  381. package/departments/saas/skills/pricing-strategy/references/research-methods.md +152 -0
  382. package/departments/saas/skills/pricing-strategy/references/tier-structure.md +232 -0
  383. package/departments/sales/SKILL.md +3 -0
  384. package/departments/sales/skills/prospecting/SKILL.md +297 -0
  385. package/departments/sales/skills/prospecting/references/b2b-prospecting.md +106 -0
  386. package/departments/sales/skills/prospecting/references/compliance.md +123 -0
  387. package/departments/sales/skills/prospecting/references/data-sources.md +287 -0
  388. package/departments/sales/skills/prospecting/references/demand-signals.md +129 -0
  389. package/departments/sales/skills/prospecting/references/local-prospecting.md +165 -0
  390. package/departments/sales/skills/prospecting/references/saas-prospecting.md +123 -0
  391. package/departments/sales/skills/revops/SKILL.md +379 -0
  392. package/departments/sales/skills/revops/references/automation-playbooks.md +290 -0
  393. package/departments/sales/skills/revops/references/lifecycle-definitions.md +278 -0
  394. package/departments/sales/skills/revops/references/routing-rules.md +203 -0
  395. package/departments/sales/skills/revops/references/scoring-models.md +247 -0
  396. package/departments/sales/skills/sales-enablement/SKILL.md +396 -0
  397. package/departments/sales/skills/sales-enablement/references/deck-frameworks.md +263 -0
  398. package/departments/sales/skills/sales-enablement/references/demo-scripts.md +355 -0
  399. package/departments/sales/skills/sales-enablement/references/objection-library.md +270 -0
  400. package/departments/sales/skills/sales-enablement/references/one-pager-templates.md +208 -0
  401. package/harness/codex/AGENTS.md +8 -8
  402. package/harness/copilot/copilot-instructions.md +8 -8
  403. package/harness/cursor/rules/arkaos.mdc +9 -9
  404. package/harness/gemini/GEMINI.md +8 -8
  405. package/harness/opencode/AGENTS.md +8 -8
  406. package/harness/zed/.rules +8 -8
  407. package/knowledge/agents-registry-v2.json +170 -8
  408. package/knowledge/commands-registry.json +693 -99
  409. package/knowledge/skills-manifest.json +459 -20
  410. package/package.json +1 -1
  411. package/pyproject.toml +1 -1
  412. package/scripts/tools/evals_import.py +183 -0
@@ -2,7 +2,7 @@
2
2
  name: mkt/paid-campaign
3
3
  description: >
4
4
  Paid campaign setup: platform selection, targeting, budget allocation,
5
- creative brief, and ROAS targets, prioritised with ICE scoring.
5
+ creative brief, and ROAS targets, prioritized with ICE scoring.
6
6
  TRIGGER: "campanha paga", "lança uma campanha de ads", "paid campaign",
7
7
  "Google Ads", "Meta Ads", "quanto investir em ads", "/mkt paid
8
8
  <platform> <goal>". SKIP: deciding which ad variant wins ->
@@ -10,6 +10,10 @@ description: >
10
10
  plan -> mkt/social-strategy; the landing page the ads point to ->
11
11
  landing/landing-gen.
12
12
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
13
+ metadata:
14
+ origin: community
15
+ source: https://github.com/coreyhaines31/marketingskills
16
+ license: MIT
13
17
  ---
14
18
 
15
19
  <!-- arka:kb-first-prefix begin -->
@@ -23,9 +27,454 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
23
27
 
24
28
  > **Agent:** Pedro (Paid Specialist) | **Framework:** ROAS Optimization + ICE Scoring
25
29
 
26
- ## What It Does
30
+ **Context:** read the product marketing context first —
31
+ `WizardingCode/Marketing/product-marketing.md` in Obsidian (KB-first),
32
+ else the project-local `.agents/product-marketing.md`.
27
33
 
28
- Paid campaign setup: platform selection, targeting, budget, creative brief, ROAS targets.
34
+ You are an expert performance marketer with direct access to ad platform accounts. Your goal is to help create, optimize, and scale paid advertising campaigns that drive efficient customer acquisition.
35
+
36
+ ## Before Starting
37
+
38
+ Gather this context (ask if not provided):
39
+
40
+ ### 1. Campaign Goals
41
+ - What's the primary objective? (Awareness, traffic, leads, sales, app installs)
42
+ - What's the target CPA or ROAS?
43
+ - What's the monthly/weekly budget?
44
+ - Any constraints? (Brand guidelines, compliance, geographic)
45
+
46
+ ### 2. Product & Offer
47
+ - What are you promoting? (Product, free trial, lead magnet, demo)
48
+ - What's the landing page URL?
49
+ - What makes this offer compelling?
50
+
51
+ ### 3. Audience
52
+ - Who is the ideal customer?
53
+ - What problem does your product solve for them?
54
+ - What are they searching for or interested in?
55
+ - Do you have existing customer data for lookalikes?
56
+
57
+ ### 4. Current State
58
+ - Have you run ads before? What worked/didn't?
59
+ - Do you have existing pixel/conversion data?
60
+ - What's your current funnel conversion rate?
61
+
62
+ ## Reference Routing
63
+
64
+ This skill's depth lives in references — load by intent. For **any operational decision on a live account** (kill/keep/scale/budget), load the relevant playbook before answering; the thresholds live there, not here.
65
+
66
+ | User intent | Load | Covers |
67
+ |---|---|---|
68
+ | B2B strategy, funnel stages, budget splits, kill rules, lead quality, breakeven math | [b2b-paid-playbook.md](references/b2b-paid-playbook.md) | Demand lifecycle, leading/lagging signals, kill rules, offline conversion loop, U/B/F lead scoring, scaling quadrant |
69
+ | Meta operations: when to kill/graduate/scale an ad, fatigue, testing structure | [meta-decision-system.md](references/meta-decision-system.md) | TCPL-anchored decision tree, ad-count ceiling, 80/20 CBO structure, fatigue bands, lead forms, Advantage+ transition |
70
+ | LinkedIn operations: bidding, audience sizing, scaling, benchmarks, TLAs, formats | [linkedin-b2b-playbook.md](references/linkedin-b2b-playbook.md) | Bidding progression, penetration scaling, sizing rules, funnel benchmarks, document/conversation ads, audit shortlist |
71
+ | Google Search: what to spend on first, structure, match types, negatives, PMax | [google-search-playbook.md](references/google-search-playbook.md) | Intent ladder, account structure, match-type gates, negatives, bidding by volume, offline conversions, PMax guardrails |
72
+ | Named-account targeting, pipeline acceleration, cross-channel retargeting | [abm-playbook.md](references/abm-playbook.md) | LinkedIn/Meta ABM, list mechanics, acceleration campaigns, UTM cross-channel remarketing, ABM measurement |
73
+ | Generating Google RSAs | [rsa-output-spec.md](references/rsa-output-spec.md) | Mandatory output spec — limits, sidecars, template, self-check |
74
+ | Audience setup, tracking setup, launch checklists, copy formulas | [audience-targeting.md](references/audience-targeting.md) · [conversion-tracking.md](references/conversion-tracking.md) · [platform-setup-checklists.md](references/platform-setup-checklists.md) · [ad-copy-templates.md](references/ad-copy-templates.md) | Existing foundations |
75
+
76
+ ## Platform Selection Guide
77
+
78
+ | Platform | Best For | Use When |
79
+ |----------|----------|----------|
80
+ | **Google Ads** | High-intent search traffic | People actively search for your solution |
81
+ | **Meta** | Demand generation, visual products | Creating demand, strong creative assets |
82
+ | **LinkedIn** | B2B, decision-makers | Job title/company targeting matters, higher price points |
83
+ | **Twitter/X** | Tech audiences, thought leadership | Audience is active on X, timely content |
84
+ | **TikTok** | Younger demographics, viral creative | Audience skews 18-34, video capacity |
85
+
86
+ ## Campaign Structure Best Practices
87
+
88
+ ### Account Organization
89
+
90
+ ```
91
+ Account
92
+ ├── Campaign 1: [Objective] - [Audience/Product]
93
+ │ ├── Ad Set 1: [Targeting variation]
94
+ │ │ ├── Ad 1: [Creative variation A]
95
+ │ │ ├── Ad 2: [Creative variation B]
96
+ │ │ └── Ad 3: [Creative variation C]
97
+ │ └── Ad Set 2: [Targeting variation]
98
+ └── Campaign 2...
99
+ ```
100
+
101
+ ### Naming Conventions
102
+
103
+ ```
104
+ [Platform]_[Objective]_[Audience]_[Offer]_[Date]
105
+
106
+ Examples:
107
+ META_Conv_Lookalike-Customers_FreeTrial_2024Q1
108
+ GOOG_Search_Brand_Demo_Ongoing
109
+ LI_LeadGen_CMOs-SaaS_Whitepaper_Mar24
110
+ ```
111
+
112
+ ### Budget Allocation
113
+
114
+ **Testing phase (first 2-4 weeks):**
115
+ - 70% to proven/safe campaigns
116
+ - 30% to testing new audiences/creative
117
+
118
+ **Scaling phase:**
119
+ - Consolidate budget into winning combinations
120
+ - Increase budgets ~20% at a time — never 30%+ in one move (resets platform learning)
121
+ - Wait 3-5 days between increases for algorithm learning
122
+
123
+ ## Ad Copy Frameworks
124
+
125
+ ### Key Formulas
126
+
127
+ **Problem-Agitate-Solve (PAS):**
128
+ > [Problem] → [Agitate the pain] → [Introduce solution] → [CTA]
129
+
130
+ **Before-After-Bridge (BAB):**
131
+ > [Current painful state] → [Desired future state] → [Your product as bridge]
132
+
133
+ **Social Proof Lead:**
134
+ > [Impressive stat or testimonial] → [What you do] → [CTA]
135
+
136
+ **For detailed templates and headline formulas**: See [references/ad-copy-templates.md](references/ad-copy-templates.md)
137
+
138
+ ## Audience Understanding & Targeting
139
+
140
+ Knowing your audience deeply is still the highest-leverage work in paid ads — demographics, job titles, pain points, fears, hopes, the exact language they use, who they follow, what they've tried, why they failed, what they buy. **Gather every identifier you can.**
141
+
142
+ What's changed in 2026 is **where you apply that knowledge.** As ad-platform algorithms have gotten dramatically better at finding the right person, jamming all your audience identifiers into the platform's *targeting filters* underperforms feeding those same identifiers into the *creative* (headlines, copy, visuals, hooks, examples).
143
+
144
+ The discipline now: **audience knowledge → creative first, targeting filters second.** How much that ratio tips toward "creative" varies meaningfully by platform.
145
+
146
+ ### Platform-by-platform: where to apply audience knowledge
147
+
148
+ | Platform | Audience knowledge → creative | Audience knowledge → targeting filters | Notes |
149
+ |----------|------------------------------|-------------------------------------|-------|
150
+ | **Meta** (post-Andromeda) | **80%+** | 20% | Algorithm rewards broad + specific creative. See [[#Modern Meta playbook (Andromeda era — 2026+)]] below for the full reframe. Interest-stacking now actively hurts. |
151
+ | **Google Search** | 40% | **60%** | Keywords are still the dominant signal — match-types, search-intent layering, and negative keywords still drive performance. Creative (RSA headlines) matters but is downstream of the keyword. |
152
+ | **Google Performance Max / Demand Gen** | **70%** | 30% | Audience signals are advisory, not deterministic. Creative + product feed quality dominate. |
153
+ | **LinkedIn** | 40% | **60%** | Job-title / company / industry filters still produce real precision because LinkedIn's identity data is high-quality. Creative makes the click; firmographics make the *right person* see it. |
154
+ | **TikTok** | **70%** | 30% | Algorithm is closer to Meta's model — broad targeting + native-feeling creative wins. Some audience interests help but creative dominates. |
155
+ | **Twitter/X** | 50% | 50% | Interest + follower targeting still meaningful, but creative differentiation is high-leverage given lower competition. |
156
+
157
+ These ratios are directional, not precise. Test in your actual account.
158
+
159
+ ### Applying audience knowledge to creative
160
+
161
+ Once you've gathered audience identifiers, here's how to put each kind into the creative:
162
+
163
+ - **Demographic identifiers** (age, location, occupation) → embed as identity-trigger keywords in headlines (see [[#The one-keyword hack (identity-trigger keywords)]])
164
+ - **Pain points + fears** → headline + first line of body copy (Sabri Suby's framing: "the verbatim words your customers use about the problem")
165
+ - **Hopes / desired outcomes** → transformation copy + CTAs
166
+ - **Objections + "why they didn't buy last time"** → objection-handling retargeting ads (see [[#The 4-component retargeting framework]])
167
+ - **Their language / vocabulary** → the entire copy voice — never use industry jargon they don't
168
+ - **Existing customer base** → still feed it for lookalike audiences (see Key Concepts below)
169
+ - **Niche / segment they identify with** → identity-trigger keywords in headline ("for dentists" / "for B2B founders" / "for parents of toddlers")
170
+
171
+ ### Key Concepts (still apply)
172
+
173
+ - **Lookalikes**: Base on best customers (by LTV), not all customers. Still high-value across platforms.
174
+ - **Retargeting**: Segment by funnel stage (visitors vs. cart abandoners). See [[#Retarget with DIFFERENT offers (not the same one)]] and [[#The 4-component retargeting framework]] for the modern playbook.
175
+ - **Exclusions**: Exclude existing customers and recent converters — showing ads to people who already bought wastes spend.
176
+
177
+ ### Common failure mode
178
+
179
+ Trying to make up for weak creative with hyper-precise targeting. If your creative is generic but you stack 12 interests + 3 demographic filters + a custom audience, what you've built is a small audience that all see a bad ad. Better: gather the same audience identifiers, write 5 creative variants that each speak to a different segment, target broadly, let the algorithm match each creative to the right segment.
180
+
181
+ **For detailed targeting strategies by platform**: See [references/audience-targeting.md](references/audience-targeting.md)
182
+
183
+ ## Modern Meta playbook (Andromeda era — 2026+)
184
+
185
+ Meta launched the **Andromeda** algorithm in 2025, which fundamentally changed Meta ads. The old playbook (interest stacking, polished video creative, single-winner scaling) underperforms. The new playbook:
186
+
187
+ ### Creative volume is the constraint (statics > polished video)
188
+ - Andromeda is "a hungry panda" — it needs constant fresh creative or it fatigues
189
+ - **Statics often outperform video in 2026** because:
190
+ - Meta's algorithm has a bias toward statics — it can show more statics per session per user, so they're cheaper to deliver
191
+ - Static creative is 10x cheaper and faster to produce than video, enabling the volume Andromeda needs
192
+ - Even top advertisers running 17+ VSLs report that down-and-dirty native statics often beat 2.5-month-production VSLs
193
+ - **Dedicate 1 hour per week** to producing fresh creatives for your winning offer. Volume > polish.
194
+
195
+ ### Creative IS the targeting (broad audience + specific creative)
196
+ - The old playbook: stack interests, narrow the audience, hope to find the right buyer
197
+ - The new playbook: target broadly (just the country) and let the creative do the targeting
198
+ - **Long-form ad copy works better than short-form** in 2026 — gives Meta a wider context window to understand who to show the ad to
199
+ - Test it: take your best winning ad with interest-stacked targeting, duplicate it, remove all targeting (just pick the country), run side-by-side for 7 days. Check CPAs. Broad typically wins.
200
+
201
+ ### The one-keyword hack (identity-trigger keywords)
202
+ - Take your winning ad
203
+ - Duplicate it with a niche/identity keyword inserted in the headline or body copy
204
+ - *"Here's how to get 462 leads per week on autopilot"* → *"Here's how to get 462 **dental** leads per week on autopilot"* / *"...**lawyer** leads..."* / *"...**property investment** leads..."*
205
+ - The keyword is an **identity trigger** for the viewer AND a targeting signal for Andromeda
206
+ - Dramatically drops CPL and opens audience pockets you couldn't reach with a generic ad
207
+
208
+ ### AI variant farming (the 100-people test)
209
+ - Take your winning ad
210
+ - Feed to Claude/ChatGPT/Kong with the prompt:
211
+ > *"I want you to read this ad and be the author. If I show the next ad I'm going to ask you to write to 100 people, not 1 in 100 would be able to tell you it's written by a different person. Now write this for [demographic/niche]."*
212
+ - The output should read essentially the same with subtle relevance shifts for the target
213
+ - Apply in sequence: body copy → headlines → creative
214
+ - Drop all variants in a CBO, let Meta's AI allocate spend
215
+
216
+ ### Zombie campaigns
217
+ - After running a CBO, Meta will give 80% of variants no spend
218
+ - Take the dead variants you have **high conviction** about
219
+ - Launch them in a separate ad set ("zombie campaign")
220
+ - Typically resurrects 20% as winners that Meta's first allocation passed over
221
+
222
+ ### Don't make ads look like ads
223
+ - Hundreds of millions of people have ad blockers — the polished-ad aesthetic kills performance
224
+ - Study what content **natively performs** in your niche on TikTok/Instagram/YouTube → produce ads that match that aesthetic
225
+ - **Burner account technique:** create a clean Instagram/TikTok account, follow all influencers and pages in your niche, like their content. Your feed becomes a curated view of what's natively winning. Produce ads that match.
226
+ - If you have an organic video with millions of views, **run that exact video as a paid ad** — proven content + paid distribution = the highest-leverage move
227
+
228
+ ## Creative Best Practices
229
+
230
+ ### Image Ads
231
+ - Clear product screenshots showing UI
232
+ - Before/after comparisons
233
+ - Stats and numbers as focal point
234
+ - Human faces (real, not stock)
235
+ - Bold, readable text overlay (keep under 20%)
236
+
237
+ ### Video Ads Structure (15-30 sec)
238
+ 1. Hook (0-3 sec): Pattern interrupt, question, or bold statement
239
+ 2. Problem (3-8 sec): Relatable pain point
240
+ 3. Solution (8-20 sec): Show product/benefit
241
+ 4. CTA (20-30 sec): Clear next step
242
+
243
+ **Production tips:**
244
+ - Captions always (85% watch without sound)
245
+ - Vertical for Stories/Reels, square for feed
246
+ - Native feel outperforms polished
247
+ - First 3 seconds determine if they watch
248
+
249
+ ### Creative Testing Hierarchy
250
+ 1. Concept/angle (biggest impact)
251
+ 2. Hook/headline
252
+ 3. Visual style
253
+ 4. Body copy
254
+ 5. CTA
255
+
256
+ ## Campaign Optimization
257
+
258
+ For hard kill/keep/scale thresholds, use the platform playbooks (see Reference Routing): the kill rules and breakeven CPL/CPC math live in [b2b-paid-playbook.md](references/b2b-paid-playbook.md), and Meta's full decision tree lives in [meta-decision-system.md](references/meta-decision-system.md).
259
+
260
+ ### Key Metrics by Objective
261
+
262
+ | Objective | Primary Metrics |
263
+ |-----------|-----------------|
264
+ | Awareness | CPM, Reach, Video view rate |
265
+ | Consideration | CTR, CPC, Time on site |
266
+ | Conversion | CPA, ROAS, Conversion rate |
267
+
268
+ ### Optimization Levers
269
+
270
+ **If CPA is too high:**
271
+ 1. Check landing page (is the problem post-click?)
272
+ 2. Tighten audience targeting
273
+ 3. Test new creative angles
274
+ 4. Improve ad relevance/quality score
275
+ 5. Adjust bid strategy
276
+
277
+ **If CTR is low:**
278
+ - Creative isn't resonating → test new hooks/angles
279
+ - Audience mismatch → refine targeting
280
+ - Ad fatigue → refresh creative
281
+
282
+ **If CPM is high:**
283
+ - Audience too narrow → expand targeting
284
+ - High competition → try different placements
285
+ - Low relevance score → improve creative fit
286
+
287
+ ### Bid Strategy Progression
288
+ 1. Start with manual or cost caps
289
+ 2. Gather conversion data (50+ conversions)
290
+ 3. Switch to automated with targets based on historical data
291
+ 4. Monitor and adjust targets based on results
292
+
293
+ ## Retargeting Strategies
294
+
295
+ ### Funnel-Based Approach
296
+
297
+ | Funnel Stage | Audience | Message | Goal |
298
+ |--------------|----------|---------|------|
299
+ | Top | Blog readers, video viewers | Educational, social proof | Move to consideration |
300
+ | Middle | Pricing/feature page visitors | Case studies, demos | Move to decision |
301
+ | Bottom | Cart abandoners, trial users | Urgency, objection handling | Convert |
302
+
303
+ ### Retargeting Windows
304
+
305
+ | Stage | Window | Frequency Cap |
306
+ |-------|--------|---------------|
307
+ | Hot (cart/trial) | 1-7 days | Higher OK |
308
+ | Warm (key pages) | 7-30 days | 3-5x/week |
309
+ | Cold (any visit) | 30-90 days | 1-2x/week |
310
+
311
+ ### Exclusions to Set Up
312
+ - Existing customers (unless upsell)
313
+ - Recent converters (7-14 day window)
314
+ - Bounced visitors (<10 sec)
315
+ - Irrelevant pages (careers, support)
316
+
317
+ ### Retarget with DIFFERENT offers (not the same one)
318
+
319
+ The conventional retargeting playbook re-shows the same product/offer to people who didn't buy. The Sabri Suby principle: **the #1 reason someone didn't buy is the offer wasn't right for them.** Re-showing the same thing harder doesn't help.
320
+
321
+ Instead, retarget with **different** products, services, or offers from your catalog:
322
+ - Visitor clicked on protein powder, didn't buy → retarget with creatine (totally different category)
323
+ - Visitor downloaded a lead magnet, didn't book a call → retarget with a different lead magnet on a related topic
324
+ - Visitor viewed pricing, didn't sign up → retarget with a free audit or assessment instead
325
+
326
+ The lift from this is often dramatic — a 2-3 ROAS audience on the original offer can hit 6+ ROAS on a different offer.
327
+
328
+ ### The 4-component retargeting framework
329
+
330
+ Build out your retargeting layer with these 4 ad types running simultaneously:
331
+
332
+ 1. **Objection-handling ad** — directly addresses the most common reasons people didn't buy. To find these, **outbound call every lead** who didn't convert and ask why. The verbatim objections become the headline of this ad.
333
+ 2. **Proof testimonial carousel** — multi-image/multi-slide carousel of testimonials and proof that supports the claims of your original ad
334
+ 3. **Other-offers CBO** — your other best-performing ads for other products/services in one CBO, retargeted to the same audience
335
+ 4. **Value-first audit/assessment ad** — wraps your call in a free piece of value. Whether they buy or not, they leave with something useful. Lowers the friction to engage.
336
+
337
+ These four together, retargeting the same audience that didn't convert from the top-of-funnel ad, dramatically lift the ROAS of the entire funnel.
338
+
339
+ ## Landing Page Alignment (the headline-mirror trick)
340
+
341
+ Ad-to-landing-page congruence is the single most underrated lever in paid ads. Most advertisers spend 90% of effort on ads and 10% on the landing page; flip that ratio.
342
+
343
+ ### Headline mirroring
344
+
345
+ Meta is the best split-testing tool that exists — your ad headlines are exposed to ~1000x the audience that actually clicks through to your landing page. That means you get statistically-significant data on which headlines work *much faster* on Meta than on your landing page.
346
+
347
+ The play:
348
+
349
+ 1. Run **20-40 different headlines** as ad variations
350
+ 2. Identify the best-performing headline (by CTR + downstream conversion)
351
+ 3. **Mirror that winning headline on your landing page** — exact wording in the H1, sub-headline, and lead-in copy of the body
352
+ 4. Expect a **15-20% minimum lift** in landing-page conversion rate from this single change
353
+
354
+ This works because the viewer who clicked is expecting *that specific promise*. When the landing page restates the exact promise verbatim, scent matches and conversion follows. When the landing page pivots to a different angle, bounce rate spikes regardless of how good the page is.
355
+
356
+ ### Three split tests minimum at all times
357
+
358
+ A standing discipline: **at any given moment, you should have at least 3 split tests running** somewhere in your funnel — ad creative, landing page, offer, or post-conversion flow. If you don't, you've capped your improvement curve.
359
+
360
+ The math: 3 simultaneous tests × ~10-20% lift each (compounding) = a fundamentally better funnel within a quarter.
361
+
362
+ ## Reporting & Analysis
363
+
364
+ ### Weekly Review
365
+ - Spend vs. budget pacing
366
+ - CPA/ROAS vs. targets
367
+ - Top and bottom performing ads
368
+ - Audience performance breakdown
369
+ - Frequency check (fatigue risk)
370
+ - Landing page conversion rate
371
+
372
+ ### Attribution Considerations
373
+ - Platform attribution is inflated
374
+ - Use UTM parameters consistently
375
+ - Compare platform data to GA4
376
+ - Look at blended CAC, not just platform CPA
377
+
378
+ ### Scaling discipline (net cash > ROAS percentage)
379
+
380
+ The most common scaling failure: a business at a 40 ROAS spending $5k/month, refusing to scale because "if I spend more, my ROAS will drop." This is the wrong frame.
381
+
382
+ **Net cash flow > ROAS percentage at the business level:**
383
+ - ROAS dropping from 10 → 5 sounds bad
384
+ - But if spend goes from $10k → $100k, you net dramatically more total profit
385
+ - The number to optimize is **blended ROAS at the business level**, not per-ad-set ROAS
386
+ - Even better: optimize **net free cash flow**, not ROAS at all
387
+
388
+ **Find your break-even ROAS:**
389
+ 1. Calculate the absolute maximum you can pay to acquire a customer and still be profitable (factoring LTV)
390
+ 2. That's your break-even ROAS / CPA ceiling
391
+ 3. **Scale until you approach that ceiling**, not until your ad-account ROAS drops below an arbitrary preference
392
+
393
+ **The 3-hour founder review:**
394
+ - Block out **3 hours per month** in the calendar to physically review the numbers yourself
395
+ - Not what your data analyst says. Not what your media buyer says. You, going through the actual data
396
+ - The confidence this generates is irreplaceable — and confidence is what lets you scale with conviction
397
+ - "Data gives you confidence. Confidence gives you speed."
398
+
399
+ **Outbound-call your leads who didn't convert:**
400
+ - Every lead that downloaded a lead magnet or hit your funnel but didn't buy gets a call
401
+ - Ask why they didn't book, what was confusing, what the actual blocker was
402
+ - These verbatim answers become objection-handling ads (see Retargeting section)
403
+ - Massive insight-to-creative loop that most advertisers skip
404
+
405
+ ## Platform Setup
406
+
407
+ Before launching campaigns, ensure proper tracking and account setup.
408
+
409
+ **For complete setup checklists by platform**: See [references/platform-setup-checklists.md](references/platform-setup-checklists.md)
410
+
411
+ **For conversion pixel installation and event setup**: See [references/conversion-tracking.md](references/conversion-tracking.md)
412
+
413
+ ### Universal Pre-Launch Checklist
414
+ - [ ] Conversion tracking tested with real conversion
415
+ - [ ] Landing page loads fast (<3 sec)
416
+ - [ ] Landing page mobile-friendly
417
+ - [ ] UTM parameters working
418
+ - [ ] Budget set correctly
419
+ - [ ] Targeting matches intended audience
420
+
421
+ ## Google RSA Output Spec (mandatory when generating RSAs)
422
+
423
+ When the user requests Google Ads RSAs, load [references/rsa-output-spec.md](references/rsa-output-spec.md) and follow it exactly — hard character limits, required sidecar artifacts (ad groups, negatives, sitelinks, callouts), output order, template shape, CFM medical compliance, and the pre-send self-check. Do not output any RSA that violates it.
424
+
425
+ ## Common Mistakes to Avoid
426
+
427
+ ### Strategy
428
+ - Launching without conversion tracking
429
+ - Too many campaigns (fragmenting budget)
430
+ - Not giving algorithms enough learning time
431
+ - Optimizing for wrong metric
432
+
433
+ ### Targeting
434
+ - Audiences too narrow or too broad
435
+ - Not excluding existing customers
436
+ - Overlapping audiences competing
437
+
438
+ ### Creative
439
+ - Only one ad per ad set
440
+ - Not refreshing creative (fatigue)
441
+ - Mismatch between ad and landing page
442
+
443
+ ### Budget
444
+ - Spreading too thin across campaigns
445
+ - Making big budget changes (disrupts learning)
446
+ - Stopping campaigns during learning phase
447
+
448
+ ## Task-Specific Questions
449
+
450
+ 1. What platform(s) are you currently running or want to start with?
451
+ 2. What's your monthly ad budget?
452
+ 3. What does a successful conversion look like (and what's it worth)?
453
+ 4. Do you have existing creative assets or need to create them?
454
+ 5. What landing page will ads point to?
455
+ 6. Do you have pixel/conversion tracking set up?
456
+
457
+ ## Tool Integrations
458
+
459
+ For implementation, see the [tools registry](../../tools/REGISTRY.md). Key advertising platforms:
460
+
461
+ | Platform | Best For | MCP | Guide |
462
+ |----------|----------|:---:|-------|
463
+ | **Google Ads** | Search intent, high-intent traffic | ✓ | [google-ads.md](../../tools/integrations/google-ads.md) |
464
+ | **Meta Ads** | Demand gen, visual products, B2C | - | [meta-ads.md](../../tools/integrations/meta-ads.md) |
465
+ | **LinkedIn Ads** | B2B, job title targeting | - | [linkedin-ads.md](../../tools/integrations/linkedin-ads.md) |
466
+ | **TikTok Ads** | Younger demographics, video | - | [tiktok-ads.md](../../tools/integrations/tiktok-ads.md) |
467
+
468
+ For tracking setup, see [references/conversion-tracking.md](references/conversion-tracking.md), [ga4.md](../../tools/integrations/ga4.md), [segment.md](../../tools/integrations/segment.md)
469
+
470
+ ## Related ArkaOS skills
471
+
472
+ - **`mkt/ad-creative`** — generating and iterating ad headlines, descriptions, and creative at scale
473
+ - **`mkt/customer-research`** — the voice-of-customer inputs that feed ad copy and creative angles
474
+ - **`landing/copy-framework`** — landing page copy that converts ad traffic
475
+ - **`landing/optimize-page`** — optimizing post-click conversion rates
476
+ - **`mkt/analytics-report`** — proper conversion tracking and reporting setup
477
+ - **`mkt/ab-test`** — landing page and creative testing to improve ROAS
29
478
 
30
479
  ## Output
31
480
 
@@ -0,0 +1,93 @@
1
+ # ABM Playbook (Paid)
2
+
3
+ Account-based marketing with ads: targeting named accounts on LinkedIn and Meta, accelerating open pipeline, and stitching channels together. ABM ads are a *pipeline influence* motion, not a lead-gen motion — measure accordingly.
4
+
5
+ ## Contents
6
+
7
+ - When ABM (go/no-go)
8
+ - LinkedIn ABM
9
+ - ABM on Meta
10
+ - Acceleration campaigns (ads against open pipeline)
11
+ - Cross-channel orchestration
12
+ - Cross-channel UTM remarketing
13
+ - Sales orchestration
14
+ - Measuring ABM
15
+
16
+ ## When ABM (go/no-go)
17
+
18
+ Run paid ABM when: target account list ≥ ~1,000 companies (or you accept 1:1/1:few economics), deal size ~$25K+, sales cycle 60+ days, sales and marketing actually aligned on the list, and (for Meta) contact enrichment available.
19
+
20
+ Skip it when: TAL under ~500 with no enrichment, no first-party data, budget under ~$3K/month, or a short transactional cycle — standard ICP targeting will outperform.
21
+
22
+ ## LinkedIn ABM
23
+
24
+ Three motions, by list size:
25
+
26
+ - **1:1** — add the company by name; fully personalized creative for one account.
27
+ - **1:few** — up to ~10–20 accounts per campaign, shared pain/industry angle.
28
+ - **1:many** — uploaded list (or native targeting), scaled creative.
29
+
30
+ **List mechanics:**
31
+ - LinkedIn needs **300 matched members minimum** to serve; aim for 1,000+ rows (duplicating company names to pad the upload is fine — it dedupes on match). Contact lists match best at scale (LinkedIn suggests ~10K emails); **company lists beat contact lists** for most teams — easier to source, better match rates, less maintenance.
32
+ - Cold ABM audiences need ~15K members to deliver reliably.
33
+ - **Segment mixed lists.** Left as one audience, LinkedIn over-serves the largest enterprises in the list — accounts have sat at 15% list coverage because the algorithm parked on a few big companies. Split into homogeneous bands (e.g., enterprise / mid-market / SMB) with separate campaigns and budgets.
34
+ - List-based targeting typically buys reach materially cheaper than native firmographic targeting, with stronger decision-maker engagement.
35
+ - Use the per-company engagement report (Audiences → click into the list) to find under-served priority accounts, then break them into a dedicated campaign.
36
+
37
+ **Personalized 1:1 creative:** putting the target account's name/logo in the creative can lift CTR ~5–10× over generic ads. **Legal exception: do not run company-name/logo-personalized ads into Germany** — privacy law, not platform policy.
38
+
39
+ **Frequency capping:** target ~3 impressions/person/week in priority accounts. Mechanic: build a company-engagement audience of accounts that crossed ~500 impressions in the last 7 days and add it as an *exclusion* — it self-rotates accounts out as they cool down. Tune the threshold (300 if fatigue shows, 750 for more pressure).
40
+
41
+ ## ABM on Meta
42
+
43
+ Meta has no native company targeting — the play is **bring your own matched audience**:
44
+
45
+ - **The match-rate problem:** raw CRM exports of work emails match under ~5% on Meta. Enrichment providers (identity-graph tools that resolve work identities to personal profiles — e.g., Primer, Metadata, ZoomInfo, Clearbit) raise matches to ~40–85%. Workflow: firmographic criteria → identity-graph match → upload as Custom Audience → target directly or seed a 1% lookalike.
46
+ - **Minimum sizes:** account-list audiences ~1,000 companies (5–10K optimal); retargeting slices work down to ~100 accounts; lookalike seeds want 500+.
47
+ - Advantage+ **conflicts with strict ABM** — it won't stay locked to your list. Run ABM campaigns manual (or hybrid: manual for the list, Advantage+ for the broad layer).
48
+ - Meta's ABM role is cheap **air cover and multi-threading** (reaching the buying committee beyond your champion) while LinkedIn does precision — see the split below.
49
+
50
+ ## Acceleration campaigns (ads against open pipeline)
51
+
52
+ Ads aimed at accounts already in your pipeline, to speed deals rather than source them:
53
+
54
+ - Segment the CRM by stage (evaluation / proposal / negotiation), filter to deals worth the spend, upload as an audience, refresh weekly.
55
+ - **Use an awareness/reach objective, not conversions** — you're keeping the vendor top-of-mind for the buying committee, not asking in-pipeline accounts to "book a demo" they already booked.
56
+ - Creative: case studies, proof, objection-handlers — matched to stage. Budget scales with deal value (larger open deals justify $100–200/day of air cover; stalled deals get a maintenance dose).
57
+
58
+ ## Cross-channel orchestration
59
+
60
+ Default split for B2B ABM: **~60% LinkedIn / ~30% Meta / ~10% other**. LinkedIn buys precision (right person, right company) at $40–70 CPMs; Meta buys presence and committee reach at $10–25. Sequence LinkedIn first to validate the audience, then extend to Meta. Multi-channel ABM consistently and materially outperforms single-channel on engagement and conversion — the channels compound, they don't compete.
61
+
62
+ ## Cross-channel UTM remarketing
63
+
64
+ The cheapest high-quality audience you can build: retarget one platform's validated clickers on another platform.
65
+
66
+ 1. Tag all paid traffic with consistent UTMs (`utm_source=linkedin`, `utm_source=google&utm_medium=cpc`).
67
+ 2. On Meta, build a website Custom Audience with the rule **"URL contains `utm_source=linkedin`"** (or `utm_source=google`).
68
+ 3. Retarget that audience on Meta — LinkedIn-grade audience quality at Meta-grade CPMs (typically 50–70% cheaper reach).
69
+
70
+ Works in both directions (search clickers → LinkedIn remarketing needs meaningful search volume — worth it above roughly $30K/month search spend). Requires enough source-channel traffic to clear minimum audience sizes. Use a consistent account/campaign token in UTMs so attribution survives the hop.
71
+
72
+ ## Sales orchestration
73
+
74
+ ABM ads without sales follow-up is billboard spend:
75
+
76
+ - Pipe ad-engagement signals to the CRM (LinkedIn company-engagement exports, or connectors that sync engagement per account) and treat an engagement spike as a sales trigger — **outreach within ~48 hours** of the spike.
77
+ - Route new leads to a shared channel (Slack webhook) with a per-campaign quality reaction (👍/👎) — the cheapest lead-quality feedback loop that exists.
78
+ - Hold a monthly sales-marketing session on the list itself: who's engaging, who's dark, who closed — and re-cut the list.
79
+ - Expect ~7–10 cross-channel touches before a sales conversation is normal at ABM deal sizes.
80
+
81
+ ## Measuring ABM
82
+
83
+ Judge ABM on account movement, not CPL:
84
+
85
+ - **Account penetration** (% of list reached): target ~40–60%.
86
+ - **Cost per engaged account** (not per click): ~$100–300 is a workable band.
87
+ - **Account → opportunity rate:** ~10–20%.
88
+ - **Pipeline influenced:** aim for 3–5× spend; expect win-rate and velocity improvements on engaged vs. non-engaged accounts.
89
+ - **Incrementality:** hold out ~20% of the list from ads and compare pipeline formation after 21+ days — the only honest answer to "did the ads do anything?"
90
+
91
+ ---
92
+
93
+ *Framework lineage: adapted (re-expressed and restructured) from practitioner playbooks, notably Ivan Falco's ads-skills. Thresholds are practitioner-reported starting points — recalibrate against your own accounts.*