zilmate 1.9.3 → 1.10.1

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 (306) hide show
  1. package/.agents/skills/ad-creative/SKILL.md +362 -0
  2. package/.agents/skills/ad-creative/evals/evals.json +90 -0
  3. package/.agents/skills/ad-creative/references/generative-tools.md +637 -0
  4. package/.agents/skills/ad-creative/references/platform-specs.md +213 -0
  5. package/.agents/skills/ai-seo/SKILL.md +489 -0
  6. package/.agents/skills/ai-seo/evals/evals.json +90 -0
  7. package/.agents/skills/ai-seo/references/content-patterns.md +285 -0
  8. package/.agents/skills/ai-seo/references/content-types.md +71 -0
  9. package/.agents/skills/ai-seo/references/okf.md +104 -0
  10. package/.agents/skills/ai-seo/references/platform-ranking-factors.md +154 -0
  11. package/.agents/skills/clerk-backend-api/SKILL.md +426 -0
  12. package/.agents/skills/clerk-backend-api/evals/evals.json +87 -0
  13. package/.agents/skills/clerk-backend-api/scripts/api-specs-context.sh +30 -0
  14. package/.agents/skills/clerk-backend-api/scripts/execute-request.sh +88 -0
  15. package/.agents/skills/clerk-backend-api/scripts/extract-endpoint-detail.sh +165 -0
  16. package/.agents/skills/clerk-backend-api/scripts/extract-tag-endpoints.sh +208 -0
  17. package/.agents/skills/clerk-backend-api/scripts/extract-tags.js +14 -0
  18. package/.agents/skills/copy-editing/SKILL.md +457 -0
  19. package/.agents/skills/copy-editing/evals/evals.json +89 -0
  20. package/.agents/skills/copy-editing/references/checklist.md +66 -0
  21. package/.agents/skills/copy-editing/references/content-refresh.md +38 -0
  22. package/.agents/skills/copy-editing/references/plain-english-alternatives.md +394 -0
  23. package/.agents/skills/hyperframes/SKILL.md +163 -0
  24. package/.agents/skills/hyperframes-cli/SKILL.md +109 -0
  25. package/.agents/skills/hyperframes-cli/references/doctor-browser.md +45 -0
  26. package/.agents/skills/hyperframes-cli/references/init-and-scaffold.md +51 -0
  27. package/.agents/skills/hyperframes-cli/references/lambda.md +132 -0
  28. package/.agents/skills/hyperframes-cli/references/lint-validate-inspect.md +121 -0
  29. package/.agents/skills/hyperframes-cli/references/preview-render.md +109 -0
  30. package/.agents/skills/hyperframes-cli/references/upgrade-info-misc.md +75 -0
  31. package/.agents/skills/hyperframes-media/SKILL.md +97 -0
  32. package/.agents/skills/hyperframes-media/assets/sfx/CREDITS.md +35 -0
  33. package/.agents/skills/hyperframes-media/assets/sfx/manifest.json +97 -0
  34. package/.agents/skills/hyperframes-media/references/bgm.md +72 -0
  35. package/.agents/skills/hyperframes-media/references/captions/authoring.md +159 -0
  36. package/.agents/skills/hyperframes-media/references/captions/motion.md +87 -0
  37. package/.agents/skills/hyperframes-media/references/captions/transcript-handling.md +97 -0
  38. package/.agents/skills/hyperframes-media/references/remove-background.md +143 -0
  39. package/.agents/skills/hyperframes-media/references/requirements.md +29 -0
  40. package/.agents/skills/hyperframes-media/references/sfx.md +42 -0
  41. package/.agents/skills/hyperframes-media/references/transcribe.md +52 -0
  42. package/.agents/skills/hyperframes-media/references/tts-to-captions.md +24 -0
  43. package/.agents/skills/hyperframes-media/references/tts.md +135 -0
  44. package/.agents/skills/hyperframes-media/scripts/audio.mjs +282 -0
  45. package/.agents/skills/hyperframes-media/scripts/heygen-tts.mjs +121 -0
  46. package/.agents/skills/hyperframes-media/scripts/lib/bgm.mjs +235 -0
  47. package/.agents/skills/hyperframes-media/scripts/lib/heygen.mjs +131 -0
  48. package/.agents/skills/hyperframes-media/scripts/lib/sfx.mjs +128 -0
  49. package/.agents/skills/hyperframes-media/scripts/lib/tts.mjs +220 -0
  50. package/.agents/skills/hyperframes-media/scripts/lyria-recipe.py +128 -0
  51. package/.agents/skills/hyperframes-media/scripts/wait-bgm.mjs +167 -0
  52. package/.agents/skills/hyperframes-registry/SKILL.md +101 -0
  53. package/.agents/skills/hyperframes-registry/examples/add-block.md +51 -0
  54. package/.agents/skills/hyperframes-registry/examples/add-component.md +73 -0
  55. package/.agents/skills/hyperframes-registry/references/contributing.md +166 -0
  56. package/.agents/skills/hyperframes-registry/references/demo-html-pattern.md +54 -0
  57. package/.agents/skills/hyperframes-registry/references/discovery.md +215 -0
  58. package/.agents/skills/hyperframes-registry/references/install-locations.md +45 -0
  59. package/.agents/skills/hyperframes-registry/references/templates.md +417 -0
  60. package/.agents/skills/hyperframes-registry/references/wiring-blocks.md +61 -0
  61. package/.agents/skills/hyperframes-registry/references/wiring-components.md +39 -0
  62. package/.agents/skills/marketing-psychology/SKILL.md +455 -0
  63. package/.agents/skills/marketing-psychology/evals/evals.json +88 -0
  64. package/.agents/skills/mintlify/SKILL.md +328 -0
  65. package/.agents/skills/product-launch-video/SKILL.md +206 -0
  66. package/.agents/skills/product-launch-video/references/cut-catalog.md +220 -0
  67. package/.agents/skills/product-launch-video/references/motion-language.md +156 -0
  68. package/.agents/skills/product-launch-video/references/story-design.md +373 -0
  69. package/.agents/skills/product-launch-video/references/visual-design.md +126 -0
  70. package/.agents/skills/product-launch-video/scripts/assemble-index.mjs +570 -0
  71. package/.agents/skills/product-launch-video/scripts/audio.mjs +253 -0
  72. package/.agents/skills/product-launch-video/scripts/build-frame.mjs +536 -0
  73. package/.agents/skills/product-launch-video/scripts/captions.mjs +508 -0
  74. package/.agents/skills/product-launch-video/scripts/lib/assets.mjs +55 -0
  75. package/.agents/skills/product-launch-video/scripts/lib/dimensions.mjs +45 -0
  76. package/.agents/skills/product-launch-video/scripts/lib/storyboard.mjs +249 -0
  77. package/.agents/skills/product-launch-video/scripts/lib/tokens.mjs +204 -0
  78. package/.agents/skills/product-launch-video/scripts/lib/transition-registry.mjs +38 -0
  79. package/.agents/skills/product-launch-video/scripts/lib/transitions.json +71 -0
  80. package/.agents/skills/product-launch-video/scripts/stage-assets.mjs +39 -0
  81. package/.agents/skills/product-launch-video/scripts/transitions.mjs +320 -0
  82. package/.agents/skills/product-launch-video/sub-agents/frame-worker.md +74 -0
  83. package/.agents/skills/prompt-engineering-patterns/SKILL.md +144 -0
  84. package/.agents/skills/prompt-engineering-patterns/assets/few-shot-examples.json +106 -0
  85. package/.agents/skills/prompt-engineering-patterns/assets/prompt-template-library.md +264 -0
  86. package/.agents/skills/prompt-engineering-patterns/references/chain-of-thought.md +412 -0
  87. package/.agents/skills/prompt-engineering-patterns/references/details.md +338 -0
  88. package/.agents/skills/prompt-engineering-patterns/references/few-shot-learning.md +386 -0
  89. package/.agents/skills/prompt-engineering-patterns/references/prompt-optimization.md +428 -0
  90. package/.agents/skills/prompt-engineering-patterns/references/prompt-templates.md +484 -0
  91. package/.agents/skills/prompt-engineering-patterns/references/system-prompts.md +195 -0
  92. package/.agents/skills/prompt-engineering-patterns/scripts/optimize-prompt.py +279 -0
  93. package/.agents/skills/remotion-to-hyperframes/SKILL.md +127 -0
  94. package/.agents/skills/remotion-to-hyperframes/assets/.gitkeep +0 -0
  95. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/run.sh +249 -0
  96. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/README.md +41 -0
  97. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/expected.json +26 -0
  98. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/hf-src/index.html +61 -0
  99. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/package.json +14 -0
  100. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/remotion.config.ts +13 -0
  101. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/src/Root.tsx +13 -0
  102. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/src/TitleCard.tsx +34 -0
  103. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/src/index.ts +4 -0
  104. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/tsconfig.json +15 -0
  105. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/README.md +54 -0
  106. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/expected.json +29 -0
  107. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/hf-src/index.html +118 -0
  108. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/package.json +14 -0
  109. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/remotion.config.ts +13 -0
  110. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/src/MultiScene.tsx +105 -0
  111. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/src/Root.tsx +13 -0
  112. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/src/index.ts +4 -0
  113. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/tsconfig.json +15 -0
  114. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/setup.sh +34 -0
  115. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/README.md +85 -0
  116. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/expected.json +41 -0
  117. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/hf-src/index.html +269 -0
  118. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/package.json +15 -0
  119. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/remotion.config.ts +13 -0
  120. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/Root.tsx +27 -0
  121. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/Stargazed.tsx +37 -0
  122. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/components/AnimatedNumber.tsx +23 -0
  123. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/components/StatCard.tsx +59 -0
  124. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/components/UnderlinedText.tsx +47 -0
  125. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/index.ts +4 -0
  126. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/scenes/OutroScene.tsx +18 -0
  127. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/scenes/StatsScene.tsx +34 -0
  128. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/scenes/TitleScene.tsx +55 -0
  129. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/tsconfig.json +15 -0
  130. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/README.md +51 -0
  131. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/01-use-state.tsx +29 -0
  132. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/02-use-effect-deps.tsx +29 -0
  133. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/03-async-metadata.tsx +39 -0
  134. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/04-third-party-react.tsx +30 -0
  135. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/05-lambda-config.tsx +38 -0
  136. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/06-warnings-only.tsx +36 -0
  137. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/07-custom-hook.tsx +28 -0
  138. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/08-mixed.tsx +41 -0
  139. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/expected.json +85 -0
  140. package/.agents/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/validate.sh +110 -0
  141. package/.agents/skills/remotion-to-hyperframes/references/api-map.md +142 -0
  142. package/.agents/skills/remotion-to-hyperframes/references/escape-hatch.md +115 -0
  143. package/.agents/skills/remotion-to-hyperframes/references/eval.md +140 -0
  144. package/.agents/skills/remotion-to-hyperframes/references/fonts.md +112 -0
  145. package/.agents/skills/remotion-to-hyperframes/references/limitations.md +136 -0
  146. package/.agents/skills/remotion-to-hyperframes/references/lottie.md +121 -0
  147. package/.agents/skills/remotion-to-hyperframes/references/media.md +149 -0
  148. package/.agents/skills/remotion-to-hyperframes/references/parameters.md +167 -0
  149. package/.agents/skills/remotion-to-hyperframes/references/sequencing.md +195 -0
  150. package/.agents/skills/remotion-to-hyperframes/references/timing.md +165 -0
  151. package/.agents/skills/remotion-to-hyperframes/references/transitions.md +114 -0
  152. package/.agents/skills/remotion-to-hyperframes/scripts/.gitkeep +0 -0
  153. package/.agents/skills/remotion-to-hyperframes/scripts/frame_strip.sh +107 -0
  154. package/.agents/skills/remotion-to-hyperframes/scripts/lint_source.py +358 -0
  155. package/.agents/skills/remotion-to-hyperframes/scripts/render_diff.sh +103 -0
  156. package/.agents/skills/remotion-to-hyperframes/scripts/tests/fixtures/blocker.tsx +50 -0
  157. package/.agents/skills/remotion-to-hyperframes/scripts/tests/fixtures/clean.tsx +46 -0
  158. package/.agents/skills/remotion-to-hyperframes/scripts/tests/smoke.sh +90 -0
  159. package/.agents/skills/seo-audit/SKILL.md +497 -0
  160. package/.agents/skills/seo-audit/evals/evals.json +136 -0
  161. package/.agents/skills/seo-audit/references/ai-writing-detection.md +200 -0
  162. package/.agents/skills/seo-audit/references/international-seo.md +230 -0
  163. package/README.md +4 -2
  164. package/SDK.md +64 -1
  165. package/dist/agents/coding.agent.d.ts +632 -0
  166. package/dist/agents/coding.agent.d.ts.map +1 -1
  167. package/dist/agents/coding.agent.js +11 -3
  168. package/dist/agents/coding.agent.js.map +1 -1
  169. package/dist/agents/developer-helper.agent.d.ts +704 -0
  170. package/dist/agents/developer-helper.agent.d.ts.map +1 -1
  171. package/dist/agents/developer-helper.agent.js +6 -0
  172. package/dist/agents/developer-helper.agent.js.map +1 -1
  173. package/dist/agents/manager.d.ts +1009 -4
  174. package/dist/agents/manager.d.ts.map +1 -1
  175. package/dist/agents/manager.js +16 -5
  176. package/dist/agents/manager.js.map +1 -1
  177. package/dist/agents/security.agent.d.ts +157 -3
  178. package/dist/agents/security.agent.d.ts.map +1 -1
  179. package/dist/agents/security.agent.js +3 -0
  180. package/dist/agents/security.agent.js.map +1 -1
  181. package/dist/agents/swarm/main.js +1 -1
  182. package/dist/agents/swarm/main.js.map +1 -1
  183. package/dist/agents/swarm/registry.d.ts.map +1 -1
  184. package/dist/agents/swarm/registry.js +232 -26
  185. package/dist/agents/swarm/registry.js.map +1 -1
  186. package/dist/cli/chat.d.ts +1 -1
  187. package/dist/cli/chat.d.ts.map +1 -1
  188. package/dist/cli/chat.js +32 -10
  189. package/dist/cli/chat.js.map +1 -1
  190. package/dist/cli/doctor.d.ts +14 -0
  191. package/dist/cli/doctor.d.ts.map +1 -1
  192. package/dist/cli/doctor.js +91 -0
  193. package/dist/cli/doctor.js.map +1 -1
  194. package/dist/cli/format.d.ts +1 -0
  195. package/dist/cli/format.d.ts.map +1 -1
  196. package/dist/cli/format.js +68 -14
  197. package/dist/cli/format.js.map +1 -1
  198. package/dist/cli/menu.d.ts.map +1 -1
  199. package/dist/cli/menu.js +102 -0
  200. package/dist/cli/menu.js.map +1 -1
  201. package/dist/cli/setup.d.ts +10 -0
  202. package/dist/cli/setup.d.ts.map +1 -1
  203. package/dist/cli/setup.js +187 -3
  204. package/dist/cli/setup.js.map +1 -1
  205. package/dist/cli/update.d.ts +2 -0
  206. package/dist/cli/update.d.ts.map +1 -1
  207. package/dist/cli/update.js +89 -1
  208. package/dist/cli/update.js.map +1 -1
  209. package/dist/config/env.d.ts +12 -0
  210. package/dist/config/env.d.ts.map +1 -1
  211. package/dist/config/env.js +19 -5
  212. package/dist/config/env.js.map +1 -1
  213. package/dist/index.d.ts +1 -1
  214. package/dist/index.d.ts.map +1 -1
  215. package/dist/index.js +61 -5
  216. package/dist/index.js.map +1 -1
  217. package/dist/jobs/trigger-orchestrator.d.ts +5 -1
  218. package/dist/jobs/trigger-orchestrator.d.ts.map +1 -1
  219. package/dist/jobs/trigger-orchestrator.js +29 -9
  220. package/dist/jobs/trigger-orchestrator.js.map +1 -1
  221. package/dist/jobs/trigger-router.d.ts.map +1 -1
  222. package/dist/jobs/trigger-router.js +3 -2
  223. package/dist/jobs/trigger-router.js.map +1 -1
  224. package/dist/memory/corporate-wiki.d.ts +15 -0
  225. package/dist/memory/corporate-wiki.d.ts.map +1 -0
  226. package/dist/memory/corporate-wiki.js +152 -0
  227. package/dist/memory/corporate-wiki.js.map +1 -0
  228. package/dist/observability/doctor.d.ts.map +1 -1
  229. package/dist/observability/doctor.js +12 -4
  230. package/dist/observability/doctor.js.map +1 -1
  231. package/dist/pre-init.d.ts +2 -0
  232. package/dist/pre-init.d.ts.map +1 -0
  233. package/dist/pre-init.js +3 -0
  234. package/dist/pre-init.js.map +1 -0
  235. package/dist/runtime/chat-bridge.d.ts.map +1 -1
  236. package/dist/runtime/chat-bridge.js +33 -2
  237. package/dist/runtime/chat-bridge.js.map +1 -1
  238. package/dist/runtime/swarm.d.ts +0 -1
  239. package/dist/runtime/swarm.d.ts.map +1 -1
  240. package/dist/runtime/swarm.js +26 -15
  241. package/dist/runtime/swarm.js.map +1 -1
  242. package/dist/safety/approvals.d.ts +2 -2
  243. package/dist/safety/approvals.d.ts.map +1 -1
  244. package/dist/safety/approvals.js +47 -1
  245. package/dist/safety/approvals.js.map +1 -1
  246. package/dist/safety/redaction.d.ts.map +1 -1
  247. package/dist/safety/redaction.js +10 -0
  248. package/dist/safety/redaction.js.map +1 -1
  249. package/dist/server.d.ts +1 -0
  250. package/dist/server.d.ts.map +1 -1
  251. package/dist/server.js +1 -0
  252. package/dist/server.js.map +1 -1
  253. package/dist/tools/cloud.tool.d.ts +394 -0
  254. package/dist/tools/cloud.tool.d.ts.map +1 -0
  255. package/dist/tools/cloud.tool.js +784 -0
  256. package/dist/tools/cloud.tool.js.map +1 -0
  257. package/dist/tools/computer-use.tool.d.ts +6 -6
  258. package/dist/tools/corporate-wiki.tool.d.ts +22 -0
  259. package/dist/tools/corporate-wiki.tool.d.ts.map +1 -0
  260. package/dist/tools/corporate-wiki.tool.js +39 -0
  261. package/dist/tools/corporate-wiki.tool.js.map +1 -0
  262. package/dist/tools/desktop.tool.d.ts +96 -0
  263. package/dist/tools/desktop.tool.d.ts.map +1 -1
  264. package/dist/tools/desktop.tool.js +439 -0
  265. package/dist/tools/desktop.tool.js.map +1 -1
  266. package/dist/tools/devops.tool.d.ts +162 -0
  267. package/dist/tools/devops.tool.d.ts.map +1 -0
  268. package/dist/tools/devops.tool.js +377 -0
  269. package/dist/tools/devops.tool.js.map +1 -0
  270. package/dist/tools/multimedia.tool.d.ts +126 -0
  271. package/dist/tools/multimedia.tool.d.ts.map +1 -0
  272. package/dist/tools/multimedia.tool.js +533 -0
  273. package/dist/tools/multimedia.tool.js.map +1 -0
  274. package/dist/tools/osint.tool.d.ts +6 -6
  275. package/dist/tools/sandbox-dev.tool.d.ts +15 -0
  276. package/dist/tools/sandbox-dev.tool.d.ts.map +1 -0
  277. package/dist/tools/sandbox-dev.tool.js +139 -0
  278. package/dist/tools/sandbox-dev.tool.js.map +1 -0
  279. package/dist/tools/setup-assistant.tool.d.ts +1 -1
  280. package/dist/tools/shell.tool.d.ts +82 -0
  281. package/dist/tools/shell.tool.d.ts.map +1 -1
  282. package/dist/tools/shell.tool.js +192 -1
  283. package/dist/tools/shell.tool.js.map +1 -1
  284. package/dist/tools/swarm-ops.tool.d.ts +14 -0
  285. package/dist/tools/swarm-ops.tool.d.ts.map +1 -1
  286. package/dist/tools/swarm-ops.tool.js +44 -0
  287. package/dist/tools/swarm-ops.tool.js.map +1 -1
  288. package/dist/tools/sysops.tool.d.ts +157 -0
  289. package/dist/tools/sysops.tool.d.ts.map +1 -0
  290. package/dist/tools/sysops.tool.js +643 -0
  291. package/dist/tools/sysops.tool.js.map +1 -0
  292. package/dist/voice/cascade.d.ts +1 -0
  293. package/dist/voice/cascade.d.ts.map +1 -1
  294. package/dist/voice/cascade.js +16 -1
  295. package/dist/voice/cascade.js.map +1 -1
  296. package/dist/voice/deepgram.d.ts.map +1 -1
  297. package/dist/voice/deepgram.js +34 -2
  298. package/dist/voice/deepgram.js.map +1 -1
  299. package/dist/voice/terminal.d.ts +1 -0
  300. package/dist/voice/terminal.d.ts.map +1 -1
  301. package/dist/voice/terminal.js +28 -0
  302. package/dist/voice/terminal.js.map +1 -1
  303. package/dist/voice/types.d.ts +2 -0
  304. package/dist/voice/types.d.ts.map +1 -1
  305. package/package.json +9 -1
  306. package/scripts/release-github.mjs +23 -18
@@ -0,0 +1,285 @@
1
+ # AEO and GEO Content Patterns
2
+
3
+ Reusable content block patterns optimized for answer engines and AI citation.
4
+
5
+ ---
6
+
7
+ ## Contents
8
+ - Answer Engine Optimization (AEO) Patterns (Definition Block, Step-by-Step Block, Comparison Table Block, Pros and Cons Block, FAQ Block, Listicle Block)
9
+ - Generative Engine Optimization (GEO) Patterns (Statistic Citation Block, Expert Quote Block, Authoritative Claim Block, Self-Contained Answer Block, Evidence Sandwich Block)
10
+ - Domain-Specific GEO Tactics (Technology Content, Health/Medical Content, Financial Content, Legal Content, Business/Marketing Content)
11
+ - Voice Search Optimization (Question Formats for Voice, Voice-Optimized Answer Structure)
12
+
13
+ ## Answer Engine Optimization (AEO) Patterns
14
+
15
+ These patterns help content appear in featured snippets, AI Overviews, voice search results, and answer boxes.
16
+
17
+ ### Definition Block
18
+
19
+ Use for "What is [X]?" queries.
20
+
21
+ ```markdown
22
+ ## What is [Term]?
23
+
24
+ [Term] is [concise 1-sentence definition]. [Expanded 1-2 sentence explanation with key characteristics]. [Brief context on why it matters or how it's used].
25
+ ```
26
+
27
+ **Example:**
28
+ ```markdown
29
+ ## What is Answer Engine Optimization?
30
+
31
+ Answer Engine Optimization (AEO) is the practice of structuring content so AI-powered systems can easily extract and present it as direct answers to user queries. Unlike traditional SEO that focuses on ranking in search results, AEO optimizes for featured snippets, AI Overviews, and voice assistant responses. This approach has become essential as over 60% of Google searches now end without a click.
32
+ ```
33
+
34
+ ### Step-by-Step Block
35
+
36
+ Use for "How to [X]" queries. Optimal for list snippets.
37
+
38
+ ```markdown
39
+ ## How to [Action/Goal]
40
+
41
+ [1-sentence overview of the process]
42
+
43
+ 1. **[Step Name]**: [Clear action description in 1-2 sentences]
44
+ 2. **[Step Name]**: [Clear action description in 1-2 sentences]
45
+ 3. **[Step Name]**: [Clear action description in 1-2 sentences]
46
+ 4. **[Step Name]**: [Clear action description in 1-2 sentences]
47
+ 5. **[Step Name]**: [Clear action description in 1-2 sentences]
48
+
49
+ [Optional: Brief note on expected outcome or time estimate]
50
+ ```
51
+
52
+ **Example:**
53
+ ```markdown
54
+ ## How to Optimize Content for Featured Snippets
55
+
56
+ Earning featured snippets requires strategic formatting and direct answers to search queries.
57
+
58
+ 1. **Identify snippet opportunities**: Use tools like Semrush or Ahrefs to find keywords where competitors have snippets you could capture.
59
+ 2. **Match the snippet format**: Analyze whether the current snippet is a paragraph, list, or table, and format your content accordingly.
60
+ 3. **Answer the question directly**: Provide a clear, concise answer (40-60 words for paragraph snippets) immediately after the question heading.
61
+ 4. **Add supporting context**: Expand on your answer with examples, data, and expert insights in the following paragraphs.
62
+ 5. **Use proper heading structure**: Place your target question as an H2 or H3, with the answer immediately following.
63
+
64
+ Most featured snippets appear within 2-4 weeks of publishing well-optimized content.
65
+ ```
66
+
67
+ ### Comparison Table Block
68
+
69
+ Use for "[X] vs [Y]" queries. Optimal for table snippets.
70
+
71
+ ```markdown
72
+ ## [Option A] vs [Option B]: [Brief Descriptor]
73
+
74
+ | Feature | [Option A] | [Option B] |
75
+ |---------|------------|------------|
76
+ | [Criteria 1] | [Value/Description] | [Value/Description] |
77
+ | [Criteria 2] | [Value/Description] | [Value/Description] |
78
+ | [Criteria 3] | [Value/Description] | [Value/Description] |
79
+ | [Criteria 4] | [Value/Description] | [Value/Description] |
80
+ | Best For | [Use case] | [Use case] |
81
+
82
+ **Bottom line**: [1-2 sentence recommendation based on different needs]
83
+ ```
84
+
85
+ ### Pros and Cons Block
86
+
87
+ Use for evaluation queries: "Is [X] worth it?", "Should I [X]?"
88
+
89
+ ```markdown
90
+ ## Advantages and Disadvantages of [Topic]
91
+
92
+ [1-sentence overview of the evaluation context]
93
+
94
+ ### Pros
95
+
96
+ - **[Benefit category]**: [Specific explanation]
97
+ - **[Benefit category]**: [Specific explanation]
98
+ - **[Benefit category]**: [Specific explanation]
99
+
100
+ ### Cons
101
+
102
+ - **[Drawback category]**: [Specific explanation]
103
+ - **[Drawback category]**: [Specific explanation]
104
+ - **[Drawback category]**: [Specific explanation]
105
+
106
+ **Verdict**: [1-2 sentence balanced conclusion with recommendation]
107
+ ```
108
+
109
+ ### FAQ Block
110
+
111
+ Use for topic pages with multiple common questions. Essential for FAQ schema.
112
+
113
+ ```markdown
114
+ ## Frequently Asked Questions
115
+
116
+ ### [Question phrased exactly as users search]?
117
+
118
+ [Direct answer in first sentence]. [Supporting context in 2-3 additional sentences].
119
+
120
+ ### [Question phrased exactly as users search]?
121
+
122
+ [Direct answer in first sentence]. [Supporting context in 2-3 additional sentences].
123
+
124
+ ### [Question phrased exactly as users search]?
125
+
126
+ [Direct answer in first sentence]. [Supporting context in 2-3 additional sentences].
127
+ ```
128
+
129
+ **Tips for FAQ questions:**
130
+ - Use natural question phrasing ("How do I..." not "How does one...")
131
+ - Include question words: what, how, why, when, where, who, which
132
+ - Match "People Also Ask" queries from search results
133
+ - Keep answers between 50-100 words
134
+
135
+ ### Listicle Block
136
+
137
+ Use for "Best [X]", "Top [X]", "[Number] ways to [X]" queries.
138
+
139
+ ```markdown
140
+ ## [Number] Best [Items] for [Goal/Purpose]
141
+
142
+ [1-2 sentence intro establishing context and selection criteria]
143
+
144
+ ### 1. [Item Name]
145
+
146
+ [Why it's included in 2-3 sentences with specific benefits]
147
+
148
+ ### 2. [Item Name]
149
+
150
+ [Why it's included in 2-3 sentences with specific benefits]
151
+
152
+ ### 3. [Item Name]
153
+
154
+ [Why it's included in 2-3 sentences with specific benefits]
155
+ ```
156
+
157
+ ---
158
+
159
+ ## Generative Engine Optimization (GEO) Patterns
160
+
161
+ These patterns optimize content for citation by AI assistants like ChatGPT, Claude, Perplexity, and Gemini.
162
+
163
+ ### Statistic Citation Block
164
+
165
+ Statistics increase AI citation rates by 15-30%. Always include sources.
166
+
167
+ ```markdown
168
+ [Claim statement]. According to [Source/Organization], [specific statistic with number and timeframe]. [Context for why this matters].
169
+ ```
170
+
171
+ **Example:**
172
+ ```markdown
173
+ Mobile optimization is no longer optional for SEO success. According to Google's 2024 Core Web Vitals report, 70% of web traffic now comes from mobile devices, and pages failing mobile usability standards see 24% higher bounce rates. This makes mobile-first indexing a critical ranking factor.
174
+ ```
175
+
176
+ ### Expert Quote Block
177
+
178
+ Named expert attribution adds credibility and increases citation likelihood.
179
+
180
+ ```markdown
181
+ "[Direct quote from expert]," says [Expert Name], [Title/Role] at [Organization]. [1 sentence of context or interpretation].
182
+ ```
183
+
184
+ **Example:**
185
+ ```markdown
186
+ "The shift from keyword-driven search to intent-driven discovery represents the most significant change in SEO since mobile-first indexing," says Rand Fishkin, Co-founder of SparkToro. This perspective highlights why content strategies must evolve beyond traditional keyword optimization.
187
+ ```
188
+
189
+ ### Authoritative Claim Block
190
+
191
+ Structure claims for easy AI extraction with clear attribution.
192
+
193
+ ```markdown
194
+ [Topic] [verb: is/has/requires/involves] [clear, specific claim]. [Source] [confirms/reports/found] that [supporting evidence]. This [explains/means/suggests] [implication or action].
195
+ ```
196
+
197
+ **Example:**
198
+ ```markdown
199
+ E-E-A-T is the cornerstone of Google's content quality evaluation. Google's Search Quality Rater Guidelines confirm that trust is the most critical factor, stating that "untrustworthy pages have low E-E-A-T no matter how experienced, expert, or authoritative they may seem." This means content creators must prioritize transparency and accuracy above all other optimization tactics.
200
+ ```
201
+
202
+ ### Self-Contained Answer Block
203
+
204
+ Create quotable, standalone statements that AI can extract directly.
205
+
206
+ ```markdown
207
+ **[Topic/Question]**: [Complete, self-contained answer that makes sense without additional context. Include specific details, numbers, or examples in 2-3 sentences.]
208
+ ```
209
+
210
+ **Example:**
211
+ ```markdown
212
+ **Ideal blog post length for SEO**: The optimal length for SEO blog posts is 1,500-2,500 words for competitive topics. This range allows comprehensive topic coverage while maintaining reader engagement. HubSpot research shows long-form content earns 77% more backlinks than short articles, directly impacting search rankings.
213
+ ```
214
+
215
+ ### Evidence Sandwich Block
216
+
217
+ Structure claims with evidence for maximum credibility.
218
+
219
+ ```markdown
220
+ [Opening claim statement].
221
+
222
+ Evidence supporting this includes:
223
+ - [Data point 1 with source]
224
+ - [Data point 2 with source]
225
+ - [Data point 3 with source]
226
+
227
+ [Concluding statement connecting evidence to actionable insight].
228
+ ```
229
+
230
+ ---
231
+
232
+ ## Domain-Specific GEO Tactics
233
+
234
+ Different content domains benefit from different authority signals.
235
+
236
+ ### Technology Content
237
+ - Emphasize technical precision and correct terminology
238
+ - Include version numbers and dates for software/tools
239
+ - Reference official documentation
240
+ - Add code examples where relevant
241
+
242
+ ### Health/Medical Content
243
+ - Cite peer-reviewed studies with publication details
244
+ - Include expert credentials (MD, RN, etc.)
245
+ - Note study limitations and context
246
+ - Add "last reviewed" dates
247
+
248
+ ### Financial Content
249
+ - Reference regulatory bodies (SEC, FTC, etc.)
250
+ - Include specific numbers with timeframes
251
+ - Note that information is educational, not advice
252
+ - Cite recognized financial institutions
253
+
254
+ ### Legal Content
255
+ - Cite specific laws, statutes, and regulations
256
+ - Reference jurisdiction clearly
257
+ - Include professional disclaimers
258
+ - Note when professional consultation is advised
259
+
260
+ ### Business/Marketing Content
261
+ - Include case studies with measurable results
262
+ - Reference industry research and reports
263
+ - Add percentage changes and timeframes
264
+ - Quote recognized thought leaders
265
+
266
+ ---
267
+
268
+ ## Voice Search Optimization
269
+
270
+ Voice queries are conversational and question-based. Optimize for these patterns:
271
+
272
+ ### Question Formats for Voice
273
+ - "What is..."
274
+ - "How do I..."
275
+ - "Where can I find..."
276
+ - "Why does..."
277
+ - "When should I..."
278
+ - "Who is..."
279
+
280
+ ### Voice-Optimized Answer Structure
281
+ - Lead with direct answer (under 30 words ideal)
282
+ - Use natural, conversational language
283
+ - Avoid jargon unless targeting expert audience
284
+ - Include local context where relevant
285
+ - Structure for single spoken response
@@ -0,0 +1,71 @@
1
+ # AI SEO by Content Type
2
+
3
+ Tactical guidance for optimizing specific content types for AI search citation. These tactics work for non-Google AI engines (ChatGPT, Claude, Perplexity, Copilot) and don't hurt Google AI Overviews / AI Mode.
4
+
5
+ For the cross-cutting strategy, see [SKILL.md](../SKILL.md).
6
+
7
+ ---
8
+
9
+ ## SaaS Product Pages
10
+
11
+ **Goal:** Get cited in "What is [category]?" and "Best [category]" queries.
12
+
13
+ **Optimize:**
14
+ - Clear product description in first paragraph (what it does, who it's for)
15
+ - Feature comparison tables (you vs. category, not just competitors)
16
+ - Specific metrics ("processes 10,000 transactions/sec" not "blazing fast")
17
+ - Customer count or social proof with numbers
18
+ - Pricing transparency (AI cites pages with visible pricing) — add a `/pricing.md` file so AI agents can parse your plans without rendering your page (see "Machine-Readable Files" in the main skill)
19
+ - FAQ section addressing common buyer questions
20
+
21
+ ---
22
+
23
+ ## Blog Content
24
+
25
+ **Goal:** Get cited as an authoritative source on topics in your space.
26
+
27
+ **Optimize:**
28
+ - One clear target query per post (match heading to query)
29
+ - Definition in first paragraph for "What is" queries
30
+ - Original data, research, or expert quotes
31
+ - "Last updated" date visible
32
+ - Author bio with relevant credentials
33
+ - Internal links to related product/feature pages
34
+
35
+ ---
36
+
37
+ ## Comparison / Alternative Pages
38
+
39
+ **Goal:** Get cited in "[X] vs [Y]" and "Best [X] alternatives" queries.
40
+
41
+ **Optimize:**
42
+ - Structured comparison tables (not just prose)
43
+ - Fair and balanced (AI penalizes obviously biased comparisons)
44
+ - Specific criteria with ratings or scores
45
+ - Updated pricing and feature data
46
+ - Cite the `competitors` skill for building these pages
47
+
48
+ ---
49
+
50
+ ## Documentation / Help Content
51
+
52
+ **Goal:** Get cited in "How to [X] with [your product]" queries.
53
+
54
+ **Optimize:**
55
+ - Step-by-step format with numbered lists
56
+ - Code examples where relevant
57
+ - HowTo schema markup
58
+ - Screenshots with descriptive alt text
59
+ - Clear prerequisites and expected outcomes
60
+
61
+ ---
62
+
63
+ ## Local Business / Ecom (Google emphasis)
64
+
65
+ Google's AI features pull from product feeds and business profiles for local + ecom queries. Optimize:
66
+
67
+ - **Merchant Center feeds** kept current with accurate inventory, pricing, attributes
68
+ - **Google Business Profile** complete with hours, services, photos, posts, Q&A answered
69
+ - **Reviews** — recent + sufficient volume; respond to reviews to signal active management
70
+ - **Service area schema** for local services
71
+ - **Business Agent** (where available) for conversational customer engagement
@@ -0,0 +1,104 @@
1
+ # Open Knowledge Format (OKF)
2
+
3
+ Google's v0.1 markdown spec for representing site content as an agent-readable bundle. Introduced on the [Google Cloud blog](https://cloud.google.com/blog/products/data-analytics/how-the-open-knowledge-format-can-improve-data-sharing) on 2026-06-12 and shipped inside Knowledge Catalog.
4
+
5
+ ## What it is
6
+
7
+ OKF is a directory of cross-linked markdown files. Each file has:
8
+
9
+ - A YAML frontmatter block (`type` required; `title`, `description`, `resource`, `tags`, `timestamp` recommended)
10
+ - A standard markdown body
11
+ - Standard markdown links to other files in the bundle (which the spec treats as concept relationships)
12
+
13
+ An optional `index.md` lists the files for progressive disclosure. The bundle can be distributed as a git repo (recommended), a tarball/zip, or a subdirectory of a larger repo.
14
+
15
+ The [full spec](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/HEAD/okf/SPEC.md) fits on one page. The repo lives under `GoogleCloudPlatform` (the "not an official Google product" disclaimer is Google's standard open-source boilerplate, not a denial — it appears on most of Google's open-source repos including their main AI samples repo).
16
+
17
+ ### A minimal concept file
18
+
19
+ ```markdown
20
+ ---
21
+ type: Article
22
+ title: How to Connect the Ahrefs MCP Server to Manus
23
+ description: The official MCP servers, why they did not connect, and the fix.
24
+ resource: https://yoursite.com/blog/ahrefs-mcp-manus/
25
+ tags: [mcp, ahrefs]
26
+ ---
27
+
28
+ # How to Connect the Ahrefs MCP Server to Manus
29
+
30
+ The body of the post, as clean markdown.
31
+ ```
32
+
33
+ Add an `index.md` that lists all files so an agent can see the bundle's shape before opening each file, and that is the entire format.
34
+
35
+ ## Honest framing
36
+
37
+ **Google built OKF for data teams sharing catalog metadata** — BigQuery tables, API endpoints, metrics, playbooks. Most of the spec's examples are data-team artifacts, not blog posts. Google's blog post framing: "improve data sharing" and "standardized documentation" for collaboration across teams.
38
+
39
+ Pointing OKF at a marketing site is a **clever repurposing** popularized by [Suganthan Mohanadasan](https://suganthan.com/blog/open-knowledge-format/). It's a legitimate use case for the format but not Google's primary one. Frame it accurately when explaining it to founders or marketing teams.
40
+
41
+ ## What it does for AI search today
42
+
43
+ Nothing immediate. Nothing crawls the web for OKF bundles yet — the spec is weeks old, no AI engine has announced integration, and Knowledge Catalog ingests bundles only for paying enterprise customers' data teams.
44
+
45
+ Treat OKF as **protocol-layer registration** — the same shape of bet as early `schema.org` adoption was a decade ago. Schema took the better part of ten years to pay off; people who shipped it early are still glad they did.
46
+
47
+ A secondary benefit that pays off today regardless: **generating the bundle is itself an internal-linking audit**. Suganthan's tool draws every page as a node and every internal link as an edge, so islands and orphans become obvious at a glance.
48
+
49
+ ## Where OKF fits in the agent-readable stack
50
+
51
+ | Layer | Purpose |
52
+ |---|---|
53
+ | `sitemap.xml` | Tells a crawler which URLs exist |
54
+ | `robots.txt` (with AI bot rules) | Permits or blocks AI crawlers |
55
+ | `llms.txt` | Points an agent at the handful of pages you most want read |
56
+ | `/pricing.md` | Structured pricing for agent-buyer comparisons |
57
+ | **`/okf/` bundle** | Hands over the content itself as cross-linked concepts |
58
+ | Schema markup | Per-page structured data (Article, FAQPage, Product, etc.) |
59
+
60
+ These stack rather than compete. `llms.txt` is a signpost, OKF is the library.
61
+
62
+ ## How to ship one
63
+
64
+ Three options, ordered by how much effort they take:
65
+
66
+ ### 1. Suganthan's free web tool (recommended for most sites)
67
+
68
+ [suganthan.com/okf-generator](https://suganthan.com/okf-generator/) — paste a URL or sitemap, crawls up to 100 pages, returns a downloadable bundle. Also draws the resulting page graph so you can spot disconnected pages before publishing.
69
+
70
+ ### 2. WordPress plugin (pending wp.org approval)
71
+
72
+ Suganthan's plugin (free, GPL, awaiting wp.org approval at time of writing) installs in a minute, serves the bundle at `/okf/`, and rebuilds on every publish or edit so it stays in sync. Direct download link is in [his blog post](https://suganthan.com/blog/open-knowledge-format/). Requires WordPress 6.0+ and PHP 7.4+. Read-only — never edits posts or settings.
73
+
74
+ ### 3. By hand
75
+
76
+ Only practical for a handful of pages. Each post becomes a markdown file with frontmatter that you cross-link manually. Miserable for a whole site.
77
+
78
+ ## Hosting & discovery
79
+
80
+ Serve the bundle at `yoursite.com/okf/`, starting with `yoursite.com/okf/index.md`:
81
+
82
+ - **Static hosts / Cloudflare**: drag and drop
83
+ - **WordPress**: Suganthan's plugin handles the serving
84
+ - **Static sites with custom paths**: upload the directory to `/okf/`
85
+ - **Closed platforms (Wix, Squarespace, most page-builders)**: you usually can't serve files at custom paths — skip OKF entirely
86
+
87
+ After it's serving, add a line to `llms.txt` pointing to the bundle so agents that read `llms.txt` (today) can discover the bundle (later).
88
+
89
+ ## When to skip
90
+
91
+ - Site is <10 pages — overhead exceeds payoff
92
+ - Site is on a closed platform that won't allow custom paths
93
+ - You're not maintaining `llms.txt`, schema markup, or other machine-readable files (OKF compounds with those; alone it does nothing)
94
+ - You can't budget the 30 minutes a quarter to refresh the bundle as content changes
95
+
96
+ ## What to watch
97
+
98
+ OKF is v0.1, weeks old. Worth tracking, not worth obsessing over:
99
+
100
+ - Whether Google announces OKF support in AI Overviews / Knowledge Graph (currently no signal)
101
+ - Whether non-Google engines (ChatGPT, Perplexity, Claude) announce OKF reading
102
+ - Whether the spec moves to v1.0 (breaking changes are possible at <1.0)
103
+ - Whether Knowledge Catalog adds public ingestion endpoints
104
+ - Adoption signals — search GitHub for `okf/index.md` to see who's shipping bundles
@@ -0,0 +1,154 @@
1
+ # How Each AI Platform Picks Sources
2
+
3
+ Each AI search platform has its own search index, ranking logic, and content preferences. This guide covers what matters for getting cited on each one.
4
+
5
+ Sources cited throughout: Princeton GEO study (KDD 2024), SE Ranking domain authority study, ZipTie content-answer fit analysis.
6
+
7
+ ---
8
+
9
+ ## The Fundamentals
10
+
11
+ Every AI platform shares three baseline requirements:
12
+
13
+ 1. **Your content must be in their index** — Each platform uses a different search backend (Google, Bing, Brave, or their own). If you're not indexed, you can't be cited.
14
+ 2. **Your content must be crawlable** — AI bots need access via robots.txt. Block the bot, lose the citation.
15
+ 3. **Your content must be extractable** — AI systems pull passages, not pages. Clear structure and self-contained paragraphs win.
16
+
17
+ Beyond these basics, each platform weights different signals. Here's what matters and where.
18
+
19
+ ---
20
+
21
+ ## Google AI Overviews
22
+
23
+ Google AI Overviews pull from Google's own index and lean heavily on E-E-A-T signals (Experience, Expertise, Authoritativeness, Trustworthiness). They appear in roughly 45% of Google searches.
24
+
25
+ **What makes Google AI Overviews different:** They already have your traditional SEO signals — backlinks, page authority, topical relevance. The additional AI layer adds a preference for content with cited sources and structured data. Research shows that including authoritative citations in your content correlates with a 132% visibility boost, and writing with an authoritative (not salesy) tone adds another 89%.
26
+
27
+ **Importantly, AI Overviews don't just recycle the traditional Top 10.** Only about 15% of AI Overview sources overlap with conventional organic results. Pages that wouldn't crack page 1 in traditional search can still get cited if they have strong structured data and clear, extractable answers.
28
+
29
+ **What to focus on:**
30
+ - Schema markup is the single biggest lever — Article, FAQPage, HowTo, and Product schemas give AI Overviews structured context to work with (30-40% visibility boost)
31
+ - Build topical authority through content clusters with strong internal linking
32
+ - Include named, sourced citations in your content (not just claims)
33
+ - Author bios with real credentials matter — E-E-A-T is weighted heavily
34
+ - Get into Google's Knowledge Graph where possible (an accurate Wikipedia entry helps)
35
+ - Target "how to" and "what is" query patterns — these trigger AI Overviews most often
36
+
37
+ **Watch for OKF.** In June 2026 Google introduced the [Open Knowledge Format](https://cloud.google.com/blog/products/data-analytics/how-the-open-knowledge-format-can-improve-data-sharing) — a markdown spec for agent-readable site bundles. There is no confirmed signal that AI Overviews factor it in today, but the spec is published, the GitHub repo lives under `GoogleCloudPlatform`, and it ships inside Knowledge Catalog. For protocol-layer "register early" plays, it has the same shape as early schema.org adoption did a decade ago. See **Machine-Readable Files for AI Agents** in the main `SKILL.md` for how to generate and serve a bundle.
38
+
39
+ ---
40
+
41
+ ## ChatGPT
42
+
43
+ ChatGPT's web search draws from a Bing-based index. It combines this with its training knowledge to generate answers, then cites the web sources it relied on.
44
+
45
+ **What makes ChatGPT different:** Domain authority matters more here than on other AI platforms. An SE Ranking analysis of 129,000 domains found that authority and credibility signals account for roughly 40% of what determines citation, with content quality at about 35% and platform trust at 25%. Sites with very high referring domain counts (350K+) average 8.4 citations per response, while sites with slightly lower trust scores (91-96 vs 97-100) drop from 8.4 to 6 citations.
46
+
47
+ **Freshness is a major differentiator.** Content updated within the last 30 days gets cited about 3.2x more often than older content. ChatGPT clearly favors recent information.
48
+
49
+ **The most important signal is content-answer fit** — a ZipTie analysis of 400,000 pages found that how well your content's style and structure matches ChatGPT's own response format accounts for about 55% of citation likelihood. This is far more important than domain authority (12%) or on-page structure (14%) alone. Write the way ChatGPT would answer the question, and you're more likely to be the source it cites.
50
+
51
+ **Where ChatGPT looks beyond your site:** Wikipedia accounts for 7.8% of all ChatGPT citations, Reddit for 1.8%, and Forbes for 1.1%. Brand official sites are cited frequently but third-party mentions carry significant weight.
52
+
53
+ **What to focus on:**
54
+ - Invest in backlinks and domain authority — it's the strongest baseline signal
55
+ - Update competitive content at least monthly
56
+ - Structure your content the way ChatGPT structures its answers (conversational, direct, well-organized)
57
+ - Include verifiable statistics with named sources
58
+ - Clean heading hierarchy (H1 > H2 > H3) with descriptive headings
59
+
60
+ ---
61
+
62
+ ## Perplexity
63
+
64
+ Perplexity always cites its sources with clickable links, making it the most transparent AI search platform. It combines its own index with Google's and runs results through multiple reranking passes — initial relevance retrieval, then traditional ranking factor scoring, then ML-based quality evaluation that can discard entire result sets if they don't meet quality thresholds.
65
+
66
+ **What makes Perplexity different:** It's the most "research-oriented" AI search engine, and its citation behavior reflects that. Perplexity maintains curated lists of authoritative domains (Amazon, GitHub, major academic sites) that get inherent ranking boosts. It uses a time-decay algorithm that evaluates new content quickly, giving fresh publishers a real shot at citation.
67
+
68
+ **Perplexity has unique content preferences:**
69
+ - **FAQ Schema (JSON-LD)** — Pages with FAQ structured data get cited noticeably more often
70
+ - **PDF documents** — Publicly accessible PDFs (whitepapers, research reports) are prioritized. If you have authoritative PDF content gated behind a form, consider making a version public.
71
+ - **Publishing velocity** — How frequently you publish matters more than keyword targeting
72
+ - **Self-contained paragraphs** — Perplexity prefers atomic, semantically complete paragraphs it can extract cleanly
73
+
74
+ **What to focus on:**
75
+ - Allow PerplexityBot in robots.txt
76
+ - Implement FAQPage schema on any page with Q&A content
77
+ - Host PDF resources publicly (whitepapers, guides, reports)
78
+ - Add Article schema with publication and modification timestamps
79
+ - Write in clear, self-contained paragraphs that work as standalone answers
80
+ - Build deep topical authority in your specific niche
81
+
82
+ ---
83
+
84
+ ## Microsoft Copilot
85
+
86
+ Copilot is embedded across Microsoft's ecosystem — Edge, Windows, Microsoft 365, and Bing Search. It relies entirely on Bing's index, so if Bing hasn't indexed your content, Copilot can't cite it.
87
+
88
+ **What makes Copilot different:** The Microsoft ecosystem connection creates unique optimization opportunities. Mentions and content on LinkedIn and GitHub provide ranking boosts that other platforms don't offer. Copilot also puts more weight on page speed — sub-2-second load times are a clear threshold.
89
+
90
+ **What to focus on:**
91
+ - Submit your site to Bing Webmaster Tools (many sites only submit to Google Search Console)
92
+ - Use IndexNow protocol for faster indexing of new and updated content
93
+ - Optimize page speed to under 2 seconds
94
+ - Write clear entity definitions — when your content defines a term or concept, make the definition explicit and extractable
95
+ - Build presence on LinkedIn (publish articles, maintain company page) and GitHub if relevant
96
+ - Ensure Bingbot has full crawl access
97
+
98
+ ---
99
+
100
+ ## Claude
101
+
102
+ Claude uses Brave Search as its search backend when web search is enabled — not Google, not Bing. This is a completely different index, which means your Brave Search visibility directly determines whether Claude can find and cite you.
103
+
104
+ **What makes Claude different:** Claude is extremely selective about what it cites. While it processes enormous amounts of content, its citation rate is very low — it's looking for the most factually accurate, well-sourced content on a given topic. Data-rich content with specific numbers and clear attribution performs significantly better than general-purpose content.
105
+
106
+ **What to focus on:**
107
+ - Verify your content appears in Brave Search results (search for your brand and key terms at search.brave.com)
108
+ - Allow ClaudeBot and anthropic-ai user agents in robots.txt
109
+ - Maximize factual density — specific numbers, named sources, dated statistics
110
+ - Use clear, extractable structure with descriptive headings
111
+ - Cite authoritative sources within your content
112
+ - Aim to be the most factually accurate source on your topic — Claude rewards precision
113
+
114
+ ---
115
+
116
+ ## Allowing AI Bots in robots.txt
117
+
118
+ If your robots.txt blocks an AI bot, that platform can't cite your content. Here are the user agents to allow:
119
+
120
+ ```
121
+ User-agent: GPTBot # OpenAI — powers ChatGPT search
122
+ User-agent: ChatGPT-User # ChatGPT browsing mode
123
+ User-agent: PerplexityBot # Perplexity AI search
124
+ User-agent: ClaudeBot # Anthropic Claude
125
+ User-agent: anthropic-ai # Anthropic Claude (alternate)
126
+ User-agent: Google-Extended # Google Gemini and AI Overviews
127
+ User-agent: Bingbot # Microsoft Copilot (via Bing)
128
+ Allow: /
129
+ ```
130
+
131
+ **Training vs. search:** Some AI bots are used for both model training and search citation. If you want to be cited but don't want your content used for training, your options are limited — GPTBot handles both for OpenAI. However, you can safely block **CCBot** (Common Crawl) without affecting any AI search citations, since it's only used for training dataset collection.
132
+
133
+ ---
134
+
135
+ ## Where to Start
136
+
137
+ If you're optimizing for AI search for the first time, focus your effort where your audience actually is:
138
+
139
+ **Start with Google AI Overviews** — They reach the most users (45%+ of Google searches) and you likely already have Google SEO foundations in place. Add schema markup, include cited sources in your content, and strengthen E-E-A-T signals.
140
+
141
+ **Then address ChatGPT** — It's the most-used standalone AI search tool for tech and business audiences. Focus on freshness (update content monthly), domain authority, and matching your content structure to how ChatGPT formats its responses.
142
+
143
+ **Then expand to Perplexity** — Especially valuable if your audience includes researchers, early adopters, or tech professionals. Add FAQ schema, publish PDF resources, and write in clear, self-contained paragraphs.
144
+
145
+ **Copilot and Claude are lower priority** unless your audience skews enterprise/Microsoft (Copilot) or developer/analyst (Claude). But the fundamentals — structured content, cited sources, schema markup — help across all platforms.
146
+
147
+ **Actions that help everywhere:**
148
+ 1. Allow all AI bots in robots.txt
149
+ 2. Implement schema markup (FAQPage, Article, Organization at minimum)
150
+ 3. Include statistics with named sources in your content
151
+ 4. Update content regularly — monthly for competitive topics
152
+ 5. Use clear heading structure (H1 > H2 > H3)
153
+ 6. Keep page load time under 2 seconds
154
+ 7. Add author bios with credentials