bobo-ai-cli 3.0.3 → 3.0.5

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 (238) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +259 -259
  3. package/bundled-skills/CORE_SKILLS.txt +18 -18
  4. package/bundled-skills/backend-expert/SKILL.md +97 -97
  5. package/bundled-skills/code-review/SKILL.md +280 -280
  6. package/bundled-skills/code-review-expert/SKILL.md +85 -85
  7. package/bundled-skills/context-budget-analyzer/SKILL.md +76 -76
  8. package/bundled-skills/context-compressor/SKILL.md +75 -75
  9. package/bundled-skills/context-optimization-suite/SKILL.md +162 -162
  10. package/bundled-skills/frontend-expert/SKILL.md +93 -93
  11. package/bundled-skills/github/SKILL.md +12 -12
  12. package/bundled-skills/high-agency/SKILL.md +473 -473
  13. package/bundled-skills/high-agency/references/builder-patterns.md +126 -126
  14. package/bundled-skills/high-agency/references/recovery-playbook.md +298 -298
  15. package/bundled-skills/memory-manager/SKILL.md +214 -214
  16. package/bundled-skills/memory-manager/references/advanced-config.md +65 -65
  17. package/bundled-skills/orchestrator/SKILL.md +681 -681
  18. package/bundled-skills/planning-with-files/SKILL.md +193 -193
  19. package/bundled-skills/skill-creator/SKILL.md +220 -220
  20. package/bundled-skills/testing-expert/SKILL.md +99 -99
  21. package/bundled-skills/verify/SKILL.md +15 -15
  22. package/dist/agent.d.ts +5 -0
  23. package/dist/agent.js +11 -1
  24. package/dist/agent.js.map +1 -1
  25. package/dist/agents/catalog.d.ts +47 -0
  26. package/dist/agents/catalog.js +63 -5
  27. package/dist/agents/catalog.js.map +1 -1
  28. package/dist/agents/router.d.ts +12 -1
  29. package/dist/agents/router.js +43 -3
  30. package/dist/agents/router.js.map +1 -1
  31. package/dist/agents/spawn.js +36 -18
  32. package/dist/agents/spawn.js.map +1 -1
  33. package/dist/autonomous.js +5 -5
  34. package/dist/cli.js +23 -21
  35. package/dist/cli.js.map +1 -1
  36. package/dist/compactor.js +39 -39
  37. package/dist/dream.js +29 -29
  38. package/dist/image-input.d.ts +44 -0
  39. package/dist/image-input.js +161 -0
  40. package/dist/image-input.js.map +1 -0
  41. package/dist/memory.js +13 -13
  42. package/dist/project.js +15 -15
  43. package/dist/repl.js +88 -0
  44. package/dist/repl.js.map +1 -1
  45. package/dist/skills.js +54 -54
  46. package/dist/sub-agents.js +65 -65
  47. package/dist/tools/browser.js +21 -21
  48. package/dist/tools/claude-code.js +10 -10
  49. package/dist/web.js +7 -7
  50. package/dist/wiki-commands.d.ts +2 -0
  51. package/dist/wiki-commands.js +249 -0
  52. package/dist/wiki-commands.js.map +1 -0
  53. package/dist/wiki.d.ts +90 -0
  54. package/dist/wiki.js +614 -0
  55. package/dist/wiki.js.map +1 -0
  56. package/knowledge/advanced-patterns.md +70 -70
  57. package/knowledge/agent-directives.md +74 -74
  58. package/knowledge/api-integration-patterns.md +102 -0
  59. package/knowledge/code-review-protocol.md +69 -0
  60. package/knowledge/dream.md +36 -36
  61. package/knowledge/engineering.md +52 -46
  62. package/knowledge/error-catalog.md +38 -33
  63. package/knowledge/event-driven-architecture.md +43 -0
  64. package/knowledge/external-alignment.md +47 -0
  65. package/knowledge/high-agency.md +73 -0
  66. package/knowledge/image-generation.md +48 -0
  67. package/knowledge/index.json +194 -169
  68. package/knowledge/llm-wiki-pattern.md +71 -0
  69. package/knowledge/long-task-management.md +79 -0
  70. package/knowledge/memory/cache-optimization-and-skill-integration.md +102 -102
  71. package/knowledge/memory/engineering-patterns.md +134 -134
  72. package/knowledge/memory/feedback_root_structure.md +15 -15
  73. package/knowledge/memory/project-contexts.md +69 -69
  74. package/knowledge/memory/tools-and-services.md +85 -85
  75. package/knowledge/memory-management.md +72 -0
  76. package/knowledge/rules/advisor-strategy.md +204 -0
  77. package/knowledge/rules/agents.md +62 -62
  78. package/knowledge/rules/blocking-rules.md +323 -323
  79. package/knowledge/rules/cache-management.md +379 -379
  80. package/knowledge/rules/capability-evolution.md +132 -132
  81. package/knowledge/rules/coding.md +126 -126
  82. package/knowledge/rules/engineering-workflows.md +225 -225
  83. package/knowledge/rules/evomap-content-guidelines.md +354 -354
  84. package/knowledge/rules/evomap-guide.md +224 -224
  85. package/knowledge/rules/external-alignment.md +22 -0
  86. package/knowledge/rules/git.md +31 -31
  87. package/knowledge/rules/hooks.md +106 -106
  88. package/knowledge/rules/performance.md +101 -101
  89. package/knowledge/rules/remotion-auto-production.md +1120 -1120
  90. package/knowledge/rules/security.md +46 -46
  91. package/knowledge/rules/testing.md +32 -32
  92. package/knowledge/rules/work-mode.md +208 -208
  93. package/knowledge/rules.md +62 -62
  94. package/knowledge/self-evolution.md +78 -0
  95. package/knowledge/self-rationalization-guard.md +52 -0
  96. package/knowledge/skills/Skill_Seekers.md +1722 -1722
  97. package/knowledge/skills/ab-test-setup.md +557 -557
  98. package/knowledge/skills/agent-sdk-dev.md +238 -238
  99. package/knowledge/skills/agent-tools.md +136 -136
  100. package/knowledge/skills/analytics-tracking.md +597 -597
  101. package/knowledge/skills/artifacts-builder.md +89 -89
  102. package/knowledge/skills/asana.md +12 -12
  103. package/knowledge/skills/backend-expert.md +97 -97
  104. package/knowledge/skills/brand-voice.md +481 -481
  105. package/knowledge/skills/browser-use.md +419 -419
  106. package/knowledge/skills/cache-optimization-skill.md +179 -179
  107. package/knowledge/skills/canvas-design.md +147 -147
  108. package/knowledge/skills/citation-validator.md +203 -203
  109. package/knowledge/skills/clangd-lsp.md +52 -52
  110. package/knowledge/skills/code-review-expert.md +85 -85
  111. package/knowledge/skills/code-review.md +280 -280
  112. package/knowledge/skills/code-simplifier.md +12 -12
  113. package/knowledge/skills/commit-commands.md +258 -258
  114. package/knowledge/skills/competitor-alternatives.md +795 -795
  115. package/knowledge/skills/content-atomizer.md +910 -910
  116. package/knowledge/skills/content-research-writer.md +605 -605
  117. package/knowledge/skills/context-optimization-suite.md +162 -162
  118. package/knowledge/skills/context7.md +12 -12
  119. package/knowledge/skills/copy-editing.md +494 -494
  120. package/knowledge/skills/copywriting.md +510 -510
  121. package/knowledge/skills/csharp-lsp.md +40 -40
  122. package/knowledge/skills/decision-making-framework.md +154 -154
  123. package/knowledge/skills/developer-growth-analysis.md +335 -335
  124. package/knowledge/skills/direct-response-copy.md +2336 -2336
  125. package/knowledge/skills/docker-expert.md +229 -229
  126. package/knowledge/skills/document-skills.md +12 -12
  127. package/knowledge/skills/documentation-expert.md +126 -126
  128. package/knowledge/skills/email-sequence.md +1061 -1061
  129. package/knowledge/skills/email-sequences.md +910 -910
  130. package/knowledge/skills/example-plugin.md +72 -72
  131. package/knowledge/skills/explanatory-output-style.md +82 -82
  132. package/knowledge/skills/feature-dev.md +458 -458
  133. package/knowledge/skills/file-organizer.md +466 -466
  134. package/knowledge/skills/firebase.disabled.md +12 -12
  135. package/knowledge/skills/form-cro.md +488 -488
  136. package/knowledge/skills/free-tool-strategy.md +636 -636
  137. package/knowledge/skills/frontend-design-offical.md +55 -55
  138. package/knowledge/skills/frontend-design.md +41 -41
  139. package/knowledge/skills/frontend-expert.md +93 -93
  140. package/knowledge/skills/github.md +12 -12
  141. package/knowledge/skills/gitlab.md +12 -12
  142. package/knowledge/skills/gopls-lsp.md +32 -32
  143. package/knowledge/skills/got-controller.md +218 -218
  144. package/knowledge/skills/greptile.md +72 -72
  145. package/knowledge/skills/hookify.md +376 -376
  146. package/knowledge/skills/image-editor.md +189 -189
  147. package/knowledge/skills/image-enhancer.md +109 -109
  148. package/knowledge/skills/jdtls-lsp.md +49 -49
  149. package/knowledge/skills/json-canvas.md +654 -654
  150. package/knowledge/skills/keyword-research.md +559 -559
  151. package/knowledge/skills/kotlin-lsp.md +28 -28
  152. package/knowledge/skills/laravel-boost.md +12 -12
  153. package/knowledge/skills/launch-strategy.md +394 -394
  154. package/knowledge/skills/lead-magnet.md +393 -393
  155. package/knowledge/skills/learning-output-style.md +106 -106
  156. package/knowledge/skills/linear.md +12 -12
  157. package/knowledge/skills/lua-lsp.md +47 -47
  158. package/knowledge/skills/marketing-ideas.md +720 -720
  159. package/knowledge/skills/marketing-psychology.md +534 -534
  160. package/knowledge/skills/mcp-builder.md +369 -369
  161. package/knowledge/skills/meeting-insights-analyzer.md +347 -347
  162. package/knowledge/skills/memory-evolution-system.md +172 -172
  163. package/knowledge/skills/multi-lens-thinking.md +407 -407
  164. package/knowledge/skills/nano-banana-pro.md +116 -116
  165. package/knowledge/skills/newsletter.md +736 -736
  166. package/knowledge/skills/notebooklm.md +296 -296
  167. package/knowledge/skills/obsidian-bases.md +634 -634
  168. package/knowledge/skills/obsidian-markdown.md +651 -651
  169. package/knowledge/skills/onboarding-cro.md +494 -494
  170. package/knowledge/skills/orchestrator.md +681 -681
  171. package/knowledge/skills/page-cro.md +379 -379
  172. package/knowledge/skills/paid-ads.md +624 -624
  173. package/knowledge/skills/paywall-upgrade-cro.md +651 -651
  174. package/knowledge/skills/php-lsp.md +36 -36
  175. package/knowledge/skills/planning-with-files.md +193 -193
  176. package/knowledge/skills/playwright.md +12 -12
  177. package/knowledge/skills/plugin-dev.md +434 -434
  178. package/knowledge/skills/popup-cro.md +520 -520
  179. package/knowledge/skills/positioning-angles.md +330 -330
  180. package/knowledge/skills/pr-review-toolkit.md +359 -359
  181. package/knowledge/skills/pricing-strategy.md +777 -777
  182. package/knowledge/skills/programmatic-seo.md +714 -714
  183. package/knowledge/skills/pyright-lsp.md +43 -43
  184. package/knowledge/skills/quality-assurance-framework.md +168 -168
  185. package/knowledge/skills/question-refiner.md +160 -160
  186. package/knowledge/skills/ralph-loop.md +205 -205
  187. package/knowledge/skills/refactoring-expert.md +103 -103
  188. package/knowledge/skills/referral-program.md +668 -668
  189. package/knowledge/skills/research-executor.md +164 -164
  190. package/knowledge/skills/review-with-security.md +12 -12
  191. package/knowledge/skills/rust-analyzer-lsp.md +50 -50
  192. package/knowledge/skills/schema-markup.md +647 -647
  193. package/knowledge/skills/security-audit-expert.md +124 -124
  194. package/knowledge/skills/security-expert.md +140 -140
  195. package/knowledge/skills/security-guidance.md +12 -12
  196. package/knowledge/skills/seedance-prompt.md +139 -139
  197. package/knowledge/skills/self-evolution.md +1160 -1160
  198. package/knowledge/skills/seo-audit.md +432 -432
  199. package/knowledge/skills/seo-content.md +787 -787
  200. package/knowledge/skills/serena.md +12 -12
  201. package/knowledge/skills/signup-flow-cro.md +409 -409
  202. package/knowledge/skills/skill-creator.md +220 -220
  203. package/knowledge/skills/skill-manager.md +226 -226
  204. package/knowledge/skills/skill-share.md +98 -98
  205. package/knowledge/skills/slack.md +12 -12
  206. package/knowledge/skills/social-content.md +878 -878
  207. package/knowledge/skills/spec-flow-skill.md +124 -124
  208. package/knowledge/skills/stripe.md +12 -12
  209. package/knowledge/skills/supabase.md +12 -12
  210. package/knowledge/skills/swift-lsp.md +40 -40
  211. package/knowledge/skills/synthesizer.md +236 -236
  212. package/knowledge/skills/template-skill.md +16 -16
  213. package/knowledge/skills/testing-expert.md +99 -99
  214. package/knowledge/skills/theme-factory.md +72 -72
  215. package/knowledge/skills/tiktok-research.md +208 -208
  216. package/knowledge/skills/typescript-lsp.md +36 -36
  217. package/knowledge/skills/ui-ux-pro-max.md +247 -247
  218. package/knowledge/skills/verify.md +15 -15
  219. package/knowledge/skills/visual-prompt-engineer.md +102 -102
  220. package/knowledge/skills/webapp-testing.md +111 -111
  221. package/knowledge/skills/wide-research.md +191 -191
  222. package/knowledge/system.md +93 -93
  223. package/knowledge/task-router.md +46 -37
  224. package/knowledge/verification.md +38 -38
  225. package/knowledge/worker-prompt-craft.md +66 -0
  226. package/knowledge/workflows/3d-viz.md +47 -47
  227. package/knowledge/workflows/data-pipeline.md +47 -47
  228. package/knowledge/workflows/db-migration.md +51 -51
  229. package/knowledge/workflows/feature-dev.md +41 -41
  230. package/knowledge/workflows/tdd-flow.md +52 -52
  231. package/knowledge/workflows/ui-verify.md +51 -51
  232. package/package.json +74 -74
  233. package/dist/claude-bridge.d.ts +0 -18
  234. package/dist/claude-bridge.js +0 -91
  235. package/dist/claude-bridge.js.map +0 -1
  236. package/dist/tools/claude-bridge-tool.d.ts +0 -4
  237. package/dist/tools/claude-bridge-tool.js +0 -44
  238. package/dist/tools/claude-bridge-tool.js.map +0 -1
@@ -1,636 +1,636 @@
1
- ---
2
- id: "free-tool-strategy"
3
- title: "Free Tool Strategy (Engineering as Marketing)"
4
- category: "marketing"
5
- tags: ["initial assessment", "core principles", "tool types", "ideation framework", "seo considerations", "lead capture strategy", "build vs. buy vs. embed", "mvp scope", "promotion strategy", "measurement"]
6
- triggers: []
7
- dependencies: []
8
- source: "E:/Bobo's Coding cache/.claude/skills/free-tool-strategy"
9
- ---
10
-
11
- ---
12
- name: free-tool-strategy
13
- description: When the user wants to plan, evaluate, or build a free tool for marketing purposes — lead generation, SEO value, or brand awareness. Also use when the user mentions "engineering as marketing," "free tool," "marketing tool," "calculator," "generator," "interactive tool," "lead gen tool," "build a tool for leads," or "free resource." This skill bridges engineering and marketing — useful for founders and technical marketers.
14
- ---
15
-
16
- # Free Tool Strategy (Engineering as Marketing)
17
-
18
- You are an expert in engineering-as-marketing strategy. Your goal is to help plan and evaluate free tools that generate leads, attract organic traffic, and build brand awareness.
19
-
20
- ## Initial Assessment
21
-
22
- Before designing a tool strategy, understand:
23
-
24
- 1. **Business Context**
25
- - What's the core product/service?
26
- - Who is the target audience?
27
- - What problems do they have?
28
-
29
- 2. **Goals**
30
- - Lead generation primary goal?
31
- - SEO/traffic acquisition?
32
- - Brand awareness?
33
- - Product education?
34
-
35
- 3. **Resources**
36
- - Technical capacity to build?
37
- - Ongoing maintenance bandwidth?
38
- - Budget for promotion?
39
-
40
- ---
41
-
42
- ## Core Principles
43
-
44
- ### 1. Solve a Real Problem
45
-
46
- - Tool must provide genuine value
47
- - Solves a problem your audience actually has
48
- - Useful even without your main product
49
-
50
- ### 2. Adjacent to Core Product
51
-
52
- - Related to what you sell
53
- - Natural path from tool to product
54
- - Educates on problem you solve
55
-
56
- ### 3. Simple and Focused
57
-
58
- - Does one thing well
59
- - Low friction to use
60
- - Immediate value
61
-
62
- ### 4. Worth the Investment
63
-
64
- - Lead value × expected leads > build cost + maintenance
65
- - Consider SEO value
66
- - Consider brand halo effect
67
-
68
- ---
69
-
70
- ## Tool Types
71
-
72
- ### Calculators
73
-
74
- **Best for**: Decisions involving numbers, comparisons, estimates
75
-
76
- **Examples**:
77
-
78
- - ROI calculator
79
- - Savings calculator
80
- - Cost comparison tool
81
- - Salary calculator
82
- - Tax estimator
83
-
84
- **Why they work**:
85
-
86
- - Personalized output
87
- - High perceived value
88
- - Share-worthy results
89
- - Clear problem → solution
90
-
91
- ### Generators
92
-
93
- **Best for**: Creating something useful quickly
94
-
95
- **Examples**:
96
-
97
- - Policy generator
98
- - Template generator
99
- - Name/tagline generator
100
- - Email subject line generator
101
- - Resume builder
102
-
103
- **Why they work**:
104
-
105
- - Tangible output
106
- - Saves time
107
- - Easily shared
108
- - Repeat usage
109
-
110
- ### Analyzers/Auditors
111
-
112
- **Best for**: Evaluating existing work or assets
113
-
114
- **Examples**:
115
-
116
- - Website grader
117
- - SEO analyzer
118
- - Email subject tester
119
- - Headline analyzer
120
- - Security checker
121
-
122
- **Why they work**:
123
-
124
- - Curiosity-driven
125
- - Personalized insights
126
- - Creates awareness of problems
127
- - Natural lead to solution
128
-
129
- ### Testers/Validators
130
-
131
- **Best for**: Checking if something works
132
-
133
- **Examples**:
134
-
135
- - Meta tag preview
136
- - Email rendering test
137
- - Accessibility checker
138
- - Mobile-friendly test
139
- - Speed test
140
-
141
- **Why they work**:
142
-
143
- - Immediate utility
144
- - Bookmark-worthy
145
- - Repeat usage
146
- - Professional necessity
147
-
148
- ### Libraries/Resources
149
-
150
- **Best for**: Reference material
151
-
152
- **Examples**:
153
-
154
- - Icon library
155
- - Template library
156
- - Code snippet library
157
- - Example gallery
158
- - Directory
159
-
160
- **Why they work**:
161
-
162
- - High SEO value
163
- - Ongoing traffic
164
- - Establishes authority
165
- - Linkable asset
166
-
167
- ### Interactive Educational
168
-
169
- **Best for**: Learning/understanding
170
-
171
- **Examples**:
172
-
173
- - Interactive tutorials
174
- - Code playgrounds
175
- - Visual explainers
176
- - Quizzes/assessments
177
- - Simulators
178
-
179
- **Why they work**:
180
-
181
- - Engages deeply
182
- - Demonstrates expertise
183
- - Shareable
184
- - Memory-creating
185
-
186
- ---
187
-
188
- ## Ideation Framework
189
-
190
- ### Start with Pain Points
191
-
192
- 1. **What problems does your audience Google?**
193
- - Search query research
194
- - Common questions
195
- - "How to" searches
196
-
197
- 2. **What manual processes are tedious?**
198
- - Tasks done in spreadsheets
199
- - Repetitive calculations
200
- - Copy-paste workflows
201
-
202
- 3. **What do they need before buying your product?**
203
- - Assessments of current state
204
- - Planning/scoping
205
- - Comparisons
206
-
207
- 4. **What information do they wish they had?**
208
- - Data they can't easily access
209
- - Personalized insights
210
- - Industry benchmarks
211
-
212
- ### Validate the Idea
213
-
214
- **Search demand:**
215
-
216
- - Is there search volume for this problem?
217
- - What keywords would rank?
218
- - How competitive?
219
-
220
- **Uniqueness:**
221
-
222
- - What exists already?
223
- - How can you be 10x better or different?
224
- - What's your unique angle?
225
-
226
- **Lead quality:**
227
-
228
- - Does this problem-audience match buyers?
229
- - Will users be your target customers?
230
- - Is there a natural path to your product?
231
-
232
- **Build feasibility:**
233
-
234
- - How complex to build?
235
- - Can you scope an MVP?
236
- - Ongoing maintenance burden?
237
-
238
- ---
239
-
240
- ## SEO Considerations
241
-
242
- ### Keyword Strategy
243
-
244
- **Tool landing page:**
245
-
246
- - "[thing] calculator"
247
- - "[thing] generator"
248
- - "free [tool type]"
249
- - "[industry] [tool type]"
250
-
251
- **Supporting content:**
252
-
253
- - "How to [use case]"
254
- - "What is [concept tool helps with]"
255
- - Blog posts that link to tool
256
-
257
- ### Link Building
258
-
259
- Free tools attract links because:
260
-
261
- - Genuinely useful (people reference them)
262
- - Unique (can't link to just any page)
263
- - Shareable (social amplification)
264
-
265
- **Outreach opportunities:**
266
-
267
- - Roundup posts ("best free tools for X")
268
- - Resource pages
269
- - Industry publications
270
- - Blogs writing about the problem
271
-
272
- ### Technical SEO
273
-
274
- - Fast load time critical
275
- - Mobile-friendly essential
276
- - Crawlable content (not just JS app)
277
- - Proper meta tags
278
- - Schema markup if applicable
279
-
280
- ---
281
-
282
- ## Lead Capture Strategy
283
-
284
- ### When to Gate
285
-
286
- **Fully gated (email required to use):**
287
-
288
- - High-value, unique tools
289
- - Personalized reports
290
- - Risk: Lower usage
291
-
292
- **Partially gated (email for full results):**
293
-
294
- - Show preview, gate details
295
- - Better balance
296
- - Most common pattern
297
-
298
- **Ungated with optional capture:**
299
-
300
- - Tool is free to use
301
- - Email to save/share results
302
- - Highest usage, lower capture
303
-
304
- **Ungated entirely:**
305
-
306
- - Pure SEO/brand play
307
- - No direct leads
308
- - Maximum reach
309
-
310
- ### Lead Capture Best Practices
311
-
312
- - Value exchange clear: "Get your full report"
313
- - Minimal friction: Email only
314
- - Show preview of what they'll get
315
- - Optional: Segment by asking one qualifying question
316
-
317
- ### Post-Capture
318
-
319
- - Immediate email with results/link
320
- - Nurture sequence relevant to tool topic
321
- - Clear path to main product
322
- - Don't spam—provide value
323
-
324
- ---
325
-
326
- ## Build vs. Buy vs. Embed
327
-
328
- ### Build Custom
329
-
330
- **When:**
331
-
332
- - Unique concept, nothing exists
333
- - Core to brand/product
334
- - High strategic value
335
- - Have development capacity
336
-
337
- **Consider:**
338
-
339
- - Development time
340
- - Ongoing maintenance
341
- - Hosting costs
342
- - Bug fixes
343
-
344
- ### Use No-Code Tools
345
-
346
- **Options:**
347
-
348
- - Outgrow, Involve.me (calculators/quizzes)
349
- - Typeform, Tally (forms/quizzes)
350
- - Notion, Coda (databases)
351
- - Bubble, Webflow (apps)
352
-
353
- **When:**
354
-
355
- - Speed to market
356
- - Limited dev resources
357
- - Testing concept viability
358
-
359
- ### Embed Existing
360
-
361
- **When:**
362
-
363
- - Something good already exists
364
- - White-label options available
365
- - Not core differentiator
366
-
367
- **Consider:**
368
-
369
- - Branding limitations
370
- - Dependency on third party
371
- - Cost vs. build
372
-
373
- ---
374
-
375
- ## MVP Scope
376
-
377
- ### Minimum Viable Tool
378
-
379
- 1. **Core functionality only**
380
- - Does the one thing
381
- - No bells and whistles
382
- - Works reliably
383
-
384
- 2. **Essential UX**
385
- - Clear input
386
- - Obvious output
387
- - Mobile works
388
-
389
- 3. **Basic lead capture**
390
- - Email collection works
391
- - Leads go somewhere useful
392
- - Follow-up exists
393
-
394
- ### What to Skip Initially
395
-
396
- - Account creation
397
- - Saving results
398
- - Advanced features
399
- - Perfect design
400
- - Every edge case
401
-
402
- ### Iterate Based on Use
403
-
404
- - Track where users drop off
405
- - See what questions they have
406
- - Add features that get requested
407
- - Improve based on data
408
-
409
- ---
410
-
411
- ## Promotion Strategy
412
-
413
- ### Launch
414
-
415
- **Owned channels:**
416
-
417
- - Email list announcement
418
- - Blog post / landing page
419
- - Social media
420
- - Product hunt (if applicable)
421
-
422
- **Outreach:**
423
-
424
- - Relevant newsletters
425
- - Industry publications
426
- - Bloggers in space
427
- - Social influencers
428
-
429
- ### Ongoing
430
-
431
- **SEO:**
432
-
433
- - Target tool-related keywords
434
- - Supporting content
435
- - Link building
436
-
437
- **Social:**
438
-
439
- - Share interesting results (anonymized)
440
- - Use case examples
441
- - Tips for using the tool
442
-
443
- **Product integration:**
444
-
445
- - Mention in sales process
446
- - Link from related product features
447
- - Include in email sequences
448
-
449
- ---
450
-
451
- ## Measurement
452
-
453
- ### Metrics to Track
454
-
455
- **Acquisition:**
456
-
457
- - Traffic to tool
458
- - Traffic sources
459
- - Keyword rankings
460
- - Backlinks acquired
461
-
462
- **Engagement:**
463
-
464
- - Tool usage/completions
465
- - Time spent
466
- - Return visitors
467
- - Shares
468
-
469
- **Conversion:**
470
-
471
- - Email captures
472
- - Lead quality score
473
- - MQLs generated
474
- - Pipeline influenced
475
- - Customers attributed
476
-
477
- ### Attribution
478
-
479
- - UTM parameters for paid promotion
480
- - Separate landing page for organic
481
- - Track lead source through funnel
482
- - Survey new customers
483
-
484
- ---
485
-
486
- ## Evaluation Framework
487
-
488
- ### Tool Idea Scorecard
489
-
490
- Rate each factor 1-5:
491
-
492
- | Factor | Score |
493
- | ----------------------------- | ------ |
494
- | Search demand exists | \_\_\_ |
495
- | Audience match to buyers | \_\_\_ |
496
- | Uniqueness vs. existing tools | \_\_\_ |
497
- | Natural path to product | \_\_\_ |
498
- | Build feasibility | \_\_\_ |
499
- | Maintenance burden (inverse) | \_\_\_ |
500
- | Link-building potential | \_\_\_ |
501
- | Share-worthiness | \_\_\_ |
502
-
503
- **25+**: Strong candidate
504
- **15-24**: Promising, needs refinement
505
- **<15**: Reconsider or scope differently
506
-
507
- ### ROI Projection
508
-
509
- ```
510
- Estimated monthly leads: [X]
511
- Lead-to-customer rate: [Y%]
512
- Average customer value: [$Z]
513
-
514
- Monthly value: X × Y% × $Z = $___
515
-
516
- Build cost: $___
517
- Monthly maintenance: $___
518
-
519
- Payback period: Build cost / (Monthly value - Monthly maintenance)
520
- ```
521
-
522
- ---
523
-
524
- ## Output Format
525
-
526
- ### Tool Strategy Document
527
-
528
- ```
529
- # Free Tool Strategy: [Tool Name]
530
-
531
- ## Concept
532
- [What it does in one paragraph]
533
-
534
- ## Target Audience
535
- [Who uses it, what problem it solves]
536
-
537
- ## Lead Generation Fit
538
- [How this connects to your product/sales]
539
-
540
- ## SEO Opportunity
541
- - Target keywords: [list]
542
- - Search volume: [estimate]
543
- - Competition: [assessment]
544
-
545
- ## Build Approach
546
- - Custom / No-code / Embed
547
- - MVP scope: [core features]
548
- - Estimated effort: [time/cost]
549
-
550
- ## Lead Capture Strategy
551
- - Gating approach: [Full/Partial/Ungated]
552
- - Capture mechanism: [description]
553
- - Follow-up sequence: [outline]
554
-
555
- ## Success Metrics
556
- - [Metric 1]: [Target]
557
- - [Metric 2]: [Target]
558
-
559
- ## Promotion Plan
560
- - Launch: [channels]
561
- - Ongoing: [strategy]
562
-
563
- ## Timeline
564
- - Phase 1: [scope] - [timeframe]
565
- - Phase 2: [scope] - [timeframe]
566
- ```
567
-
568
- ### Implementation Spec
569
-
570
- If moving forward with build
571
-
572
- ### Promotion Plan
573
-
574
- Detailed launch and ongoing strategy
575
-
576
- ---
577
-
578
- ## Example Tool Concepts by Business Type
579
-
580
- ### SaaS Product
581
-
582
- - Product ROI calculator
583
- - Competitor comparison tool
584
- - Readiness assessment quiz
585
- - Template library for use case
586
-
587
- ### Agency/Services
588
-
589
- - Industry benchmark tool
590
- - Project scoping calculator
591
- - Portfolio review tool
592
- - Cost estimator
593
-
594
- ### E-commerce
595
-
596
- - Product finder quiz
597
- - Comparison tool
598
- - Size/fit calculator
599
- - Savings calculator
600
-
601
- ### Developer Tools
602
-
603
- - Code snippet library
604
- - Testing/preview tool
605
- - Documentation generator
606
- - Interactive tutorials
607
-
608
- ### Finance
609
-
610
- - Financial calculators
611
- - Investment comparison
612
- - Budget planner
613
- - Tax estimator
614
-
615
- ---
616
-
617
- ## Questions to Ask
618
-
619
- If you need more context:
620
-
621
- 1. What's your core product/service?
622
- 2. What problems does your audience commonly face?
623
- 3. What existing tools do they use for workarounds?
624
- 4. How do you currently generate leads?
625
- 5. What technical resources are available?
626
- 6. What's the timeline and budget?
627
-
628
- ---
629
-
630
- ## Related Skills
631
-
632
- - **page-cro**: For optimizing the tool's landing page
633
- - **seo-audit**: For SEO-optimizing the tool
634
- - **analytics-tracking**: For measuring tool usage
635
- - **email-sequence**: For nurturing leads from the tool
636
- - **programmatic-seo**: For building tool-based pages at scale
1
+ ---
2
+ id: "free-tool-strategy"
3
+ title: "Free Tool Strategy (Engineering as Marketing)"
4
+ category: "marketing"
5
+ tags: ["initial assessment", "core principles", "tool types", "ideation framework", "seo considerations", "lead capture strategy", "build vs. buy vs. embed", "mvp scope", "promotion strategy", "measurement"]
6
+ triggers: []
7
+ dependencies: []
8
+ source: "E:/Bobo's Coding cache/.claude/skills/free-tool-strategy"
9
+ ---
10
+
11
+ ---
12
+ name: free-tool-strategy
13
+ description: When the user wants to plan, evaluate, or build a free tool for marketing purposes — lead generation, SEO value, or brand awareness. Also use when the user mentions "engineering as marketing," "free tool," "marketing tool," "calculator," "generator," "interactive tool," "lead gen tool," "build a tool for leads," or "free resource." This skill bridges engineering and marketing — useful for founders and technical marketers.
14
+ ---
15
+
16
+ # Free Tool Strategy (Engineering as Marketing)
17
+
18
+ You are an expert in engineering-as-marketing strategy. Your goal is to help plan and evaluate free tools that generate leads, attract organic traffic, and build brand awareness.
19
+
20
+ ## Initial Assessment
21
+
22
+ Before designing a tool strategy, understand:
23
+
24
+ 1. **Business Context**
25
+ - What's the core product/service?
26
+ - Who is the target audience?
27
+ - What problems do they have?
28
+
29
+ 2. **Goals**
30
+ - Lead generation primary goal?
31
+ - SEO/traffic acquisition?
32
+ - Brand awareness?
33
+ - Product education?
34
+
35
+ 3. **Resources**
36
+ - Technical capacity to build?
37
+ - Ongoing maintenance bandwidth?
38
+ - Budget for promotion?
39
+
40
+ ---
41
+
42
+ ## Core Principles
43
+
44
+ ### 1. Solve a Real Problem
45
+
46
+ - Tool must provide genuine value
47
+ - Solves a problem your audience actually has
48
+ - Useful even without your main product
49
+
50
+ ### 2. Adjacent to Core Product
51
+
52
+ - Related to what you sell
53
+ - Natural path from tool to product
54
+ - Educates on problem you solve
55
+
56
+ ### 3. Simple and Focused
57
+
58
+ - Does one thing well
59
+ - Low friction to use
60
+ - Immediate value
61
+
62
+ ### 4. Worth the Investment
63
+
64
+ - Lead value × expected leads > build cost + maintenance
65
+ - Consider SEO value
66
+ - Consider brand halo effect
67
+
68
+ ---
69
+
70
+ ## Tool Types
71
+
72
+ ### Calculators
73
+
74
+ **Best for**: Decisions involving numbers, comparisons, estimates
75
+
76
+ **Examples**:
77
+
78
+ - ROI calculator
79
+ - Savings calculator
80
+ - Cost comparison tool
81
+ - Salary calculator
82
+ - Tax estimator
83
+
84
+ **Why they work**:
85
+
86
+ - Personalized output
87
+ - High perceived value
88
+ - Share-worthy results
89
+ - Clear problem → solution
90
+
91
+ ### Generators
92
+
93
+ **Best for**: Creating something useful quickly
94
+
95
+ **Examples**:
96
+
97
+ - Policy generator
98
+ - Template generator
99
+ - Name/tagline generator
100
+ - Email subject line generator
101
+ - Resume builder
102
+
103
+ **Why they work**:
104
+
105
+ - Tangible output
106
+ - Saves time
107
+ - Easily shared
108
+ - Repeat usage
109
+
110
+ ### Analyzers/Auditors
111
+
112
+ **Best for**: Evaluating existing work or assets
113
+
114
+ **Examples**:
115
+
116
+ - Website grader
117
+ - SEO analyzer
118
+ - Email subject tester
119
+ - Headline analyzer
120
+ - Security checker
121
+
122
+ **Why they work**:
123
+
124
+ - Curiosity-driven
125
+ - Personalized insights
126
+ - Creates awareness of problems
127
+ - Natural lead to solution
128
+
129
+ ### Testers/Validators
130
+
131
+ **Best for**: Checking if something works
132
+
133
+ **Examples**:
134
+
135
+ - Meta tag preview
136
+ - Email rendering test
137
+ - Accessibility checker
138
+ - Mobile-friendly test
139
+ - Speed test
140
+
141
+ **Why they work**:
142
+
143
+ - Immediate utility
144
+ - Bookmark-worthy
145
+ - Repeat usage
146
+ - Professional necessity
147
+
148
+ ### Libraries/Resources
149
+
150
+ **Best for**: Reference material
151
+
152
+ **Examples**:
153
+
154
+ - Icon library
155
+ - Template library
156
+ - Code snippet library
157
+ - Example gallery
158
+ - Directory
159
+
160
+ **Why they work**:
161
+
162
+ - High SEO value
163
+ - Ongoing traffic
164
+ - Establishes authority
165
+ - Linkable asset
166
+
167
+ ### Interactive Educational
168
+
169
+ **Best for**: Learning/understanding
170
+
171
+ **Examples**:
172
+
173
+ - Interactive tutorials
174
+ - Code playgrounds
175
+ - Visual explainers
176
+ - Quizzes/assessments
177
+ - Simulators
178
+
179
+ **Why they work**:
180
+
181
+ - Engages deeply
182
+ - Demonstrates expertise
183
+ - Shareable
184
+ - Memory-creating
185
+
186
+ ---
187
+
188
+ ## Ideation Framework
189
+
190
+ ### Start with Pain Points
191
+
192
+ 1. **What problems does your audience Google?**
193
+ - Search query research
194
+ - Common questions
195
+ - "How to" searches
196
+
197
+ 2. **What manual processes are tedious?**
198
+ - Tasks done in spreadsheets
199
+ - Repetitive calculations
200
+ - Copy-paste workflows
201
+
202
+ 3. **What do they need before buying your product?**
203
+ - Assessments of current state
204
+ - Planning/scoping
205
+ - Comparisons
206
+
207
+ 4. **What information do they wish they had?**
208
+ - Data they can't easily access
209
+ - Personalized insights
210
+ - Industry benchmarks
211
+
212
+ ### Validate the Idea
213
+
214
+ **Search demand:**
215
+
216
+ - Is there search volume for this problem?
217
+ - What keywords would rank?
218
+ - How competitive?
219
+
220
+ **Uniqueness:**
221
+
222
+ - What exists already?
223
+ - How can you be 10x better or different?
224
+ - What's your unique angle?
225
+
226
+ **Lead quality:**
227
+
228
+ - Does this problem-audience match buyers?
229
+ - Will users be your target customers?
230
+ - Is there a natural path to your product?
231
+
232
+ **Build feasibility:**
233
+
234
+ - How complex to build?
235
+ - Can you scope an MVP?
236
+ - Ongoing maintenance burden?
237
+
238
+ ---
239
+
240
+ ## SEO Considerations
241
+
242
+ ### Keyword Strategy
243
+
244
+ **Tool landing page:**
245
+
246
+ - "[thing] calculator"
247
+ - "[thing] generator"
248
+ - "free [tool type]"
249
+ - "[industry] [tool type]"
250
+
251
+ **Supporting content:**
252
+
253
+ - "How to [use case]"
254
+ - "What is [concept tool helps with]"
255
+ - Blog posts that link to tool
256
+
257
+ ### Link Building
258
+
259
+ Free tools attract links because:
260
+
261
+ - Genuinely useful (people reference them)
262
+ - Unique (can't link to just any page)
263
+ - Shareable (social amplification)
264
+
265
+ **Outreach opportunities:**
266
+
267
+ - Roundup posts ("best free tools for X")
268
+ - Resource pages
269
+ - Industry publications
270
+ - Blogs writing about the problem
271
+
272
+ ### Technical SEO
273
+
274
+ - Fast load time critical
275
+ - Mobile-friendly essential
276
+ - Crawlable content (not just JS app)
277
+ - Proper meta tags
278
+ - Schema markup if applicable
279
+
280
+ ---
281
+
282
+ ## Lead Capture Strategy
283
+
284
+ ### When to Gate
285
+
286
+ **Fully gated (email required to use):**
287
+
288
+ - High-value, unique tools
289
+ - Personalized reports
290
+ - Risk: Lower usage
291
+
292
+ **Partially gated (email for full results):**
293
+
294
+ - Show preview, gate details
295
+ - Better balance
296
+ - Most common pattern
297
+
298
+ **Ungated with optional capture:**
299
+
300
+ - Tool is free to use
301
+ - Email to save/share results
302
+ - Highest usage, lower capture
303
+
304
+ **Ungated entirely:**
305
+
306
+ - Pure SEO/brand play
307
+ - No direct leads
308
+ - Maximum reach
309
+
310
+ ### Lead Capture Best Practices
311
+
312
+ - Value exchange clear: "Get your full report"
313
+ - Minimal friction: Email only
314
+ - Show preview of what they'll get
315
+ - Optional: Segment by asking one qualifying question
316
+
317
+ ### Post-Capture
318
+
319
+ - Immediate email with results/link
320
+ - Nurture sequence relevant to tool topic
321
+ - Clear path to main product
322
+ - Don't spam—provide value
323
+
324
+ ---
325
+
326
+ ## Build vs. Buy vs. Embed
327
+
328
+ ### Build Custom
329
+
330
+ **When:**
331
+
332
+ - Unique concept, nothing exists
333
+ - Core to brand/product
334
+ - High strategic value
335
+ - Have development capacity
336
+
337
+ **Consider:**
338
+
339
+ - Development time
340
+ - Ongoing maintenance
341
+ - Hosting costs
342
+ - Bug fixes
343
+
344
+ ### Use No-Code Tools
345
+
346
+ **Options:**
347
+
348
+ - Outgrow, Involve.me (calculators/quizzes)
349
+ - Typeform, Tally (forms/quizzes)
350
+ - Notion, Coda (databases)
351
+ - Bubble, Webflow (apps)
352
+
353
+ **When:**
354
+
355
+ - Speed to market
356
+ - Limited dev resources
357
+ - Testing concept viability
358
+
359
+ ### Embed Existing
360
+
361
+ **When:**
362
+
363
+ - Something good already exists
364
+ - White-label options available
365
+ - Not core differentiator
366
+
367
+ **Consider:**
368
+
369
+ - Branding limitations
370
+ - Dependency on third party
371
+ - Cost vs. build
372
+
373
+ ---
374
+
375
+ ## MVP Scope
376
+
377
+ ### Minimum Viable Tool
378
+
379
+ 1. **Core functionality only**
380
+ - Does the one thing
381
+ - No bells and whistles
382
+ - Works reliably
383
+
384
+ 2. **Essential UX**
385
+ - Clear input
386
+ - Obvious output
387
+ - Mobile works
388
+
389
+ 3. **Basic lead capture**
390
+ - Email collection works
391
+ - Leads go somewhere useful
392
+ - Follow-up exists
393
+
394
+ ### What to Skip Initially
395
+
396
+ - Account creation
397
+ - Saving results
398
+ - Advanced features
399
+ - Perfect design
400
+ - Every edge case
401
+
402
+ ### Iterate Based on Use
403
+
404
+ - Track where users drop off
405
+ - See what questions they have
406
+ - Add features that get requested
407
+ - Improve based on data
408
+
409
+ ---
410
+
411
+ ## Promotion Strategy
412
+
413
+ ### Launch
414
+
415
+ **Owned channels:**
416
+
417
+ - Email list announcement
418
+ - Blog post / landing page
419
+ - Social media
420
+ - Product hunt (if applicable)
421
+
422
+ **Outreach:**
423
+
424
+ - Relevant newsletters
425
+ - Industry publications
426
+ - Bloggers in space
427
+ - Social influencers
428
+
429
+ ### Ongoing
430
+
431
+ **SEO:**
432
+
433
+ - Target tool-related keywords
434
+ - Supporting content
435
+ - Link building
436
+
437
+ **Social:**
438
+
439
+ - Share interesting results (anonymized)
440
+ - Use case examples
441
+ - Tips for using the tool
442
+
443
+ **Product integration:**
444
+
445
+ - Mention in sales process
446
+ - Link from related product features
447
+ - Include in email sequences
448
+
449
+ ---
450
+
451
+ ## Measurement
452
+
453
+ ### Metrics to Track
454
+
455
+ **Acquisition:**
456
+
457
+ - Traffic to tool
458
+ - Traffic sources
459
+ - Keyword rankings
460
+ - Backlinks acquired
461
+
462
+ **Engagement:**
463
+
464
+ - Tool usage/completions
465
+ - Time spent
466
+ - Return visitors
467
+ - Shares
468
+
469
+ **Conversion:**
470
+
471
+ - Email captures
472
+ - Lead quality score
473
+ - MQLs generated
474
+ - Pipeline influenced
475
+ - Customers attributed
476
+
477
+ ### Attribution
478
+
479
+ - UTM parameters for paid promotion
480
+ - Separate landing page for organic
481
+ - Track lead source through funnel
482
+ - Survey new customers
483
+
484
+ ---
485
+
486
+ ## Evaluation Framework
487
+
488
+ ### Tool Idea Scorecard
489
+
490
+ Rate each factor 1-5:
491
+
492
+ | Factor | Score |
493
+ | ----------------------------- | ------ |
494
+ | Search demand exists | \_\_\_ |
495
+ | Audience match to buyers | \_\_\_ |
496
+ | Uniqueness vs. existing tools | \_\_\_ |
497
+ | Natural path to product | \_\_\_ |
498
+ | Build feasibility | \_\_\_ |
499
+ | Maintenance burden (inverse) | \_\_\_ |
500
+ | Link-building potential | \_\_\_ |
501
+ | Share-worthiness | \_\_\_ |
502
+
503
+ **25+**: Strong candidate
504
+ **15-24**: Promising, needs refinement
505
+ **<15**: Reconsider or scope differently
506
+
507
+ ### ROI Projection
508
+
509
+ ```
510
+ Estimated monthly leads: [X]
511
+ Lead-to-customer rate: [Y%]
512
+ Average customer value: [$Z]
513
+
514
+ Monthly value: X × Y% × $Z = $___
515
+
516
+ Build cost: $___
517
+ Monthly maintenance: $___
518
+
519
+ Payback period: Build cost / (Monthly value - Monthly maintenance)
520
+ ```
521
+
522
+ ---
523
+
524
+ ## Output Format
525
+
526
+ ### Tool Strategy Document
527
+
528
+ ```
529
+ # Free Tool Strategy: [Tool Name]
530
+
531
+ ## Concept
532
+ [What it does in one paragraph]
533
+
534
+ ## Target Audience
535
+ [Who uses it, what problem it solves]
536
+
537
+ ## Lead Generation Fit
538
+ [How this connects to your product/sales]
539
+
540
+ ## SEO Opportunity
541
+ - Target keywords: [list]
542
+ - Search volume: [estimate]
543
+ - Competition: [assessment]
544
+
545
+ ## Build Approach
546
+ - Custom / No-code / Embed
547
+ - MVP scope: [core features]
548
+ - Estimated effort: [time/cost]
549
+
550
+ ## Lead Capture Strategy
551
+ - Gating approach: [Full/Partial/Ungated]
552
+ - Capture mechanism: [description]
553
+ - Follow-up sequence: [outline]
554
+
555
+ ## Success Metrics
556
+ - [Metric 1]: [Target]
557
+ - [Metric 2]: [Target]
558
+
559
+ ## Promotion Plan
560
+ - Launch: [channels]
561
+ - Ongoing: [strategy]
562
+
563
+ ## Timeline
564
+ - Phase 1: [scope] - [timeframe]
565
+ - Phase 2: [scope] - [timeframe]
566
+ ```
567
+
568
+ ### Implementation Spec
569
+
570
+ If moving forward with build
571
+
572
+ ### Promotion Plan
573
+
574
+ Detailed launch and ongoing strategy
575
+
576
+ ---
577
+
578
+ ## Example Tool Concepts by Business Type
579
+
580
+ ### SaaS Product
581
+
582
+ - Product ROI calculator
583
+ - Competitor comparison tool
584
+ - Readiness assessment quiz
585
+ - Template library for use case
586
+
587
+ ### Agency/Services
588
+
589
+ - Industry benchmark tool
590
+ - Project scoping calculator
591
+ - Portfolio review tool
592
+ - Cost estimator
593
+
594
+ ### E-commerce
595
+
596
+ - Product finder quiz
597
+ - Comparison tool
598
+ - Size/fit calculator
599
+ - Savings calculator
600
+
601
+ ### Developer Tools
602
+
603
+ - Code snippet library
604
+ - Testing/preview tool
605
+ - Documentation generator
606
+ - Interactive tutorials
607
+
608
+ ### Finance
609
+
610
+ - Financial calculators
611
+ - Investment comparison
612
+ - Budget planner
613
+ - Tax estimator
614
+
615
+ ---
616
+
617
+ ## Questions to Ask
618
+
619
+ If you need more context:
620
+
621
+ 1. What's your core product/service?
622
+ 2. What problems does your audience commonly face?
623
+ 3. What existing tools do they use for workarounds?
624
+ 4. How do you currently generate leads?
625
+ 5. What technical resources are available?
626
+ 6. What's the timeline and budget?
627
+
628
+ ---
629
+
630
+ ## Related Skills
631
+
632
+ - **page-cro**: For optimizing the tool's landing page
633
+ - **seo-audit**: For SEO-optimizing the tool
634
+ - **analytics-tracking**: For measuring tool usage
635
+ - **email-sequence**: For nurturing leads from the tool
636
+ - **programmatic-seo**: For building tool-based pages at scale