opencode-knowledge-work 0.0.0-stage → 0.1.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 (472) hide show
  1. package/LICENSE +212 -0
  2. package/README.md +124 -2
  3. package/content/bio-research/.mcp.json +48 -0
  4. package/content/bio-research/CONNECTORS.md +23 -0
  5. package/content/bio-research/LICENSE +202 -0
  6. package/content/bio-research/README.md +83 -0
  7. package/content/bio-research/skills/bio-research-instrument-data-to-allotrope/LICENSE.txt +201 -0
  8. package/content/bio-research/skills/bio-research-instrument-data-to-allotrope/SKILL.md +280 -0
  9. package/content/bio-research/skills/bio-research-instrument-data-to-allotrope/references/asm_schema_overview.md +226 -0
  10. package/content/bio-research/skills/bio-research-instrument-data-to-allotrope/references/field_classification_guide.md +503 -0
  11. package/content/bio-research/skills/bio-research-instrument-data-to-allotrope/references/flattening_guide.md +254 -0
  12. package/content/bio-research/skills/bio-research-instrument-data-to-allotrope/references/supported_instruments.md +151 -0
  13. package/content/bio-research/skills/bio-research-instrument-data-to-allotrope/requirements.txt +26 -0
  14. package/content/bio-research/skills/bio-research-instrument-data-to-allotrope/scripts/convert_to_asm.py +543 -0
  15. package/content/bio-research/skills/bio-research-instrument-data-to-allotrope/scripts/export_parser.py +481 -0
  16. package/content/bio-research/skills/bio-research-instrument-data-to-allotrope/scripts/flatten_asm.py +254 -0
  17. package/content/bio-research/skills/bio-research-instrument-data-to-allotrope/scripts/validate_asm.py +1102 -0
  18. package/content/bio-research/skills/bio-research-nextflow-development/LICENSE.txt +201 -0
  19. package/content/bio-research/skills/bio-research-nextflow-development/SKILL.md +290 -0
  20. package/content/bio-research/skills/bio-research-nextflow-development/references/geo-sra-acquisition.md +416 -0
  21. package/content/bio-research/skills/bio-research-nextflow-development/references/installation.md +96 -0
  22. package/content/bio-research/skills/bio-research-nextflow-development/references/pipelines/atacseq.md +138 -0
  23. package/content/bio-research/skills/bio-research-nextflow-development/references/pipelines/rnaseq.md +118 -0
  24. package/content/bio-research/skills/bio-research-nextflow-development/references/pipelines/sarek.md +145 -0
  25. package/content/bio-research/skills/bio-research-nextflow-development/references/troubleshooting.md +137 -0
  26. package/content/bio-research/skills/bio-research-nextflow-development/scripts/check_environment.py +452 -0
  27. package/content/bio-research/skills/bio-research-nextflow-development/scripts/config/genomes.yaml +148 -0
  28. package/content/bio-research/skills/bio-research-nextflow-development/scripts/config/pipelines/atacseq.yaml +187 -0
  29. package/content/bio-research/skills/bio-research-nextflow-development/scripts/config/pipelines/rnaseq.yaml +147 -0
  30. package/content/bio-research/skills/bio-research-nextflow-development/scripts/config/pipelines/sarek.yaml +233 -0
  31. package/content/bio-research/skills/bio-research-nextflow-development/scripts/detect_data_type.py +300 -0
  32. package/content/bio-research/skills/bio-research-nextflow-development/scripts/generate_samplesheet.py +455 -0
  33. package/content/bio-research/skills/bio-research-nextflow-development/scripts/manage_genomes.py +521 -0
  34. package/content/bio-research/skills/bio-research-nextflow-development/scripts/sra_geo_fetch.py +732 -0
  35. package/content/bio-research/skills/bio-research-nextflow-development/scripts/utils/__init__.py +69 -0
  36. package/content/bio-research/skills/bio-research-nextflow-development/scripts/utils/file_discovery.py +189 -0
  37. package/content/bio-research/skills/bio-research-nextflow-development/scripts/utils/ncbi_utils.py +808 -0
  38. package/content/bio-research/skills/bio-research-nextflow-development/scripts/utils/sample_inference.py +290 -0
  39. package/content/bio-research/skills/bio-research-nextflow-development/scripts/utils/validators.py +256 -0
  40. package/content/bio-research/skills/bio-research-scientific-problem-selection/LICENSE.txt +201 -0
  41. package/content/bio-research/skills/bio-research-scientific-problem-selection/SKILL.md +269 -0
  42. package/content/bio-research/skills/bio-research-scientific-problem-selection/references/01-intuition-pumps.md +264 -0
  43. package/content/bio-research/skills/bio-research-scientific-problem-selection/references/02-risk-assessment.md +323 -0
  44. package/content/bio-research/skills/bio-research-scientific-problem-selection/references/03-optimization-function.md +481 -0
  45. package/content/bio-research/skills/bio-research-scientific-problem-selection/references/04-parameter-strategy.md +396 -0
  46. package/content/bio-research/skills/bio-research-scientific-problem-selection/references/05-decision-tree.md +85 -0
  47. package/content/bio-research/skills/bio-research-scientific-problem-selection/references/06-adversity-planning.md +123 -0
  48. package/content/bio-research/skills/bio-research-scientific-problem-selection/references/07-problem-inversion.md +152 -0
  49. package/content/bio-research/skills/bio-research-scientific-problem-selection/references/08-integration-synthesis.md +173 -0
  50. package/content/bio-research/skills/bio-research-scientific-problem-selection/references/09-meta-framework.md +504 -0
  51. package/content/bio-research/skills/bio-research-scvi-tools/LICENSE.txt +201 -0
  52. package/content/bio-research/skills/bio-research-scvi-tools/SKILL.md +155 -0
  53. package/content/bio-research/skills/bio-research-scvi-tools/references/atac_peakvi.md +398 -0
  54. package/content/bio-research/skills/bio-research-scvi-tools/references/batch_correction_sysvi.md +417 -0
  55. package/content/bio-research/skills/bio-research-scvi-tools/references/citeseq_totalvi.md +420 -0
  56. package/content/bio-research/skills/bio-research-scvi-tools/references/data_preparation.md +286 -0
  57. package/content/bio-research/skills/bio-research-scvi-tools/references/environment_setup.md +254 -0
  58. package/content/bio-research/skills/bio-research-scvi-tools/references/label_transfer.md +373 -0
  59. package/content/bio-research/skills/bio-research-scvi-tools/references/multiome_multivi.md +384 -0
  60. package/content/bio-research/skills/bio-research-scvi-tools/references/rna_velocity_velovi.md +410 -0
  61. package/content/bio-research/skills/bio-research-scvi-tools/references/scarches_mapping.md +401 -0
  62. package/content/bio-research/skills/bio-research-scvi-tools/references/scrna_integration.md +429 -0
  63. package/content/bio-research/skills/bio-research-scvi-tools/references/spatial_deconvolution.md +438 -0
  64. package/content/bio-research/skills/bio-research-scvi-tools/references/troubleshooting.md +420 -0
  65. package/content/bio-research/skills/bio-research-scvi-tools/scripts/cluster_embed.py +212 -0
  66. package/content/bio-research/skills/bio-research-scvi-tools/scripts/differential_expression.py +220 -0
  67. package/content/bio-research/skills/bio-research-scvi-tools/scripts/integrate_datasets.py +237 -0
  68. package/content/bio-research/skills/bio-research-scvi-tools/scripts/model_utils.py +634 -0
  69. package/content/bio-research/skills/bio-research-scvi-tools/scripts/prepare_data.py +169 -0
  70. package/content/bio-research/skills/bio-research-scvi-tools/scripts/train_model.py +370 -0
  71. package/content/bio-research/skills/bio-research-scvi-tools/scripts/transfer_labels.py +224 -0
  72. package/content/bio-research/skills/bio-research-scvi-tools/scripts/validate_adata.py +397 -0
  73. package/content/bio-research/skills/bio-research-single-cell-rna-qc/LICENSE.txt +201 -0
  74. package/content/bio-research/skills/bio-research-single-cell-rna-qc/SKILL.md +175 -0
  75. package/content/bio-research/skills/bio-research-single-cell-rna-qc/references/scverse_qc_guidelines.md +186 -0
  76. package/content/bio-research/skills/bio-research-single-cell-rna-qc/scripts/qc_analysis.py +232 -0
  77. package/content/bio-research/skills/bio-research-single-cell-rna-qc/scripts/qc_core.py +233 -0
  78. package/content/bio-research/skills/bio-research-single-cell-rna-qc/scripts/qc_plotting.py +235 -0
  79. package/content/bio-research/skills/bio-research-start/SKILL.md +79 -0
  80. package/content/customer-support/.mcp.json +40 -0
  81. package/content/customer-support/CONNECTORS.md +19 -0
  82. package/content/customer-support/LICENSE +202 -0
  83. package/content/customer-support/README.md +140 -0
  84. package/content/customer-support/skills/customer-support-customer-escalation/SKILL.md +248 -0
  85. package/content/customer-support/skills/customer-support-customer-research/SKILL.md +252 -0
  86. package/content/customer-support/skills/customer-support-draft-response/SKILL.md +418 -0
  87. package/content/customer-support/skills/customer-support-kb-article/SKILL.md +351 -0
  88. package/content/customer-support/skills/customer-support-ticket-triage/SKILL.md +275 -0
  89. package/content/data/.mcp.json +36 -0
  90. package/content/data/CONNECTORS.md +18 -0
  91. package/content/data/LICENSE +202 -0
  92. package/content/data/README.md +121 -0
  93. package/content/data/skills/data-analyze/SKILL.md +119 -0
  94. package/content/data/skills/data-build-dashboard/SKILL.md +924 -0
  95. package/content/data/skills/data-create-viz/SKILL.md +154 -0
  96. package/content/data/skills/data-data-context-extractor/SKILL.md +227 -0
  97. package/content/data/skills/data-data-context-extractor/references/domain-template.md +147 -0
  98. package/content/data/skills/data-data-context-extractor/references/example-output.md +198 -0
  99. package/content/data/skills/data-data-context-extractor/references/skill-template.md +148 -0
  100. package/content/data/skills/data-data-context-extractor/references/sql-dialects.md +121 -0
  101. package/content/data/skills/data-data-context-extractor/scripts/package_data_skill.py +126 -0
  102. package/content/data/skills/data-data-visualization/SKILL.md +305 -0
  103. package/content/data/skills/data-explore-data/SKILL.md +325 -0
  104. package/content/data/skills/data-sql-queries/SKILL.md +428 -0
  105. package/content/data/skills/data-statistical-analysis/SKILL.md +245 -0
  106. package/content/data/skills/data-validate-data/SKILL.md +383 -0
  107. package/content/data/skills/data-write-query/SKILL.md +122 -0
  108. package/content/design/.mcp.json +44 -0
  109. package/content/design/CONNECTORS.md +18 -0
  110. package/content/design/README.md +117 -0
  111. package/content/design/skills/design-accessibility-review/SKILL.md +128 -0
  112. package/content/design/skills/design-design-critique/SKILL.md +118 -0
  113. package/content/design/skills/design-design-handoff/SKILL.md +131 -0
  114. package/content/design/skills/design-design-system/SKILL.md +190 -0
  115. package/content/design/skills/design-research-synthesis/SKILL.md +92 -0
  116. package/content/design/skills/design-user-research/SKILL.md +41 -0
  117. package/content/design/skills/design-ux-copy/SKILL.md +107 -0
  118. package/content/engineering/.mcp.json +48 -0
  119. package/content/engineering/CONNECTORS.md +19 -0
  120. package/content/engineering/README.md +136 -0
  121. package/content/engineering/skills/engineering-architecture/SKILL.md +85 -0
  122. package/content/engineering/skills/engineering-code-review/SKILL.md +118 -0
  123. package/content/engineering/skills/engineering-debug/SKILL.md +95 -0
  124. package/content/engineering/skills/engineering-deploy-checklist/SKILL.md +78 -0
  125. package/content/engineering/skills/engineering-documentation/SKILL.md +49 -0
  126. package/content/engineering/skills/engineering-incident-response/SKILL.md +158 -0
  127. package/content/engineering/skills/engineering-standup/SKILL.md +75 -0
  128. package/content/engineering/skills/engineering-system-design/SKILL.md +42 -0
  129. package/content/engineering/skills/engineering-tech-debt/SKILL.md +32 -0
  130. package/content/engineering/skills/engineering-testing-strategy/SKILL.md +33 -0
  131. package/content/enterprise-search/.mcp.json +36 -0
  132. package/content/enterprise-search/CONNECTORS.md +21 -0
  133. package/content/enterprise-search/LICENSE +202 -0
  134. package/content/enterprise-search/README.md +157 -0
  135. package/content/enterprise-search/skills/enterprise-search-digest/SKILL.md +173 -0
  136. package/content/enterprise-search/skills/enterprise-search-knowledge-synthesis/SKILL.md +258 -0
  137. package/content/enterprise-search/skills/enterprise-search-search/SKILL.md +178 -0
  138. package/content/enterprise-search/skills/enterprise-search-search-strategy/SKILL.md +222 -0
  139. package/content/enterprise-search/skills/enterprise-search-source-management/SKILL.md +173 -0
  140. package/content/finance/.mcp.json +32 -0
  141. package/content/finance/CONNECTORS.md +20 -0
  142. package/content/finance/LICENSE +202 -0
  143. package/content/finance/README.md +92 -0
  144. package/content/finance/skills/finance-audit-support/SKILL.md +374 -0
  145. package/content/finance/skills/finance-close-management/SKILL.md +221 -0
  146. package/content/finance/skills/finance-financial-statements/SKILL.md +335 -0
  147. package/content/finance/skills/finance-journal-entry/SKILL.md +131 -0
  148. package/content/finance/skills/finance-journal-entry-prep/SKILL.md +186 -0
  149. package/content/finance/skills/finance-reconciliation/SKILL.md +175 -0
  150. package/content/finance/skills/finance-sox-testing/SKILL.md +218 -0
  151. package/content/finance/skills/finance-variance-analysis/SKILL.md +266 -0
  152. package/content/human-resources/.mcp.json +28 -0
  153. package/content/human-resources/CONNECTORS.md +19 -0
  154. package/content/human-resources/README.md +138 -0
  155. package/content/human-resources/skills/human-resources-comp-analysis/SKILL.md +92 -0
  156. package/content/human-resources/skills/human-resources-draft-offer/SKILL.md +82 -0
  157. package/content/human-resources/skills/human-resources-interview-prep/SKILL.md +37 -0
  158. package/content/human-resources/skills/human-resources-onboarding/SKILL.md +104 -0
  159. package/content/human-resources/skills/human-resources-org-planning/SKILL.md +28 -0
  160. package/content/human-resources/skills/human-resources-people-report/SKILL.md +99 -0
  161. package/content/human-resources/skills/human-resources-performance-review/SKILL.md +149 -0
  162. package/content/human-resources/skills/human-resources-policy-lookup/SKILL.md +94 -0
  163. package/content/human-resources/skills/human-resources-recruiting-pipeline/SKILL.md +31 -0
  164. package/content/legal/.mcp.json +36 -0
  165. package/content/legal/CONNECTORS.md +21 -0
  166. package/content/legal/LICENSE +202 -0
  167. package/content/legal/README.md +234 -0
  168. package/content/legal/skills/legal-brief/SKILL.md +208 -0
  169. package/content/legal/skills/legal-compliance-check/SKILL.md +274 -0
  170. package/content/legal/skills/legal-legal-response/SKILL.md +457 -0
  171. package/content/legal/skills/legal-legal-risk-assessment/SKILL.md +265 -0
  172. package/content/legal/skills/legal-meeting-briefing/SKILL.md +220 -0
  173. package/content/legal/skills/legal-review-contract/SKILL.md +358 -0
  174. package/content/legal/skills/legal-signature-request/SKILL.md +104 -0
  175. package/content/legal/skills/legal-triage-nda/SKILL.md +262 -0
  176. package/content/legal/skills/legal-vendor-check/SKILL.md +159 -0
  177. package/content/manifest.json +86 -0
  178. package/content/marketing/.mcp.json +60 -0
  179. package/content/marketing/CONNECTORS.md +20 -0
  180. package/content/marketing/LICENSE +202 -0
  181. package/content/marketing/README.md +90 -0
  182. package/content/marketing/skills/marketing-brand-review/SKILL.md +276 -0
  183. package/content/marketing/skills/marketing-campaign-plan/SKILL.md +308 -0
  184. package/content/marketing/skills/marketing-competitive-brief/SKILL.md +331 -0
  185. package/content/marketing/skills/marketing-content-creation/SKILL.md +157 -0
  186. package/content/marketing/skills/marketing-draft-content/SKILL.md +117 -0
  187. package/content/marketing/skills/marketing-email-sequence/SKILL.md +220 -0
  188. package/content/marketing/skills/marketing-performance-report/SKILL.md +392 -0
  189. package/content/marketing/skills/marketing-seo-audit/SKILL.md +190 -0
  190. package/content/operations/.mcp.json +32 -0
  191. package/content/operations/CONNECTORS.md +20 -0
  192. package/content/operations/README.md +135 -0
  193. package/content/operations/skills/operations-capacity-plan/SKILL.md +113 -0
  194. package/content/operations/skills/operations-change-request/SKILL.md +121 -0
  195. package/content/operations/skills/operations-compliance-tracking/SKILL.md +44 -0
  196. package/content/operations/skills/operations-process-doc/SKILL.md +82 -0
  197. package/content/operations/skills/operations-process-optimization/SKILL.md +39 -0
  198. package/content/operations/skills/operations-risk-assessment/SKILL.md +40 -0
  199. package/content/operations/skills/operations-runbook/SKILL.md +87 -0
  200. package/content/operations/skills/operations-status-report/SKILL.md +77 -0
  201. package/content/operations/skills/operations-vendor-review/SKILL.md +104 -0
  202. package/content/pdf-viewer/.mcp.json +8 -0
  203. package/content/pdf-viewer/CONNECTORS.md +15 -0
  204. package/content/pdf-viewer/LICENSE +202 -0
  205. package/content/pdf-viewer/README.md +57 -0
  206. package/content/pdf-viewer/commands/annotate.md +51 -0
  207. package/content/pdf-viewer/commands/fill-form.md +73 -0
  208. package/content/pdf-viewer/commands/open.md +34 -0
  209. package/content/pdf-viewer/commands/sign.md +54 -0
  210. package/content/pdf-viewer/skills/pdf-viewer-view-pdf/SKILL.md +147 -0
  211. package/content/product-management/.mcp.json +72 -0
  212. package/content/product-management/CONNECTORS.md +22 -0
  213. package/content/product-management/LICENSE +202 -0
  214. package/content/product-management/README.md +118 -0
  215. package/content/product-management/commands/brainstorm.md +120 -0
  216. package/content/product-management/skills/product-management-competitive-brief/SKILL.md +302 -0
  217. package/content/product-management/skills/product-management-metrics-review/SKILL.md +388 -0
  218. package/content/product-management/skills/product-management-product-brainstorming/SKILL.md +273 -0
  219. package/content/product-management/skills/product-management-roadmap-update/SKILL.md +266 -0
  220. package/content/product-management/skills/product-management-sprint-planning/SKILL.md +94 -0
  221. package/content/product-management/skills/product-management-stakeholder-update/SKILL.md +352 -0
  222. package/content/product-management/skills/product-management-synthesize-research/SKILL.md +312 -0
  223. package/content/product-management/skills/product-management-write-spec/SKILL.md +250 -0
  224. package/content/productivity/.mcp.json +44 -0
  225. package/content/productivity/CONNECTORS.md +18 -0
  226. package/content/productivity/LICENSE +202 -0
  227. package/content/productivity/README.md +97 -0
  228. package/content/productivity/skills/dashboard.html +3111 -0
  229. package/content/productivity/skills/productivity-memory-management/SKILL.md +323 -0
  230. package/content/productivity/skills/productivity-start/SKILL.md +158 -0
  231. package/content/productivity/skills/productivity-task-management/SKILL.md +91 -0
  232. package/content/productivity/skills/productivity-update/SKILL.md +168 -0
  233. package/content/sales/.mcp.json +100 -0
  234. package/content/sales/CONNECTORS.md +36 -0
  235. package/content/sales/LICENSE +202 -0
  236. package/content/sales/README.md +148 -0
  237. package/content/sales/skills/sales-account-context/SKILL.md +94 -0
  238. package/content/sales/skills/sales-account-plan/SKILL.md +95 -0
  239. package/content/sales/skills/sales-account-research/SKILL.md +99 -0
  240. package/content/sales/skills/sales-account-tiering/SKILL.md +101 -0
  241. package/content/sales/skills/sales-call-prep/SKILL.md +111 -0
  242. package/content/sales/skills/sales-call-summary/SKILL.md +111 -0
  243. package/content/sales/skills/sales-close-plan/SKILL.md +106 -0
  244. package/content/sales/skills/sales-competitive-intelligence/SKILL.md +102 -0
  245. package/content/sales/skills/sales-create-an-asset/SKILL.md +105 -0
  246. package/content/sales/skills/sales-crm-hygiene-check/SKILL.md +103 -0
  247. package/content/sales/skills/sales-customer-health/SKILL.md +108 -0
  248. package/content/sales/skills/sales-customer-voice/SKILL.md +94 -0
  249. package/content/sales/skills/sales-daily-briefing/SKILL.md +61 -0
  250. package/content/sales/skills/sales-deal-advance-gap/SKILL.md +102 -0
  251. package/content/sales/skills/sales-deal-review/SKILL.md +105 -0
  252. package/content/sales/skills/sales-deal-signals/SKILL.md +96 -0
  253. package/content/sales/skills/sales-deal-slip-scenario/SKILL.md +101 -0
  254. package/content/sales/skills/sales-draft-outreach/SKILL.md +116 -0
  255. package/content/sales/skills/sales-end-of-day/SKILL.md +114 -0
  256. package/content/sales/skills/sales-expansion-whitespace/SKILL.md +97 -0
  257. package/content/sales/skills/sales-forecast/SKILL.md +100 -0
  258. package/content/sales/skills/sales-handle-objection/SKILL.md +93 -0
  259. package/content/sales/skills/sales-inbox-sweep/SKILL.md +114 -0
  260. package/content/sales/skills/sales-lead-triage/SKILL.md +105 -0
  261. package/content/sales/skills/sales-log-activity/SKILL.md +111 -0
  262. package/content/sales/skills/sales-pipeline-review/SKILL.md +97 -0
  263. package/content/sales/skills/sales-renewal-radar/SKILL.md +95 -0
  264. package/content/sales/skills/sales-rep-context/SKILL.md +90 -0
  265. package/content/sales/skills/sales-route-lead/SKILL.md +111 -0
  266. package/content/sales/skills/sales-schedule-meeting/SKILL.md +99 -0
  267. package/content/sales/skills/sales-setup/SKILL.md +195 -0
  268. package/content/sales/skills/sales-stakeholder-map/SKILL.md +107 -0
  269. package/content/sales/skills/sales-team-pipeline/SKILL.md +105 -0
  270. package/content/sales/skills/sales-update-opportunity/SKILL.md +111 -0
  271. package/content/sales/skills/sales-weekly-wrap/SKILL.md +90 -0
  272. package/content/sales/skills/sales-win-loss-review/SKILL.md +88 -0
  273. package/content/small-business/.mcp.json +148 -0
  274. package/content/small-business/README.md +117 -0
  275. package/content/small-business/skills/small-business-ad-manager/SKILL.md +128 -0
  276. package/content/small-business/skills/small-business-ad-manager/reference/ad_copy.md +112 -0
  277. package/content/small-business/skills/small-business-ad-manager/reference/change_playbook.md +127 -0
  278. package/content/small-business/skills/small-business-ad-manager/reference/data_sources.md +100 -0
  279. package/content/small-business/skills/small-business-ad-manager/reference/diagnostics.md +89 -0
  280. package/content/small-business/skills/small-business-ad-manager/reference/gotchas.md +181 -0
  281. package/content/small-business/skills/small-business-ap-processor/SKILL.md +158 -0
  282. package/content/small-business/skills/small-business-ap-processor/reference/coding_rules.md +70 -0
  283. package/content/small-business/skills/small-business-ap-processor/reference/gotchas.md +131 -0
  284. package/content/small-business/skills/small-business-ap-processor/reference/intake_and_extraction.md +82 -0
  285. package/content/small-business/skills/small-business-ap-processor/reference/matching_and_exceptions.md +80 -0
  286. package/content/small-business/skills/small-business-ap-processor/reference/payment_run.md +77 -0
  287. package/content/small-business/skills/small-business-brand-style/SKILL.md +106 -0
  288. package/content/small-business/skills/small-business-build-agent/SKILL.md +105 -0
  289. package/content/small-business/skills/small-business-build-agent/reference/capture.md +133 -0
  290. package/content/small-business/skills/small-business-build-agent/reference/gotchas.md +204 -0
  291. package/content/small-business/skills/small-business-build-agent/reference/skill_authoring.md +165 -0
  292. package/content/small-business/skills/small-business-build-connector/SKILL.md +102 -0
  293. package/content/small-business/skills/small-business-build-connector/reference/discovery.md +120 -0
  294. package/content/small-business/skills/small-business-build-connector/reference/gotchas.md +237 -0
  295. package/content/small-business/skills/small-business-build-connector/reference/paths.md +106 -0
  296. package/content/small-business/skills/small-business-build-connector/reference/use-zapier.md +128 -0
  297. package/content/small-business/skills/small-business-business-pulse/SKILL.md +181 -0
  298. package/content/small-business/skills/small-business-business-pulse/reference/data_sources.md +173 -0
  299. package/content/small-business/skills/small-business-business-pulse/reference/gotchas.md +103 -0
  300. package/content/small-business/skills/small-business-business-pulse/reference/output_template.md +109 -0
  301. package/content/small-business/skills/small-business-business-pulse/reference/thresholds.md +71 -0
  302. package/content/small-business/skills/small-business-business-pulse/reference/v2_sources.md +63 -0
  303. package/content/small-business/skills/small-business-call-list/SKILL.md +82 -0
  304. package/content/small-business/skills/small-business-canva-creator/SKILL.md +448 -0
  305. package/content/small-business/skills/small-business-canva-creator/reference/canva-api.md +208 -0
  306. package/content/small-business/skills/small-business-canva-creator/reference/examples/boutique-brief-campaign.md +181 -0
  307. package/content/small-business/skills/small-business-canva-creator/reference/gotchas.md +380 -0
  308. package/content/small-business/skills/small-business-canva-creator/reference/hubspot-staging.md +137 -0
  309. package/content/small-business/skills/small-business-cash-flow-snapshot/SKILL.md +251 -0
  310. package/content/small-business/skills/small-business-cash-flow-snapshot/reference/examples/worked-example.md +92 -0
  311. package/content/small-business/skills/small-business-cash-flow-snapshot/reference/gotchas.md +62 -0
  312. package/content/small-business/skills/small-business-cash-flow-snapshot/reference/v2_sources.md +84 -0
  313. package/content/small-business/skills/small-business-close-month/SKILL.md +86 -0
  314. package/content/small-business/skills/small-business-content-strategy/SKILL.md +152 -0
  315. package/content/small-business/skills/small-business-content-strategy/reference/examples/retail-boutique-example.md +71 -0
  316. package/content/small-business/skills/small-business-content-strategy/reference/gotchas.md +104 -0
  317. package/content/small-business/skills/small-business-content-strategy/reference/v2_sources.md +40 -0
  318. package/content/small-business/skills/small-business-contract-review/SKILL.md +158 -0
  319. package/content/small-business/skills/small-business-contract-review/reference/docusign-fetch.md +32 -0
  320. package/content/small-business/skills/small-business-contract-review/reference/examples/flagged-summary-saas.md +97 -0
  321. package/content/small-business/skills/small-business-contract-review/reference/gmail-fetch.md +30 -0
  322. package/content/small-business/skills/small-business-contract-review/reference/gotchas.md +105 -0
  323. package/content/small-business/skills/small-business-contract-review/reference/m365-fetch.md +60 -0
  324. package/content/small-business/skills/small-business-crm-autopilot/SKILL.md +162 -0
  325. package/content/small-business/skills/small-business-crm-autopilot/reference/cleanup-checklist.md +82 -0
  326. package/content/small-business/skills/small-business-crm-autopilot/reference/examples/cleanup-deal.md +83 -0
  327. package/content/small-business/skills/small-business-crm-autopilot/reference/examples/log-call-happy-path.md +68 -0
  328. package/content/small-business/skills/small-business-crm-autopilot/reference/examples/log-email-happy-path.md +50 -0
  329. package/content/small-business/skills/small-business-crm-autopilot/reference/gotchas.md +110 -0
  330. package/content/small-business/skills/small-business-crm-autopilot/reference/hubspot-fields.md +62 -0
  331. package/content/small-business/skills/small-business-crm-autopilot/reference/lightweight_crm.md +125 -0
  332. package/content/small-business/skills/small-business-crm-autopilot/reference/salesforce-fields.md +122 -0
  333. package/content/small-business/skills/small-business-crm-autopilot/reference/standing_mode.md +144 -0
  334. package/content/small-business/skills/small-business-grant-rfp-writer/SKILL.md +162 -0
  335. package/content/small-business/skills/small-business-grant-rfp-writer/reference/drafting.md +129 -0
  336. package/content/small-business/skills/small-business-grant-rfp-writer/reference/go_no_go.md +125 -0
  337. package/content/small-business/skills/small-business-grant-rfp-writer/reference/gotchas.md +180 -0
  338. package/content/small-business/skills/small-business-grant-rfp-writer/reference/opportunity_sources.md +90 -0
  339. package/content/small-business/skills/small-business-grant-rfp-writer/reference/org_profile.md +81 -0
  340. package/content/small-business/skills/small-business-grow-pipeline/SKILL.md +92 -0
  341. package/content/small-business/skills/small-business-growth-pulse/SKILL.md +143 -0
  342. package/content/small-business/skills/small-business-growth-pulse/reference/data_sources.md +113 -0
  343. package/content/small-business/skills/small-business-growth-pulse/reference/gotchas.md +175 -0
  344. package/content/small-business/skills/small-business-growth-pulse/reference/output_template.md +122 -0
  345. package/content/small-business/skills/small-business-growth-pulse/reference/thresholds.md +110 -0
  346. package/content/small-business/skills/small-business-hiring-screener/SKILL.md +137 -0
  347. package/content/small-business/skills/small-business-hiring-screener/reference/candidate_comms.md +132 -0
  348. package/content/small-business/skills/small-business-hiring-screener/reference/fair_screening.md +103 -0
  349. package/content/small-business/skills/small-business-hiring-screener/reference/gotchas.md +183 -0
  350. package/content/small-business/skills/small-business-hiring-screener/reference/onboarding.md +82 -0
  351. package/content/small-business/skills/small-business-hiring-screener/reference/rubric.md +122 -0
  352. package/content/small-business/skills/small-business-inbox-manager/SKILL.md +130 -0
  353. package/content/small-business/skills/small-business-inbox-manager/reference/digest_format.md +110 -0
  354. package/content/small-business/skills/small-business-inbox-manager/reference/gotchas.md +220 -0
  355. package/content/small-business/skills/small-business-inbox-manager/reference/handoffs.md +77 -0
  356. package/content/small-business/skills/small-business-inbox-manager/reference/reply_drafting.md +116 -0
  357. package/content/small-business/skills/small-business-inbox-manager/reference/triage_rules.md +72 -0
  358. package/content/small-business/skills/small-business-inventory-planner/SKILL.md +126 -0
  359. package/content/small-business/skills/small-business-inventory-planner/reference/data_sources.md +94 -0
  360. package/content/small-business/skills/small-business-inventory-planner/reference/gotchas.md +153 -0
  361. package/content/small-business/skills/small-business-inventory-planner/reference/po_drafting.md +92 -0
  362. package/content/small-business/skills/small-business-inventory-planner/reference/seasonality.md +112 -0
  363. package/content/small-business/skills/small-business-inventory-planner/reference/velocity_and_reorder.md +154 -0
  364. package/content/small-business/skills/small-business-invoice-chase/SKILL.md +131 -0
  365. package/content/small-business/skills/small-business-invoice-chase/reference/examples/firm-reminder.md +28 -0
  366. package/content/small-business/skills/small-business-invoice-chase/reference/examples/gentle-reminder.md +27 -0
  367. package/content/small-business/skills/small-business-invoice-chase/reference/gotchas.md +75 -0
  368. package/content/small-business/skills/small-business-invoice-chase/reference/tone-matching.md +44 -0
  369. package/content/small-business/skills/small-business-invoice-chase/reference/v2_sources.md +78 -0
  370. package/content/small-business/skills/small-business-job-post-builder/SKILL.md +204 -0
  371. package/content/small-business/skills/small-business-job-post-builder/reference/docusign-routing.md +63 -0
  372. package/content/small-business/skills/small-business-job-post-builder/reference/examples/worked-example.md +110 -0
  373. package/content/small-business/skills/small-business-job-post-builder/reference/existing-document-merge.md +58 -0
  374. package/content/small-business/skills/small-business-job-post-builder/reference/gotchas.md +68 -0
  375. package/content/small-business/skills/small-business-job-post-builder/reference/interview-guide-structure.md +93 -0
  376. package/content/small-business/skills/small-business-job-post-builder/reference/job-post-structure.md +62 -0
  377. package/content/small-business/skills/small-business-job-post-builder/reference/offer-letter-template.md +145 -0
  378. package/content/small-business/skills/small-business-job-post-builder/reference/role-intake.md +73 -0
  379. package/content/small-business/skills/small-business-lead-finder/SKILL.md +119 -0
  380. package/content/small-business/skills/small-business-lead-finder/reference/gotchas.md +152 -0
  381. package/content/small-business/skills/small-business-lead-finder/reference/icp_method.md +97 -0
  382. package/content/small-business/skills/small-business-lead-finder/reference/output_template.md +124 -0
  383. package/content/small-business/skills/small-business-lead-finder/reference/scoring.md +92 -0
  384. package/content/small-business/skills/small-business-lead-finder/reference/sourcing.md +78 -0
  385. package/content/small-business/skills/small-business-lead-triage/SKILL.md +81 -0
  386. package/content/small-business/skills/small-business-lead-triage/reference/examples/happy-path-triage.md +68 -0
  387. package/content/small-business/skills/small-business-lead-triage/reference/gotchas.md +76 -0
  388. package/content/small-business/skills/small-business-lead-triage/reference/hubspot-scoring.md +169 -0
  389. package/content/small-business/skills/small-business-marketing-monday/SKILL.md +108 -0
  390. package/content/small-business/skills/small-business-monday-brief/SKILL.md +97 -0
  391. package/content/small-business/skills/small-business-month-end-prep/SKILL.md +331 -0
  392. package/content/small-business/skills/small-business-month-end-prep/reference/close-packet-format.md +127 -0
  393. package/content/small-business/skills/small-business-month-end-prep/reference/examples/pl-narrative.md +52 -0
  394. package/content/small-business/skills/small-business-month-end-prep/reference/gotchas.md +113 -0
  395. package/content/small-business/skills/small-business-month-end-prep/reference/paypal-settlements.md +110 -0
  396. package/content/small-business/skills/small-business-month-end-prep/reference/quickbooks-reconcile.md +71 -0
  397. package/content/small-business/skills/small-business-month-end-prep/reference/v2_sources.md +125 -0
  398. package/content/small-business/skills/small-business-month-end-prep/reference/xero-reconcile.md +175 -0
  399. package/content/small-business/skills/small-business-month-end-prep/reference/zoho-books-reconcile.md +168 -0
  400. package/content/small-business/skills/small-business-outreach-composer/SKILL.md +144 -0
  401. package/content/small-business/skills/small-business-outreach-composer/reference/gotchas.md +213 -0
  402. package/content/small-business/skills/small-business-outreach-composer/reference/output_template.md +147 -0
  403. package/content/small-business/skills/small-business-outreach-composer/reference/sequence_patterns.md +99 -0
  404. package/content/small-business/skills/small-business-outreach-composer/reference/slop_test.md +164 -0
  405. package/content/small-business/skills/small-business-pay-the-bills/SKILL.md +101 -0
  406. package/content/small-business/skills/small-business-payroll-prep/SKILL.md +139 -0
  407. package/content/small-business/skills/small-business-payroll-prep/reference/anomaly_rules.md +99 -0
  408. package/content/small-business/skills/small-business-payroll-prep/reference/books_sync.md +72 -0
  409. package/content/small-business/skills/small-business-payroll-prep/reference/gotchas.md +153 -0
  410. package/content/small-business/skills/small-business-payroll-prep/reference/run_sheet_format.md +90 -0
  411. package/content/small-business/skills/small-business-payroll-prep/reference/timesheet_intake.md +118 -0
  412. package/content/small-business/skills/small-business-plan-payroll/SKILL.md +88 -0
  413. package/content/small-business/skills/small-business-proposal-builder/SKILL.md +168 -0
  414. package/content/small-business/skills/small-business-proposal-builder/reference/discovery_extraction.md +138 -0
  415. package/content/small-business/skills/small-business-proposal-builder/reference/gotchas.md +184 -0
  416. package/content/small-business/skills/small-business-proposal-builder/reference/output_template.md +128 -0
  417. package/content/small-business/skills/small-business-proposal-builder/reference/pricing_method.md +125 -0
  418. package/content/small-business/skills/small-business-proposal-builder/reference/proposal_structure.md +120 -0
  419. package/content/small-business/skills/small-business-reactivate/SKILL.md +109 -0
  420. package/content/small-business/skills/small-business-report-builder/SKILL.md +142 -0
  421. package/content/small-business/skills/small-business-report-builder/reference/data_sources.md +168 -0
  422. package/content/small-business/skills/small-business-report-builder/reference/gotchas.md +155 -0
  423. package/content/small-business/skills/small-business-report-builder/reference/output_template.md +109 -0
  424. package/content/small-business/skills/small-business-report-builder/reference/report_spec.md +109 -0
  425. package/content/small-business/skills/small-business-report-builder/reference/saved_reports.md +50 -0
  426. package/content/small-business/skills/small-business-report-pack/SKILL.md +83 -0
  427. package/content/small-business/skills/small-business-restock/SKILL.md +88 -0
  428. package/content/small-business/skills/small-business-review-reputation/SKILL.md +130 -0
  429. package/content/small-business/skills/small-business-review-reputation/reference/churn-signals.md +110 -0
  430. package/content/small-business/skills/small-business-review-reputation/reference/examples/example-report.md +150 -0
  431. package/content/small-business/skills/small-business-review-reputation/reference/gotchas.md +164 -0
  432. package/content/small-business/skills/small-business-review-reputation/reference/response-patterns.md +123 -0
  433. package/content/small-business/skills/small-business-review-reputation/reference/sources.md +116 -0
  434. package/content/small-business/skills/small-business-seo-ai-visibility/SKILL.md +143 -0
  435. package/content/small-business/skills/small-business-seo-ai-visibility/reference/ai_visibility.md +173 -0
  436. package/content/small-business/skills/small-business-seo-ai-visibility/reference/audit_checklist.md +134 -0
  437. package/content/small-business/skills/small-business-seo-ai-visibility/reference/catalog_refresh.md +126 -0
  438. package/content/small-business/skills/small-business-seo-ai-visibility/reference/content_rewrite.md +113 -0
  439. package/content/small-business/skills/small-business-seo-ai-visibility/reference/gotchas.md +211 -0
  440. package/content/small-business/skills/small-business-smb-onboard/SKILL.md +82 -0
  441. package/content/small-business/skills/small-business-smb-onboard/reference/examples/happy-path.md +190 -0
  442. package/content/small-business/skills/small-business-smb-onboard/reference/gotchas.md +111 -0
  443. package/content/small-business/skills/small-business-smb-onboard/reference/onboard-checklist.md +99 -0
  444. package/content/small-business/skills/small-business-smb-onboard/reference/website-research.md +82 -0
  445. package/content/small-business/skills/small-business-smb-router/SKILL.md +216 -0
  446. package/content/small-business/skills/small-business-smb-router/reference/connector-map.md +96 -0
  447. package/content/small-business/skills/small-business-social-content-engine/SKILL.md +162 -0
  448. package/content/small-business/skills/small-business-social-content-engine/reference/calendar.md +116 -0
  449. package/content/small-business/skills/small-business-social-content-engine/reference/canva-api.md +208 -0
  450. package/content/small-business/skills/small-business-social-content-engine/reference/examples/okonkwo-campaign.md +190 -0
  451. package/content/small-business/skills/small-business-social-content-engine/reference/gotchas.md +447 -0
  452. package/content/small-business/skills/small-business-social-content-engine/reference/publishing.md +166 -0
  453. package/content/small-business/skills/small-business-social-content-engine/reference/shopify-assets.md +77 -0
  454. package/content/small-business/skills/small-business-speed-to-lead/SKILL.md +172 -0
  455. package/content/small-business/skills/small-business-speed-to-lead/reference/approval.md +61 -0
  456. package/content/small-business/skills/small-business-speed-to-lead/reference/gotchas.md +167 -0
  457. package/content/small-business/skills/small-business-speed-to-lead/reference/qualification.md +153 -0
  458. package/content/small-business/skills/small-business-speed-to-lead/reference/response_patterns.md +184 -0
  459. package/content/small-business/skills/small-business-tax-prep/SKILL.md +85 -0
  460. package/content/small-business/skills/small-business-tax-season-organizer/SKILL.md +210 -0
  461. package/content/small-business/skills/small-business-tax-season-organizer/reference/calculation-assumptions.md +177 -0
  462. package/content/small-business/skills/small-business-tax-season-organizer/reference/connector-queries.md +267 -0
  463. package/content/small-business/skills/small-business-tax-season-organizer/reference/examples/quarterly-estimate.md +92 -0
  464. package/content/small-business/skills/small-business-tax-season-organizer/reference/examples/year-end-1099.md +102 -0
  465. package/content/small-business/skills/small-business-tax-season-organizer/reference/gotchas.md +104 -0
  466. package/content/small-business/skills/small-business-tax-season-organizer/reference/output-formats.md +68 -0
  467. package/content/small-business/skills/small-business-ticket-deflector/SKILL.md +164 -0
  468. package/content/small-business/skills/small-business-ticket-deflector/reference/examples/deny-refund-request.md +98 -0
  469. package/content/small-business/skills/small-business-ticket-deflector/reference/examples/respond-refund-request.md +77 -0
  470. package/content/small-business/skills/small-business-ticket-deflector/reference/gotchas.md +57 -0
  471. package/index.ts +84 -0
  472. package/package.json +30 -3
@@ -0,0 +1,388 @@
1
+ ---
2
+ name: metrics-review
3
+ description: Review and analyze product metrics with trend analysis and actionable insights. Use when running a weekly, monthly, or quarterly metrics review, investigating a sudden spike or drop, comparing performance against targets, or turning raw numbers into a scorecard with recommended actions.
4
+ argument-hint: "<time period or metric focus>"
5
+ ---
6
+
7
+ # Metrics Review
8
+
9
+ > If you see unfamiliar placeholders or need to check which tools are connected, see [CONNECTORS.md](../../CONNECTORS.md).
10
+
11
+ Review and analyze product metrics, identify trends, and surface actionable insights.
12
+
13
+ ## Usage
14
+
15
+ ```
16
+ /metrics-review $ARGUMENTS
17
+ ```
18
+
19
+ ## Workflow
20
+
21
+ ### 1. Gather Metrics Data
22
+
23
+ If **~~product analytics** is connected:
24
+ - Pull key product metrics for the relevant time period
25
+ - Get comparison data (previous period, same period last year, targets)
26
+ - Pull segment breakdowns if available
27
+
28
+ If no analytics tool is connected, ask the user to provide:
29
+ - The metrics and their values (paste a table, screenshot, or describe)
30
+ - Comparison data (previous period, targets)
31
+ - Any context on recent changes (launches, incidents, seasonality)
32
+
33
+ Ask the user:
34
+ - What time period to review? (last week, last month, last quarter)
35
+ - What metrics to focus on? Or should we review the full product metrics suite?
36
+ - Are there specific targets or goals to compare against?
37
+ - Any known events that might explain changes (launches, outages, marketing campaigns, seasonality)?
38
+
39
+ ### 2. Organize the Metrics
40
+
41
+ Structure the review using a metrics hierarchy: North Star metric at the top, L1 health indicators (acquisition, activation, engagement, retention, revenue, satisfaction), and L2 diagnostic metrics for drill-down. See **Product Metrics Hierarchy** below for full definitions.
42
+
43
+ If the user has not defined their metrics hierarchy, help them identify their North Star and key L1 metrics before proceeding.
44
+
45
+ ### 3. Analyze Trends
46
+
47
+ For each key metric:
48
+ - **Current value**: What is the metric today?
49
+ - **Trend**: Up, down, or flat compared to previous period? Over what timeframe?
50
+ - **vs Target**: How does it compare to the goal or target?
51
+ - **Rate of change**: Is the trend accelerating or decelerating?
52
+ - **Anomalies**: Any sudden changes, spikes, or drops?
53
+
54
+ Identify correlations:
55
+ - Do changes in one metric correlate with changes in another?
56
+ - Are there leading indicators that predict lagging metric changes?
57
+ - Do segment breakdowns reveal that an aggregate trend is driven by a specific cohort?
58
+
59
+ ### 4. Generate the Review
60
+
61
+ #### Summary
62
+ 2-3 sentences: overall product health, most notable changes, key callout.
63
+
64
+ #### Metric Scorecard
65
+ Table format for quick scanning:
66
+
67
+ | Metric | Current | Previous | Change | Target | Status |
68
+ |--------|---------|----------|--------|--------|--------|
69
+ | [Metric] | [Value] | [Value] | [+/- %] | [Target] | [On track / At risk / Miss] |
70
+
71
+ #### Trend Analysis
72
+ For each metric worth discussing:
73
+ - What happened and how significant is the change
74
+ - Why it likely happened (attribution based on known events, correlated metrics, segment analysis)
75
+ - Whether this is a one-time event or a sustained trend
76
+
77
+ #### Bright Spots
78
+ What is going well:
79
+ - Metrics beating targets
80
+ - Positive trends to sustain
81
+ - Segments or features showing strong performance
82
+
83
+ #### Areas of Concern
84
+ What needs attention:
85
+ - Metrics missing targets or trending negatively
86
+ - Early warning signals before they become problems
87
+ - Metrics where we lack visibility or understanding
88
+
89
+ #### Recommended Actions
90
+ Specific next steps based on the analysis:
91
+ - Investigations to run (dig deeper into a concerning trend)
92
+ - Experiments to launch (test hypotheses about what could improve a metric)
93
+ - Investments to make (double down on what is working)
94
+ - Alerts to set (monitor a metric more closely)
95
+
96
+ #### Context and Caveats
97
+ - Known data quality issues
98
+ - Events that affect comparability (outages, holidays, launches)
99
+ - Metrics we should be tracking but are not yet
100
+
101
+ ### 5. Follow Up
102
+
103
+ After generating the review:
104
+ - Ask if any metric needs deeper investigation
105
+ - Offer to create a dashboard spec for ongoing monitoring
106
+ - Offer to draft experiment proposals for areas of concern
107
+ - Offer to set up a metrics review template for recurring use
108
+
109
+ ## Product Metrics Hierarchy
110
+
111
+ ### North Star Metric
112
+ The single metric that best captures the core value your product delivers to users. It should be:
113
+
114
+ - **Value-aligned**: Moves when users get more value from the product
115
+ - **Leading**: Predicts long-term business success (revenue, retention)
116
+ - **Actionable**: The product team can influence it through their work
117
+ - **Understandable**: Everyone in the company can understand what it means and why it matters
118
+
119
+ **Examples by product type**:
120
+ - Collaboration tool: Weekly active teams with 3+ members contributing
121
+ - Marketplace: Weekly transactions completed
122
+ - SaaS platform: Weekly active users completing core workflow
123
+ - Content platform: Weekly engaged reading/viewing time
124
+ - Developer tool: Weekly deployments using the tool
125
+
126
+ ### L1 Metrics (Health Indicators)
127
+ The 5-7 metrics that together paint a complete picture of product health. These map to the key stages of the user lifecycle:
128
+
129
+ **Acquisition**: Are new users finding the product?
130
+ - New signups or trial starts (volume and trend)
131
+ - Signup conversion rate (visitors to signups)
132
+ - Channel mix (where are new users coming from)
133
+ - Cost per acquisition (for paid channels)
134
+
135
+ **Activation**: Are new users reaching the value moment?
136
+ - Activation rate: % of new users who complete the key action that predicts retention
137
+ - Time to activate: how long from signup to activation
138
+ - Setup completion rate: % who complete onboarding steps
139
+ - First value moment: when users first experience the core product value
140
+
141
+ **Engagement**: Are active users getting value?
142
+ - DAU / WAU / MAU: active users at different timeframes
143
+ - DAU/MAU ratio (stickiness): what fraction of monthly users come back daily
144
+ - Core action frequency: how often users do the thing that matters most
145
+ - Session depth: how much users do per session
146
+ - Feature adoption: % of users using key features
147
+
148
+ **Retention**: Are users coming back?
149
+ - D1, D7, D30 retention: % of users who return after 1 day, 7 days, 30 days
150
+ - Cohort retention curves: how retention evolves for each signup cohort
151
+ - Churn rate: % of users or revenue lost per period
152
+ - Resurrection rate: % of churned users who come back
153
+
154
+ **Monetization**: Is value translating to revenue?
155
+ - Conversion rate: free to paid (for freemium)
156
+ - MRR / ARR: monthly or annual recurring revenue
157
+ - ARPU / ARPA: average revenue per user or account
158
+ - Expansion revenue: revenue growth from existing customers
159
+ - Net revenue retention: revenue retention including expansion and contraction
160
+
161
+ **Satisfaction**: How do users feel about the product?
162
+ - NPS: Net Promoter Score
163
+ - CSAT: Customer Satisfaction Score
164
+ - Support ticket volume and resolution time
165
+ - App store ratings and review sentiment
166
+
167
+ ### L2 Metrics (Diagnostic)
168
+ Detailed metrics used to investigate changes in L1 metrics:
169
+
170
+ - Funnel conversion at each step
171
+ - Feature-level usage and adoption
172
+ - Segment-specific breakdowns (by plan, company size, geography, user role)
173
+ - Performance metrics (page load time, error rate, API latency)
174
+ - Content-specific engagement (which features, pages, or content types drive engagement)
175
+
176
+ ## Common Product Metrics
177
+
178
+ ### DAU / WAU / MAU
179
+ **What they measure**: Unique users who perform a qualifying action in a day, week, or month.
180
+
181
+ **Key decisions**:
182
+ - What counts as "active"? A login? A page view? A core action? Define this carefully — different definitions tell different stories.
183
+ - Which timeframe matters most? DAU for daily-use products (messaging, email). WAU for weekly-use products (project management). MAU for less frequent products (tax software, travel booking).
184
+
185
+ **How to use them**:
186
+ - DAU/MAU ratio (stickiness): values above 0.5 indicate a daily habit. Below 0.2 suggests infrequent usage.
187
+ - Trend matters more than absolute number. Is active usage growing, flat, or declining?
188
+ - Segment by user type. Power users and casual users behave very differently.
189
+
190
+ ### Retention
191
+ **What it measures**: Of users who started in period X, what % are still active in period Y?
192
+
193
+ **Common retention timeframes**:
194
+ - D1 (next day): Was the first experience good enough to come back?
195
+ - D7 (one week): Did the user establish a habit?
196
+ - D30 (one month): Is the user retained long-term?
197
+ - D90 (three months): Is this a durable user?
198
+
199
+ **How to use retention**:
200
+ - Plot retention curves by cohort. Look for: initial drop-off (activation problem), steady decline (engagement problem), or flattening (good — you have a stable retained base).
201
+ - Compare cohorts over time. Are newer cohorts retaining better than older ones? That means product improvements are working.
202
+ - Segment retention by activation behavior. Users who completed onboarding vs those who did not. Users who used feature X vs those who did not.
203
+
204
+ ### Conversion
205
+ **What it measures**: % of users who move from one stage to the next.
206
+
207
+ **Common conversion funnels**:
208
+ - Visitor to signup
209
+ - Signup to activation (key value moment)
210
+ - Free to paid (trial conversion)
211
+ - Trial to paid subscription
212
+ - Monthly to annual plan
213
+
214
+ **How to use conversion**:
215
+ - Map the full funnel and measure conversion at each step
216
+ - Identify the biggest drop-off points — these are your highest-leverage improvement opportunities
217
+ - Segment conversion by source, plan, user type. Different segments convert very differently.
218
+ - Track conversion over time. Is it improving as you iterate on the experience?
219
+
220
+ ### Activation
221
+ **What it measures**: % of new users who reach the moment where they first experience the product's core value.
222
+
223
+ **Defining activation**:
224
+ - Look at retained users vs churned users. What actions did retained users take that churned users did not?
225
+ - The activation event should be strongly predictive of long-term retention
226
+ - It should be achievable within the first session or first few days
227
+ - Examples: created first project, invited a teammate, completed first workflow, connected an integration
228
+
229
+ **How to use activation**:
230
+ - Track activation rate for every signup cohort
231
+ - Measure time to activate — faster is almost always better
232
+ - Build onboarding flows that guide users to the activation moment
233
+ - A/B test activation flows and measure impact on retention, not just activation rate
234
+
235
+ ## Goal Setting Frameworks
236
+
237
+ ### OKRs (Objectives and Key Results)
238
+
239
+ **Objectives**: Qualitative, aspirational goals that describe what you want to achieve.
240
+ - Inspiring and memorable
241
+ - Time-bound (quarterly or annually)
242
+ - Directional, not metric-specific
243
+
244
+ **Key Results**: Quantitative measures that tell you if you achieved the objective.
245
+ - Specific and measurable
246
+ - Time-bound with a clear target
247
+ - Outcome-based, not output-based
248
+ - 2-4 Key Results per Objective
249
+
250
+ **Example**:
251
+ ```
252
+ Objective: Make our product indispensable for daily workflows
253
+
254
+ Key Results:
255
+ - Increase DAU/MAU ratio from 0.35 to 0.50
256
+ - Increase D30 retention for new users from 40% to 55%
257
+ - 3 core workflows with >80% task completion rate
258
+ ```
259
+
260
+ ### OKR Best Practices
261
+ - Set OKRs that are ambitious but achievable. 70% completion is the target for stretch OKRs.
262
+ - Key Results should measure outcomes (user behavior, business results), not outputs (features shipped, tasks completed).
263
+ - Do not have too many OKRs. 2-3 objectives with 2-4 KRs each is plenty.
264
+ - OKRs should be uncomfortable. If you are confident you will hit all of them, they are not ambitious enough.
265
+ - Review OKRs at mid-period. Adjust effort allocation if some KRs are clearly off track.
266
+ - Grade OKRs honestly at end of period. 0.0-0.3 = missed, 0.4-0.6 = progress, 0.7-1.0 = achieved.
267
+
268
+ ### Setting Metric Targets
269
+ - **Baseline**: What is the current value? You need a reliable baseline before setting a target.
270
+ - **Benchmark**: What do comparable products achieve? Industry benchmarks provide context.
271
+ - **Trajectory**: What is the current trend? If the metric is already improving at 5% per month, a 6% target is not ambitious.
272
+ - **Effort**: How much investment are you putting behind this? Bigger bets warrant more ambitious targets.
273
+ - **Confidence**: How confident are you in hitting the target? Set a "commit" (high confidence) and a "stretch" (ambitious).
274
+
275
+ ## Metric Review Cadences
276
+
277
+ ### Weekly Metrics Check
278
+ **Purpose**: Catch issues quickly, monitor experiments, stay in touch with product health.
279
+ **Duration**: 15-30 minutes.
280
+ **Attendees**: Product manager, maybe engineering lead.
281
+
282
+ **What to review**:
283
+ - North Star metric: current value, week-over-week change
284
+ - Key L1 metrics: any notable movements
285
+ - Active experiments: results and statistical significance
286
+ - Anomalies: any unexpected spikes or drops
287
+ - Alerts: anything that triggered a monitoring alert
288
+
289
+ **Action**: If something looks off, investigate. Otherwise, note it and move on.
290
+
291
+ ### Monthly Metrics Review
292
+ **Purpose**: Deeper analysis of trends, progress against goals, strategic implications.
293
+ **Duration**: 30-60 minutes.
294
+ **Attendees**: Product team, key stakeholders.
295
+
296
+ **What to review**:
297
+ - Full L1 metric scorecard with month-over-month trends
298
+ - Progress against quarterly OKR targets
299
+ - Cohort analysis: are newer cohorts performing better?
300
+ - Feature adoption: how are recent launches performing?
301
+ - Segment analysis: any divergence between user segments?
302
+
303
+ **Action**: Identify 1-3 areas to investigate or invest in. Update priorities if metrics reveal new information.
304
+
305
+ ### Quarterly Business Review
306
+ **Purpose**: Strategic assessment of product performance, goal-setting for next quarter.
307
+ **Duration**: 60-90 minutes.
308
+ **Attendees**: Product, engineering, design, leadership.
309
+
310
+ **What to review**:
311
+ - OKR scoring for the quarter
312
+ - Trend analysis for all L1 metrics over the quarter
313
+ - Year-over-year comparisons
314
+ - Competitive context: market changes and competitor movements
315
+ - What worked and what did not
316
+
317
+ **Action**: Set OKRs for next quarter. Adjust product strategy based on what the data shows.
318
+
319
+ ## Dashboard Design Principles
320
+
321
+ ### Effective Product Dashboards
322
+ A good dashboard answers the question "How is the product doing?" at a glance.
323
+
324
+ **Principles**:
325
+
326
+ 1. **Start with the question, not the data**. What decisions does this dashboard support? Design backwards from the decision.
327
+
328
+ 2. **Hierarchy of information**. The most important metric should be the most visually prominent. North Star at the top, L1 metrics next, L2 metrics available on drill-down.
329
+
330
+ 3. **Context over numbers**. A number without context is meaningless. Always show: current value, comparison (previous period, target, benchmark), trend direction.
331
+
332
+ 4. **Fewer metrics, more insight**. A dashboard with 50 metrics helps no one. Focus on 5-10 that matter. Put everything else in a detailed report.
333
+
334
+ 5. **Consistent time periods**. Use the same time period for all metrics on a dashboard. Mixing daily and monthly metrics creates confusion.
335
+
336
+ 6. **Visual status indicators**. Use color to indicate health at a glance:
337
+ - Green: on track or improving
338
+ - Yellow: needs attention or flat
339
+ - Red: off track or declining
340
+
341
+ 7. **Actionability**. Every metric on the dashboard should be something the team can influence. If you cannot act on it, it does not belong on the product dashboard.
342
+
343
+ ### Dashboard Layout
344
+
345
+ **Top row**: North Star metric with trend line and target.
346
+
347
+ **Second row**: L1 metrics scorecard — current value, change, target, status for each key metric.
348
+
349
+ **Third row**: Key funnels or conversion metrics — visual funnel showing drop-off at each stage.
350
+
351
+ **Fourth row**: Recent experiments and launches — active A/B tests, recent feature launches with early metrics.
352
+
353
+ **Bottom / drill-down**: L2 metrics, segment breakdowns, and detailed time series for investigation.
354
+
355
+ ### Dashboard Anti-Patterns
356
+ - **Vanity metrics**: Metrics that always go up but do not indicate health (total signups ever, total page views)
357
+ - **Too many metrics**: Dashboards that require scrolling to see. If it does not fit on one screen, cut metrics.
358
+ - **No comparison**: Raw numbers without context (current value with no previous period or target)
359
+ - **Stale dashboards**: Metrics that have not been updated or reviewed in months
360
+ - **Output dashboards**: Measuring team activity (tickets closed, PRs merged) instead of user and business outcomes
361
+ - **One dashboard for all audiences**: Executives, PMs, and engineers need different views. One size does not fit all.
362
+
363
+ ### Alerting
364
+ Set alerts for metrics that require immediate attention:
365
+
366
+ - **Threshold alerts**: Metric drops below or rises above a critical threshold (error rate > 1%, conversion < 5%)
367
+ - **Trend alerts**: Metric shows sustained decline over multiple days/weeks
368
+ - **Anomaly alerts**: Metric deviates significantly from expected range
369
+
370
+ **Alert hygiene**:
371
+ - Every alert should be actionable. If you cannot do anything about it, do not alert on it.
372
+ - Review and tune alerts regularly. Too many false positives and people ignore all alerts.
373
+ - Define an owner for each alert. Who responds when it fires?
374
+ - Set appropriate severity levels. Not everything is P0.
375
+
376
+ ## Output Format
377
+
378
+ Use tables for the scorecard. Use clear status indicators. Keep the summary tight — the reader should get the essential story in 30 seconds.
379
+
380
+ ## Tips
381
+
382
+ - Start with the "so what" — what is the most important thing in this metrics review? Lead with that.
383
+ - Absolute numbers without context are useless. Always show comparisons (vs previous period, vs target, vs benchmark).
384
+ - Be careful about attribution. Correlation is not causation. If a metric moved, acknowledge uncertainty about why.
385
+ - Segment analysis often reveals that an aggregate metric masks important differences. A flat overall number might hide one segment growing and another shrinking.
386
+ - Not all metric movements matter. Small fluctuations are noise. Focus attention on meaningful changes.
387
+ - If a metric is missing its target, do not just report the miss — recommend what to do about it.
388
+ - Metrics reviews should drive decisions. If the review does not lead to at least one action, it was not useful.
@@ -0,0 +1,273 @@
1
+ ---
2
+ name: product-brainstorming
3
+ description: Brainstorm product ideas, explore problem spaces, and challenge assumptions as a thinking partner. Use when exploring a new opportunity, generating solutions to a product problem, stress-testing an idea, or when a PM needs to think out loud with a sharp sparring partner before converging on a direction.
4
+ ---
5
+
6
+ # Product Brainstorming Skill
7
+
8
+ You are a sharp product thinking partner — the kind of experienced PM or design lead who challenges assumptions, asks the hard questions, and pushes ideas further before anyone converges too early. You help product managers explore problem spaces, generate ideas, and stress-test thinking before it becomes a spec.
9
+
10
+ Your job is not to generate deliverables. Your job is to think alongside the PM. Be opinionated. Push back. Bring in unexpected angles. Help them arrive at ideas they would not have reached alone.
11
+
12
+ ## Brainstorming Modes
13
+
14
+ Different situations call for different modes of thinking. Identify which mode fits the conversation and adapt. You can shift between modes as the conversation evolves.
15
+
16
+ ### Problem Exploration
17
+
18
+ Use when the PM has a problem area but has not yet defined what to solve. The goal is to understand the problem space deeply before jumping to solutions.
19
+
20
+ **What to do:**
21
+ - Ask "who has this problem?" and "what are they doing about it today?" before anything else
22
+ - Map the problem ecosystem: who is involved, what triggers the problem, what are the consequences of not solving it
23
+ - Distinguish symptoms from root causes. PMs often describe symptoms. Keep asking "why" until you hit something structural.
24
+ - Surface adjacent problems the PM might not have considered
25
+ - Ask how the problem varies across user segments — it rarely affects everyone the same way
26
+
27
+ **Useful questions:**
28
+ - "What happens if we do nothing? Who suffers and how?"
29
+ - "Who has solved a version of this problem in a different context?"
30
+ - "Is this a problem of awareness, ability, or motivation?"
31
+ - "What would need to be true for this problem to not exist?"
32
+
33
+ ### Solution Ideation
34
+
35
+ Use when the problem is well-defined and the PM needs to generate multiple possible solutions. The goal is divergent thinking — quantity over quality.
36
+
37
+ **What to do:**
38
+ - Generate at least 5-7 distinct approaches before evaluating any of them
39
+ - Vary the solutions along meaningful dimensions: scope (small tweak vs big bet), approach (product vs process vs policy), timing (quick win vs long-term investment)
40
+ - Include at least one "what if we did the opposite?" option
41
+ - Include at least one option that removes something rather than adding something
42
+ - Resist the urge to converge too early. If the PM latches onto the first decent idea, push them to keep going.
43
+
44
+ **Ideation techniques:**
45
+ - **Constraint removal**: "What would you build if you had no technical constraints? No budget constraints? No political constraints?" Then work backward to what is feasible.
46
+ - **Analogies**: "How does [another industry] solve this? What can we steal from that approach?"
47
+ - **Inversion**: "How would we make this problem worse? Now reverse each of those."
48
+ - **Decomposition**: Break the problem into subproblems and solve each independently. Then combine.
49
+ - **User hat-switching**: "How would a power user solve this? A brand new user? An admin? Someone who hates our product?"
50
+
51
+ ### Assumption Testing
52
+
53
+ Use when the PM has an idea or direction and needs to stress-test it. The goal is to find the weak points before investing in execution.
54
+
55
+ **What to do:**
56
+ - List every assumption the idea depends on — stated and unstated
57
+ - For each assumption, ask: "How confident are we? What evidence do we have? What would disprove this?"
58
+ - Identify the riskiest assumption — the one that, if wrong, kills the idea entirely
59
+ - Suggest the cheapest way to test the riskiest assumption before building anything
60
+ - Play devil's advocate: argue the strongest possible case against the idea
61
+
62
+ **Assumption categories to probe:**
63
+ - **User assumptions**: "Users want this" — How do we know? From what evidence? How many users?
64
+ - **Problem assumptions**: "This is a real problem" — How often does it occur? How much do users care?
65
+ - **Solution assumptions**: "This solution will work" — Why this approach? What alternatives did we dismiss?
66
+ - **Business assumptions**: "This will move the metric" — Which metric? By how much? Over what timeline?
67
+ - **Feasibility assumptions**: "We can build this" — In what timeframe? With what trade-offs?
68
+ - **Adoption assumptions**: "Users will find and use this" — How? What behavior change does it require?
69
+
70
+ ### Strategy Exploration
71
+
72
+ Use when the PM is thinking about direction, positioning, or big bets — not a specific feature. The goal is to explore the strategic landscape.
73
+
74
+ **What to do:**
75
+ - Map the playing field: what are the possible strategic moves, not just the obvious one
76
+ - Think in terms of bets: what are we betting on, what are the odds, what is the payoff
77
+ - Consider second-order effects: "If we do X, what does that enable or foreclose?"
78
+ - Bring in competitive dynamics: "If we do this, how do competitors respond?"
79
+ - Think in timeframes: "What is the right move for 3 months vs 12 months vs 3 years?"
80
+
81
+ ## Brainstorming Frameworks
82
+
83
+ Use frameworks as thinking tools, not templates to fill in. Pull in a framework when it helps move the conversation forward. Do not force every conversation through every framework.
84
+
85
+ ### How Might We (HMW)
86
+
87
+ Reframe problems as opportunities. Turn a pain point into an actionable question.
88
+
89
+ **Structure**: "How might we [desired outcome] for [user] without [constraint]?"
90
+
91
+ **Tips:**
92
+ - Too broad: "How might we improve onboarding?" — could mean anything
93
+ - Too narrow: "How might we add a tooltip to step 3?" — that is a solution, not a question
94
+ - Right level: "How might we help new users reach their first success within 10 minutes?"
95
+ - Generate 5-10 HMW questions from a single problem statement. Each reframing opens different solution spaces.
96
+
97
+ ### Jobs-to-be-Done (JTBD)
98
+
99
+ Think from the user's job, not from features or demographics.
100
+
101
+ **Structure**: "When [situation], I want to [motivation] so I can [expected outcome]."
102
+
103
+ **Tips:**
104
+ - The job is stable even when solutions change. People have been "hiring" solutions to share updates with colleagues for decades — memos, email, Slack, shared docs.
105
+ - Functional jobs (get something done) are easier to identify. Emotional jobs (feel confident, look competent) and social jobs (be seen as a leader) are often more powerful.
106
+ - Ask "What did they fire to hire your product?" — this reveals the real competitive set.
107
+
108
+ ### Opportunity Solution Trees
109
+
110
+ Map the path from outcome to experiment.
111
+
112
+ ```
113
+ Desired Outcome
114
+ ├── Opportunity A (user need / pain point)
115
+ │ ├── Solution A1
116
+ │ │ ├── Experiment: ...
117
+ │ │ └── Experiment: ...
118
+ │ └── Solution A2
119
+ │ └── Experiment: ...
120
+ ├── Opportunity B
121
+ │ ├── Solution B1
122
+ │ └── Solution B2
123
+ └── Opportunity C
124
+ └── Solution C1
125
+ ```
126
+
127
+ **Tips:**
128
+ - Opportunities come from research, not imagination. Every opportunity should trace back to evidence.
129
+ - Multiple solutions per opportunity. If you only have one solution, you have not explored enough.
130
+ - Multiple experiments per solution. Find the cheapest way to test before building.
131
+ - The tree is a living artifact. Update it as you learn.
132
+
133
+ ### First Principles Decomposition
134
+
135
+ Break a complex problem down to its fundamental truths and rebuild.
136
+
137
+ 1. **State the problem or assumption** you want to examine
138
+ 2. **Break it down**: What are the fundamental components or constraints?
139
+ 3. **Question each component**: Why does this have to be this way? Is this a law of physics or a convention?
140
+ 4. **Rebuild from the ground up**: Given only the fundamental truths, what solutions are possible?
141
+
142
+ **When to use**: When the team is stuck in incremental thinking. When everyone says "that is just how it works." When the category has not been reimagined in years.
143
+
144
+ ### SCAMPER
145
+
146
+ Systematic ideation using seven lenses on an existing product or process:
147
+
148
+ - **Substitute**: What component could be replaced? What if a different user did this step?
149
+ - **Combine**: What if we merged two features? Two workflows? Two user roles?
150
+ - **Adapt**: What idea from another product or industry could we borrow?
151
+ - **Modify**: What if we made this 10x bigger? 10x smaller? 10x faster?
152
+ - **Put to other use**: Could this feature serve a different user or use case?
153
+ - **Eliminate**: What if we removed this entirely? Would anyone notice?
154
+ - **Reverse**: What if we did the opposite? Flipped the sequence? Inverted the default?
155
+
156
+ ### OODA Loop (Observe–Orient–Decide–Act)
157
+
158
+ A decision-tempo framework from military strategy that excels in fast-moving, competitive product environments. The power of OODA is not in the steps — it is in cycling through them faster than the competition.
159
+
160
+ 1. **Observe**: Gather raw signals — usage data, customer feedback, competitive moves, market shifts, support tickets. Do not filter yet. Cast wide.
161
+ 2. **Orient**: Make sense of what you observed. This is the critical step. Orient through the lens of your mental models, prior experience, and cultural context. Challenge your own orientation — are you seeing what is actually there, or what you expect to see?
162
+ 3. **Decide**: Choose a direction. Not a final commitment — a hypothesis to test. The decision should be proportional to what you know. Small bets when uncertain, bigger moves when the signal is clear.
163
+ 4. **Act**: Execute the decision. Ship something. Run the experiment. Make the change. Then immediately return to Observe with new data.
164
+
165
+ **When to use in brainstorming:**
166
+ - When the team is over-deliberating and needs to move. OODA favors tempo over perfection.
167
+ - When competitive dynamics matter — a competitor just shipped something, a market window is closing, a customer is about to churn.
168
+ - When the brainstorm keeps circling without converging. OODA forces a decision and reframes it as reversible: act, observe new data, re-orient.
169
+ - When exploring strategy: "Given what we are observing in the market, how should we re-orient our product thinking?"
170
+
171
+ **The OODA advantage in product:** Most product teams get stuck in Orient — endlessly analyzing, debating frameworks, waiting for more data. OODA says: orient with what you have, decide, act, and let the next observation cycle correct your course. The team that cycles fastest learns fastest.
172
+
173
+ ### Reverse Brainstorming
174
+
175
+ When stuck on how to solve a problem, brainstorm how to make it worse.
176
+
177
+ 1. **Invert the problem**: "How could we make onboarding as confusing as possible?"
178
+ 2. **Generate ideas**: List everything that would make the problem worse (more steps, jargon, hidden buttons, no feedback)
179
+ 3. **Reverse each idea**: Each "make it worse" idea contains the seed of a "make it better" solution
180
+ 4. **Evaluate**: Which reversed ideas are most promising?
181
+
182
+ **Why it works**: People are better at identifying what is wrong than imagining what is right. Inversion unlocks creative thinking when the team is stuck.
183
+
184
+ ## Session Structure
185
+
186
+ A good brainstorming session has rhythm — it opens up before it narrows down.
187
+
188
+ ### 1. Frame
189
+
190
+ Set boundaries before generating ideas. Good framing prevents wasted divergence.
191
+
192
+ - What are we exploring? (A specific problem, an opportunity area, a strategic question)
193
+ - Why now? (What triggered this brainstorm?)
194
+ - What do we already know? (Prior research, data, customer feedback)
195
+ - What are the constraints? (Timeline, technical, business, team)
196
+ - What would a great outcome from this session look like?
197
+
198
+ Spend enough time framing. A poorly framed brainstorm produces ideas that do not connect to real needs.
199
+
200
+ ### 2. Diverge
201
+
202
+ Generate many ideas. No judgment. Quantity enables quality.
203
+
204
+ - Build on ideas rather than shooting them down
205
+ - Follow tangents — the best ideas often come from unexpected connections
206
+ - Push past the obvious. The first 3-5 ideas are usually the ones everyone would have thought of. Keep going.
207
+ - Ask provocative questions to unlock new directions
208
+ - Use frameworks (above) to systematically explore different angles
209
+
210
+ ### 3. Provoke
211
+
212
+ Challenge and extend thinking. This is where the sparring partner role matters most.
213
+
214
+ - "What is the strongest argument against this?"
215
+ - "Who would hate this and why?"
216
+ - "What are we not seeing?"
217
+ - "What would [specific company or person] do differently?"
218
+ - "What if the opposite were true?"
219
+ - "What is the version of this that is 10x more ambitious?"
220
+
221
+ ### 4. Converge
222
+
223
+ Narrow down. Evaluate ideas against what matters.
224
+
225
+ - Group related ideas into themes
226
+ - Evaluate against: user impact, feasibility, strategic alignment, evidence strength
227
+ - Do not kill ideas by committee. If one idea excites the PM, explore it — even if it is risky. The brainstorm is not the decision.
228
+ - Identify the top 2-3 ideas worth pursuing further
229
+ - For each, name the biggest unknown and the cheapest way to resolve it
230
+
231
+ ### 5. Capture
232
+
233
+ Document what matters. A brainstorm with no capture is a brainstorm that never happened.
234
+
235
+ - Key ideas and why they are interesting
236
+ - Assumptions to test
237
+ - Questions to research
238
+ - Suggested next steps (research, prototype, talk to users, write a one-pager)
239
+ - What was explicitly set aside — ideas that were interesting but not for now
240
+
241
+ ## Being a Good Thinking Partner
242
+
243
+ ### Do
244
+
245
+ - **Be opinionated.** "I think approach B is stronger because..." is more useful than listing pros and cons.
246
+ - **Challenge constructively.** "That assumes X — are we confident?" not "That will not work."
247
+ - **Bring unexpected angles.** Cross-industry analogies, counterexamples, edge cases the PM has not considered.
248
+ - **Match energy.** If the PM is excited about an idea, explore it with them before poking holes.
249
+ - **Ask the next question.** When the PM finishes a thought, do not just agree. Push further: "And then what happens?"
250
+ - **Name the pattern.** If you recognize a common PM trap (solutioning too early, scope creep, feature parity thinking), name it directly.
251
+
252
+ ### Do Not
253
+
254
+ - **Do not dump frameworks.** Use frameworks as thinking tools when they help, not as a checklist to work through.
255
+ - **Do not generate a list and hand it over.** Brainstorming is a conversation, not a deliverable.
256
+ - **Do not agree with everything.** A thinking partner who only validates is not a thinking partner.
257
+ - **Do not optimize prematurely.** In divergent mode, do not evaluate feasibility. That kills creative thinking.
258
+ - **Do not anchor on the first idea.** If the PM leads with a solution, acknowledge it, then ask "What else could solve this?"
259
+ - **Do not confuse brainstorming with decision-making.** The brainstorm generates options. The decision comes later with more data.
260
+
261
+ ## Common Brainstorming Anti-Patterns
262
+
263
+ **Solutioning before framing**: The PM jumps to "we should build X" before defining the problem. Slow them down. Ask what user problem X solves and how we know.
264
+
265
+ **The feature parity trap**: "Competitor has X, so we need X." This is not brainstorming — it is copying. Ask what user need X serves and whether there is a better way to serve it.
266
+
267
+ **Anchoring on constraints**: "We cannot do that because of technical limitation Y." In divergent mode, set constraints aside. Explore freely first, then figure out feasibility.
268
+
269
+ **The one-idea brainstorm**: The PM comes in with a solution and calls it brainstorming. Acknowledge their idea, then push for alternatives. "That is one approach. What are three others?"
270
+
271
+ **Analysis paralysis**: Too much exploration, no convergence. If the session has been divergent for a while, prompt: "If you had to pick one direction right now, which would it be and why?"
272
+
273
+ **Brainstorming when you should be researching**: Some questions cannot be brainstormed — they need data. If the brainstorm keeps circling because no one knows the answer, stop and identify what research is needed.