@growthub/cli 0.7.0 → 0.7.2

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 (59) hide show
  1. package/assets/shared-templates/marketing-frameworks/competitor-positioning.md +46 -0
  2. package/assets/shared-templates/marketing-frameworks/cro-7-dimensions.md +48 -0
  3. package/assets/shared-templates/marketing-frameworks/email-sequence-architecture.md +50 -0
  4. package/assets/shared-templates/marketing-frameworks/launch-playbook.md +62 -0
  5. package/assets/shared-templates/marketing-frameworks/product-marketing-context.md +62 -0
  6. package/assets/shared-templates/marketing-frameworks/seo-audit-eeat.md +44 -0
  7. package/assets/worker-kits/growthub-hyperframes-studio-v1/.env.example +7 -0
  8. package/assets/worker-kits/growthub-hyperframes-studio-v1/QUICKSTART.md +21 -0
  9. package/assets/worker-kits/growthub-hyperframes-studio-v1/brands/NEW-CLIENT.md +3 -0
  10. package/assets/worker-kits/growthub-hyperframes-studio-v1/brands/_template/brand-kit.md +7 -0
  11. package/assets/worker-kits/growthub-hyperframes-studio-v1/brands/growthub/brand-kit.md +6 -0
  12. package/assets/worker-kits/growthub-hyperframes-studio-v1/bundles/growthub-hyperframes-studio-v1.json +47 -0
  13. package/assets/worker-kits/growthub-hyperframes-studio-v1/docs/hyperframes-discovery-path.md +12 -0
  14. package/assets/worker-kits/growthub-hyperframes-studio-v1/docs/hyperframes-fork-integration.md +11 -0
  15. package/assets/worker-kits/growthub-hyperframes-studio-v1/docs/provider-adapter-layer.md +9 -0
  16. package/assets/worker-kits/growthub-hyperframes-studio-v1/examples/video-brief-sample.md +15 -0
  17. package/assets/worker-kits/growthub-hyperframes-studio-v1/growthub-meta/README.md +3 -0
  18. package/assets/worker-kits/growthub-hyperframes-studio-v1/growthub-meta/kit-standard.md +6 -0
  19. package/assets/worker-kits/growthub-hyperframes-studio-v1/kit.json +97 -0
  20. package/assets/worker-kits/growthub-hyperframes-studio-v1/output/README.md +5 -0
  21. package/assets/worker-kits/growthub-hyperframes-studio-v1/output-standards.md +12 -0
  22. package/assets/worker-kits/growthub-hyperframes-studio-v1/runtime-assumptions.md +6 -0
  23. package/assets/worker-kits/growthub-hyperframes-studio-v1/setup/check-deps.sh +14 -0
  24. package/assets/worker-kits/growthub-hyperframes-studio-v1/setup/clone-fork.sh +12 -0
  25. package/assets/worker-kits/growthub-hyperframes-studio-v1/setup/verify-env.mjs +16 -0
  26. package/assets/worker-kits/growthub-hyperframes-studio-v1/skills.md +12 -0
  27. package/assets/worker-kits/growthub-hyperframes-studio-v1/templates/composition-spec.md +6 -0
  28. package/assets/worker-kits/growthub-hyperframes-studio-v1/templates/qa-checklist.md +6 -0
  29. package/assets/worker-kits/growthub-hyperframes-studio-v1/templates/render-plan.md +13 -0
  30. package/assets/worker-kits/growthub-hyperframes-studio-v1/templates/video-brief.md +7 -0
  31. package/assets/worker-kits/growthub-hyperframes-studio-v1/validation-checklist.md +6 -0
  32. package/assets/worker-kits/growthub-hyperframes-studio-v1/workers/hyperframes-studio-operator/CLAUDE.md +18 -0
  33. package/assets/worker-kits/growthub-marketing-skills-v1/.env.example +7 -0
  34. package/assets/worker-kits/growthub-marketing-skills-v1/QUICKSTART.md +111 -0
  35. package/assets/worker-kits/growthub-marketing-skills-v1/brands/_template/product-marketing-context.md +147 -0
  36. package/assets/worker-kits/growthub-marketing-skills-v1/brands/growthub/product-marketing-context.md +145 -0
  37. package/assets/worker-kits/growthub-marketing-skills-v1/bundles/growthub-marketing-skills-v1.json +43 -0
  38. package/assets/worker-kits/growthub-marketing-skills-v1/docs/evaluation-frameworks.md +53 -0
  39. package/assets/worker-kits/growthub-marketing-skills-v1/docs/fork-integration.md +43 -0
  40. package/assets/worker-kits/growthub-marketing-skills-v1/docs/skill-dispatch-methodology.md +50 -0
  41. package/assets/worker-kits/growthub-marketing-skills-v1/examples/email-sequence-sample.md +75 -0
  42. package/assets/worker-kits/growthub-marketing-skills-v1/examples/landing-page-cro-sample.md +128 -0
  43. package/assets/worker-kits/growthub-marketing-skills-v1/examples/seo-audit-sample.md +102 -0
  44. package/assets/worker-kits/growthub-marketing-skills-v1/growthub-meta/README.md +5 -0
  45. package/assets/worker-kits/growthub-marketing-skills-v1/growthub-meta/kit-standard.md +25 -0
  46. package/assets/worker-kits/growthub-marketing-skills-v1/kit.json +87 -0
  47. package/assets/worker-kits/growthub-marketing-skills-v1/output/README.md +32 -0
  48. package/assets/worker-kits/growthub-marketing-skills-v1/output-standards.md +51 -0
  49. package/assets/worker-kits/growthub-marketing-skills-v1/runtime-assumptions.md +46 -0
  50. package/assets/worker-kits/growthub-marketing-skills-v1/setup/verify-env.mjs +81 -0
  51. package/assets/worker-kits/growthub-marketing-skills-v1/skills.md +157 -0
  52. package/assets/worker-kits/growthub-marketing-skills-v1/templates/competitor-analysis.md +81 -0
  53. package/assets/worker-kits/growthub-marketing-skills-v1/templates/content-strategy-plan.md +75 -0
  54. package/assets/worker-kits/growthub-marketing-skills-v1/templates/cro-audit-brief.md +138 -0
  55. package/assets/worker-kits/growthub-marketing-skills-v1/templates/email-sequence-plan.md +80 -0
  56. package/assets/worker-kits/growthub-marketing-skills-v1/templates/launch-checklist.md +83 -0
  57. package/assets/worker-kits/growthub-marketing-skills-v1/templates/seo-audit-report.md +119 -0
  58. package/assets/worker-kits/growthub-marketing-skills-v1/workers/marketing-operator/CLAUDE.md +198 -0
  59. package/package.json +1 -1
@@ -0,0 +1,12 @@
1
+ # Hyperframes Studio Skills
2
+
3
+ 1. Read `runtime-assumptions.md`.
4
+ 2. Read `docs/hyperframes-fork-integration.md`.
5
+ 3. Confirm target format: duration, ratio, channel.
6
+ 4. Produce:
7
+ - `templates/video-brief.md`
8
+ - `templates/composition-spec.md`
9
+ - `templates/render-plan.md`
10
+ - `templates/qa-checklist.md`
11
+
12
+ Use deterministic command paths and avoid exposing secrets.
@@ -0,0 +1,6 @@
1
+ # Composition Spec
2
+
3
+ - Composition ID:
4
+ - Timeline:
5
+ - Scene breakdown:
6
+ - Asset inputs:
@@ -0,0 +1,6 @@
1
+ # QA Checklist
2
+
3
+ - [ ] Duration matches brief
4
+ - [ ] Aspect ratio correct
5
+ - [ ] Captions readable
6
+ - [ ] Audio sync verified
@@ -0,0 +1,13 @@
1
+ # Render Plan
2
+
3
+ ## Commands
4
+
5
+ ```bash
6
+ npx hyperframes preview
7
+ npx hyperframes render
8
+ ```
9
+
10
+ ## Checks
11
+
12
+ - Ensure deterministic assets
13
+ - Record output path
@@ -0,0 +1,7 @@
1
+ # Video Brief
2
+
3
+ - Goal:
4
+ - Audience:
5
+ - Duration:
6
+ - Aspect ratio:
7
+ - Delivery format:
@@ -0,0 +1,6 @@
1
+ # Validation Checklist
2
+
3
+ - [ ] `node setup/verify-env.mjs`
4
+ - [ ] `bash setup/check-deps.sh`
5
+ - [ ] `bash setup/clone-fork.sh`
6
+ - [ ] All required output artifacts written
@@ -0,0 +1,18 @@
1
+ # Hyperframes Studio Operator
2
+
3
+ **Kit:** `growthub-hyperframes-studio-v1`
4
+ **Worker ID:** `hyperframes-studio-operator`
5
+ **Version:** `1.0.0`
6
+
7
+ ## Role
8
+
9
+ You convert campaign goals into implementation-ready Hyperframes composition and render artifacts.
10
+
11
+ ## Required startup
12
+
13
+ 1. Read `skills.md`.
14
+ 2. Read `runtime-assumptions.md`.
15
+ 3. Read `docs/hyperframes-fork-integration.md`.
16
+ 4. Verify environment with `node setup/verify-env.mjs`.
17
+
18
+ If setup checks fail, stop and return remediation only.
@@ -0,0 +1,7 @@
1
+ # Growthub Marketing Skills — Environment Config
2
+ # Copy this file to .env and fill in keys as needed.
3
+ # Never commit .env to version control.
4
+
5
+ # Optional model/provider keys for enhanced research and generation.
6
+ ANTHROPIC_API_KEY=your_anthropic_key_here
7
+ OPENAI_API_KEY=your_openai_key_here
@@ -0,0 +1,111 @@
1
+ # Growthub Marketing Operator — Quickstart
2
+
3
+ **Kit:** `growthub-marketing-skills-v1`
4
+ **Worker:** `marketing-operator`
5
+ **Upstream:** [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills)
6
+
7
+ ---
8
+
9
+ ## What This Kit Does
10
+
11
+ The Growthub Marketing Operator is a self-contained AI agent environment for executing structured marketing workflows. It wraps proven frameworks from the open-source marketingskills library into a Growthub worker kit with brand context, templates, and output standards.
12
+
13
+ Domains covered:
14
+ - **CRO** — Landing page, signup flow, form, popup, paywall, and onboarding optimization
15
+ - **SEO** — Technical audit, on-page, content quality, AI search visibility, schema markup
16
+ - **Content** — Strategy, editorial planning, distribution, pillar mapping
17
+ - **Email** — Welcome, nurture, re-engagement, cold outbound, event-based sequences
18
+ - **Launch** — Pre-launch, launch day, post-launch phased playbooks
19
+ - **Competitive** — Positioning gap analysis, feature matrices, messaging teardowns
20
+ - **Growth** — Marketing ideas, pricing, referrals, free tools, churn prevention
21
+ - **Copy** — Landing pages, ads, email, social — grounded in brand voice
22
+
23
+ ---
24
+
25
+ ## Setup — 4 Steps
26
+
27
+ ### Step 1 — Point Your Working Directory
28
+
29
+ Export this kit to a local folder and point your AI agent's Working Directory at the kit root. All paths are relative to the kit root.
30
+
31
+ ### Step 2 — Copy the Environment File
32
+
33
+ ```bash
34
+ cp .env.example .env
35
+ ```
36
+
37
+ No API keys are required for core analysis. The operator works with any AI agent that can read markdown files.
38
+
39
+ ### Step 3 — Verify the Environment
40
+
41
+ ```bash
42
+ node setup/verify-env.mjs
43
+ ```
44
+
45
+ This confirms the kit structure is intact and all required files are present.
46
+
47
+ ### Step 4 — Set Up Your Product Context
48
+
49
+ Copy the template and fill it in:
50
+
51
+ ```bash
52
+ cp brands/_template/product-marketing-context.md brands/<your-company>/product-marketing-context.md
53
+ ```
54
+
55
+ This is the single most important step. The product-marketing context grounds every deliverable in your specific product, audience, and positioning. Without it, the operator produces generic marketing advice instead of actionable recommendations.
56
+
57
+ ---
58
+
59
+ ## First Run
60
+
61
+ 1. Tell the operator: **"Run a CRO audit on [your landing page URL]"** or any marketing task
62
+ 2. The operator reads your product-marketing context for brand grounding
63
+ 3. The operator identifies the marketing domain and asks 3 clarifying questions
64
+ 4. The operator applies the appropriate framework and produces structured deliverables
65
+ 5. Output is saved to `output/<client-slug>/<project-slug>/`
66
+
67
+ ---
68
+
69
+ ## New Client Setup
70
+
71
+ ```bash
72
+ cp brands/_template/product-marketing-context.md brands/<client-slug>/product-marketing-context.md
73
+ # Fill in the 12 sections in the new file
74
+ ```
75
+
76
+ The 12 sections: Product Overview, Target Audience, Personas, Problems & Pain Points, Competitive Landscape, Differentiation, Objections, Switching Dynamics, Customer Language, Brand Voice, Proof Points, Goals.
77
+
78
+ ---
79
+
80
+ ## Available Domains
81
+
82
+ Tell the operator which marketing domain you need:
83
+
84
+ | Domain | Example Request |
85
+ |---|---|
86
+ | CRO | "Audit this landing page for conversions" |
87
+ | SEO | "Run an SEO audit on my site" |
88
+ | Content | "Build a content strategy for my blog" |
89
+ | Email | "Design a welcome email sequence" |
90
+ | Launch | "Create a launch checklist for my new feature" |
91
+ | Competitive | "Analyze my top 3 competitors" |
92
+ | Copy | "Write homepage copy for my SaaS" |
93
+ | Growth | "Give me 10 marketing ideas for my startup" |
94
+
95
+ The operator will map your request to the correct framework and template automatically.
96
+
97
+ ---
98
+
99
+ ## Key Files
100
+
101
+ | File | Purpose |
102
+ |---|---|
103
+ | `workers/marketing-operator/CLAUDE.md` | Agent operating instructions (start here) |
104
+ | `skills.md` | Full methodology and skill dispatch table |
105
+ | `brands/_template/product-marketing-context.md` | Blank product context template |
106
+ | `brands/growthub/product-marketing-context.md` | Growthub reference example |
107
+ | `templates/` | Frozen deliverable templates per domain |
108
+ | `output/README.md` | Output directory structure and naming |
109
+ | `docs/fork-integration.md` | How this kit relates to marketingskills |
110
+ | `docs/skill-dispatch-methodology.md` | How skill routing works |
111
+ | `docs/evaluation-frameworks.md` | Scoring and evaluation criteria |
@@ -0,0 +1,147 @@
1
+ # Product Marketing Context — [Company Name]
2
+
3
+ > This file is the foundation for every marketing deliverable the operator produces. Fill in each section with real data — the more specific, the better the output. Use customer language, not polished marketing copy.
4
+
5
+ ---
6
+
7
+ ## 1. Product Overview
8
+
9
+ | Field | Value |
10
+ |---|---|
11
+ | Product name | |
12
+ | One-liner | |
13
+ | Category | |
14
+ | Product type | SaaS / Physical / Service / Marketplace / Other |
15
+ | Pricing model | Free / Freemium / Subscription / One-time / Usage-based |
16
+ | Starting price | |
17
+ | Website | |
18
+
19
+ ---
20
+
21
+ ## 2. Target Audience
22
+
23
+ | Field | Value |
24
+ |---|---|
25
+ | Company type | B2B / B2C / B2B2C |
26
+ | Company size | |
27
+ | Industry verticals | |
28
+ | Decision-maker titles | |
29
+ | Primary use case | |
30
+ | Secondary use cases | |
31
+
32
+ ---
33
+
34
+ ## 3. Personas
35
+
36
+ | Persona | Role | Key Motivation | Primary Objection |
37
+ |---|---|---|---|
38
+ | | | | |
39
+ | | | | |
40
+
41
+ ---
42
+
43
+ ## 4. Problems & Pain Points
44
+
45
+ 1. **Core problem**:
46
+ 2. **Cost of inaction**:
47
+ 3. **Emotional tension**:
48
+ 4. **Failed alternatives**:
49
+
50
+ ---
51
+
52
+ ## 5. Competitive Landscape
53
+
54
+ | Competitor | Type | Key Difference |
55
+ |---|---|---|
56
+ | | Direct | |
57
+ | | Direct | |
58
+ | | Indirect | |
59
+
60
+ ---
61
+
62
+ ## 6. Differentiation
63
+
64
+ - **Key differentiator 1**:
65
+ - **Key differentiator 2**:
66
+ - **Key differentiator 3**:
67
+ - **Why customers choose you over alternatives**:
68
+
69
+ ---
70
+
71
+ ## 7. Objections & Anti-Personas
72
+
73
+ **Common objections:**
74
+ 1.
75
+ 2.
76
+ 3.
77
+
78
+ **Anti-personas** (who is NOT the right customer):
79
+ -
80
+
81
+ ---
82
+
83
+ ## 8. Switching Dynamics
84
+
85
+ | Force | Description |
86
+ |---|---|
87
+ | Push (away from status quo) | |
88
+ | Pull (toward your product) | |
89
+ | Habit (keeps them where they are) | |
90
+ | Anxiety (fear of switching) | |
91
+
92
+ ---
93
+
94
+ ## 9. Customer Language
95
+
96
+ > Paste verbatim phrases from customer interviews, reviews, support tickets, or sales calls. These are more valuable than any polished positioning statement.
97
+
98
+ - ""
99
+ - ""
100
+ - ""
101
+
102
+ ---
103
+
104
+ ## 10. Brand Voice
105
+
106
+ | Attribute | Value |
107
+ |---|---|
108
+ | Tone | |
109
+ | Style | |
110
+ | Personality | |
111
+ | Words we use | |
112
+ | Words we avoid | |
113
+
114
+ ---
115
+
116
+ ## 11. Proof Points
117
+
118
+ | Type | Detail |
119
+ |---|---|
120
+ | Key metric | |
121
+ | Testimonial | |
122
+ | Case study | |
123
+ | Award/recognition | |
124
+
125
+ ---
126
+
127
+ ## 12. Goals
128
+
129
+ | Goal | Metric | Target |
130
+ |---|---|---|
131
+ | Primary conversion action | | |
132
+ | Secondary goal | | |
133
+ | Revenue target | | |
134
+
135
+ ---
136
+
137
+ ## Messaging Guardrails
138
+
139
+ - Never claim:
140
+ - Always include:
141
+ - Compliance notes:
142
+
143
+ ---
144
+
145
+ ## Deliverables Log
146
+
147
+ <!-- Append a line after every operator session -->
@@ -0,0 +1,145 @@
1
+ # Product Marketing Context — Growthub
2
+
3
+ ---
4
+
5
+ ## 1. Product Overview
6
+
7
+ | Field | Value |
8
+ |---|---|
9
+ | Product name | Growthub |
10
+ | One-liner | Local-first AI agent runtime for go-to-market and developer experience teams |
11
+ | Category | AI Development Tools / GTM Infrastructure |
12
+ | Product type | SaaS + Open Source CLI |
13
+ | Pricing model | Freemium (open-source CLI + hosted features) |
14
+ | Starting price | Free (CLI), hosted plans TBD |
15
+ | Website | growthub.ai |
16
+
17
+ ---
18
+
19
+ ## 2. Target Audience
20
+
21
+ | Field | Value |
22
+ |---|---|
23
+ | Company type | B2B |
24
+ | Company size | Startups to mid-market (5-200 employees) |
25
+ | Industry verticals | SaaS, Developer Tools, Marketing Technology |
26
+ | Decision-maker titles | Founders, Growth Leads, Marketing Directors, DevRel Leads |
27
+ | Primary use case | Run AI agent worker kits locally for marketing and growth execution |
28
+ | Secondary use cases | Content production pipelines, SEO auditing, email marketing automation |
29
+
30
+ ---
31
+
32
+ ## 3. Personas
33
+
34
+ | Persona | Role | Key Motivation | Primary Objection |
35
+ |---|---|---|---|
36
+ | Solo Founder | CEO / Founder | Ship marketing without hiring an agency | "I don't have time to learn another tool" |
37
+ | Growth Operator | Growth / Marketing Lead | Scale output without scaling headcount | "How is this different from ChatGPT?" |
38
+ | Developer Advocate | DevRel / DX Engineer | Build agent-native workflows for the team | "Does it work with my existing stack?" |
39
+
40
+ ---
41
+
42
+ ## 4. Problems & Pain Points
43
+
44
+ 1. **Core problem**: Marketing execution doesn't scale — founders and small teams can't produce enough high-quality marketing output
45
+ 2. **Cost of inaction**: Slower growth, missed launch windows, inconsistent brand messaging across channels
46
+ 3. **Emotional tension**: Knowing what needs to be done but not having the bandwidth to do it well
47
+ 4. **Failed alternatives**: Generic AI chatbots produce disconnected, off-brand output that needs heavy editing
48
+
49
+ ---
50
+
51
+ ## 5. Competitive Landscape
52
+
53
+ | Competitor | Type | Key Difference |
54
+ |---|---|---|
55
+ | ChatGPT / Claude (raw) | Indirect | No environment context, no brand grounding, no output standards |
56
+ | Jasper / Copy.ai | Direct | Cloud-only, template-driven, no local execution or agent orchestration |
57
+ | Generic prompt libraries | Indirect | No structure, no brand context, no quality bar enforcement |
58
+
59
+ ---
60
+
61
+ ## 6. Differentiation
62
+
63
+ - **Key differentiator 1**: Local-first execution — your data stays on your machine
64
+ - **Key differentiator 2**: Environment packaging — kits bundle prompts, templates, brand context, and output standards into one exportable unit
65
+ - **Key differentiator 3**: Agent-agnostic — works with Claude Code, Cursor, Codex, Gemini, any local adapter
66
+ - **Why customers choose you over alternatives**: Repeatable agent performance from structured environments, not scattered prompts
67
+
68
+ ---
69
+
70
+ ## 7. Objections & Anti-Personas
71
+
72
+ **Common objections:**
73
+ 1. "I can just use ChatGPT for this" — You can, but without brand context and output standards, you'll spend more time editing than creating
74
+ 2. "This seems complex to set up" — One command to download a kit, point your agent at it, and start producing
75
+ 3. "What if I don't use Claude Code?" — Kits work with any agent that reads markdown — Cursor, Codex, Gemini, etc.
76
+
77
+ **Anti-personas:**
78
+ - Enterprise teams with existing full-service agencies and no interest in AI-assisted execution
79
+ - Users who want a click-and-generate web app, not a local development environment
80
+
81
+ ---
82
+
83
+ ## 8. Switching Dynamics
84
+
85
+ | Force | Description |
86
+ |---|---|
87
+ | Push | Frustration with generic AI output that doesn't match brand voice |
88
+ | Pull | Structured environments that produce consistent, on-brand deliverables |
89
+ | Habit | "I've been getting by with ChatGPT and manual editing" |
90
+ | Anxiety | "Will this actually save time or just add another tool to learn?" |
91
+
92
+ ---
93
+
94
+ ## 9. Customer Language
95
+
96
+ - "I need something that understands my product, not just generates generic marketing copy"
97
+ - "We can't afford an agency but we need agency-quality output"
98
+ - "I want to set it up once and have it produce consistent results every time"
99
+ - "ChatGPT gives me a starting point but I spend 80% of the time editing"
100
+
101
+ ---
102
+
103
+ ## 10. Brand Voice
104
+
105
+ | Attribute | Value |
106
+ |---|---|
107
+ | Tone | Direct, technical, confident without being arrogant |
108
+ | Style | Concise — say more with fewer words |
109
+ | Personality | Builder-first, practical, results-oriented |
110
+ | Words we use | Ship, execute, build, operator, environment, local-first |
111
+ | Words we avoid | Revolutionary, game-changing, disruptive, synergy, leverage |
112
+
113
+ ---
114
+
115
+ ## 11. Proof Points
116
+
117
+ | Type | Detail |
118
+ |---|---|
119
+ | Key metric | 4 production worker kits shipped and publicly available |
120
+ | Open source | CLI is MIT-licensed and published on npm |
121
+ | Ecosystem | Works with 5+ AI agent platforms out of the box |
122
+
123
+ ---
124
+
125
+ ## 12. Goals
126
+
127
+ | Goal | Metric | Target |
128
+ |---|---|---|
129
+ | Primary conversion action | CLI install (`npx @growthub/create-growthub-local`) | Growth in weekly installs |
130
+ | Secondary goal | Kit downloads via discovery hub | Active kit exports per week |
131
+ | Awareness | GitHub stars and contributor PRs | Community growth |
132
+
133
+ ---
134
+
135
+ ## Messaging Guardrails
136
+
137
+ - Never claim specific revenue or ROI numbers without sourced data
138
+ - Always position as "local-first" — never suggest data leaves the user's machine unless they opt into hosted features
139
+ - Compliance notes: No testimonials that aren't from real users
140
+
141
+ ---
142
+
143
+ ## Deliverables Log
144
+
145
+ <!-- Append a line after every operator session -->
@@ -0,0 +1,43 @@
1
+ {
2
+ "schemaVersion": 2,
3
+ "bundle": {
4
+ "id": "growthub-marketing-skills-v1",
5
+ "version": "1.0.0",
6
+ "kitId": "growthub-marketing-skills-v1",
7
+ "workerId": "marketing-operator"
8
+ },
9
+ "briefType": "marketing-operator",
10
+ "publicExampleBrandPaths": ["brands/growthub/product-marketing-context.md"],
11
+ "requiredFrozenAssets": [
12
+ "QUICKSTART.md",
13
+ ".env.example",
14
+ "skills.md",
15
+ "output-standards.md",
16
+ "runtime-assumptions.md",
17
+ "workers/marketing-operator/CLAUDE.md",
18
+ "brands/_template/product-marketing-context.md",
19
+ "brands/growthub/product-marketing-context.md",
20
+ "templates/cro-audit-brief.md",
21
+ "templates/seo-audit-report.md",
22
+ "templates/content-strategy-plan.md",
23
+ "templates/email-sequence-plan.md",
24
+ "templates/launch-checklist.md",
25
+ "templates/competitor-analysis.md",
26
+ "examples/landing-page-cro-sample.md",
27
+ "examples/seo-audit-sample.md",
28
+ "examples/email-sequence-sample.md",
29
+ "docs/fork-integration.md",
30
+ "docs/skill-dispatch-methodology.md",
31
+ "docs/evaluation-frameworks.md",
32
+ "setup/verify-env.mjs",
33
+ "output/README.md",
34
+ "growthub-meta/README.md",
35
+ "growthub-meta/kit-standard.md"
36
+ ],
37
+ "optionalPresets": [],
38
+ "export": {
39
+ "folderName": "growthub-agent-worker-kit-marketing-skills-v1",
40
+ "zipFileName": "growthub-agent-worker-kit-marketing-skills-v1.zip"
41
+ },
42
+ "activationModes": ["export"]
43
+ }
@@ -0,0 +1,53 @@
1
+ # Evaluation Frameworks
2
+
3
+ ## Frameworks by Domain
4
+
5
+ ### CRO — 7-Dimension Analysis
6
+
7
+ Scoring: 0-3 per dimension, 0-21 composite.
8
+
9
+ | Dimension | What It Measures |
10
+ |---|---|
11
+ | Value Proposition Clarity | Can users understand the offer within 5 seconds? |
12
+ | Headline Effectiveness | Does headline match traffic source and promise a benefit? |
13
+ | CTA Placement & Copy | Single primary action, benefit-driven, visible without scroll? |
14
+ | Visual Hierarchy | Scannable layout, intentional whitespace, eye flow? |
15
+ | Trust Signals | Logos, testimonials, reviews near decision points? |
16
+ | Objection Handling | Price, fit, difficulty, risk addressed before CTA? |
17
+ | Friction Points | Form fields, navigation, mobile experience? |
18
+
19
+ ### SEO — Priority Matrix
20
+
21
+ | Priority | Criteria |
22
+ |---|---|
23
+ | Critical | Blocking indexation or causing ranking penalties |
24
+ | High | Significant ranking impact, moderate fix effort |
25
+ | Medium | Incremental improvement, low-moderate effort |
26
+ | Low | Nice-to-have, minimal ranking impact |
27
+
28
+ ### SEO — E-E-A-T Assessment
29
+
30
+ | Signal | What It Measures |
31
+ |---|---|
32
+ | Experience | First-hand experience signals in content |
33
+ | Expertise | Depth, accuracy, and domain knowledge |
34
+ | Authoritativeness | Source credibility and external recognition |
35
+ | Trustworthiness | Accuracy, transparency, and safety signals |
36
+
37
+ ### Email — Sequence Quality Principles
38
+
39
+ 1. **One email, one job** — each message has a single purpose and CTA
40
+ 2. **Value before ask** — trust-building precedes conversion requests
41
+ 3. **Relevance over volume** — quality messaging outperforms frequency
42
+
43
+ ### Content — Gap Analysis Matrix
44
+
45
+ | Axis | Categories |
46
+ |---|---|
47
+ | Funnel stage | Awareness / Consideration / Decision |
48
+ | Content type | Blog / Guide / Tool / Case study / Comparison |
49
+ | Competitor coverage | Covered / Gap / Opportunity |
50
+
51
+ ## Source Attribution
52
+
53
+ These frameworks are adapted from [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills) (MIT license). The upstream library provides the detailed skill definitions; this document summarizes the evaluation criteria used by the operator.
@@ -0,0 +1,43 @@
1
+ # Fork Integration — marketingskills
2
+
3
+ ## Upstream Repository
4
+
5
+ - **Source**: [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills)
6
+ - **License**: MIT
7
+ - **Stars**: 21k+
8
+ - **Skills**: 40+ marketing skill definitions
9
+
10
+ ## Relationship to This Kit
11
+
12
+ This worker kit wraps the marketingskills library's frameworks and evaluation methodologies into a Growthub operator kit. The upstream library is a **reference**, not a runtime dependency.
13
+
14
+ ### What we took from the upstream:
15
+ - Marketing domain taxonomy (CRO, SEO, Content, Email, Growth, etc.)
16
+ - Evaluation frameworks (7-dimension CRO, E-E-A-T SEO, sequence architecture)
17
+ - Cross-skill chaining patterns (which skills reference which)
18
+ - Product-marketing-context as the foundational grounding document
19
+
20
+ ### What we added:
21
+ - **Product-marketing context as brand kit** — the upstream's context file becomes our brand kit template with 12 structured sections
22
+ - **Frozen deliverable templates** — structured output templates for each domain
23
+ - **Operator workflow** — 7-step strict-order workflow with mandatory gates
24
+ - **Output standards** — file naming, versioning, quality checklist
25
+ - **Growthub examples** — reference deliverables using Growthub's own product context
26
+ - **Kit packaging** — schemaVersion 2 manifest, bundle, activation modes
27
+
28
+ ### What we intentionally left out:
29
+ - **Individual skill files** — skills are one dimension of the environment, not the centerpiece. The operator's skills.md consolidates all 40+ skills into a dispatch table and framework summaries. Users who want the full individual skill files can install them from the upstream repo alongside this kit.
30
+ - **Tool integrations** — the upstream includes tool-specific integrations (GA4, Stripe, Mailchimp MCP). These are optional and not frozen into this kit. Users add them via their agent's tool configuration.
31
+ - **Installation scripts** — the upstream's `npx skills add` flow is for standalone skill installation. This kit uses the Growthub kit export flow instead.
32
+
33
+ ## Updating from Upstream
34
+
35
+ When the upstream library releases new skills or framework updates:
36
+
37
+ 1. Review the upstream changelog
38
+ 2. Update `skills.md` dispatch table if new skills are added
39
+ 3. Update framework summaries if evaluation criteria change
40
+ 4. Add new templates if new domains are introduced
41
+ 5. Bump the kit version in `kit.json`
42
+
43
+ The upstream library evolves independently. This kit freezes a specific set of frameworks at a point in time. Not every upstream change needs to be pulled in.
@@ -0,0 +1,50 @@
1
+ # Skill Dispatch Methodology
2
+
3
+ ## How the Operator Routes User Intent
4
+
5
+ The marketing operator uses a two-phase routing system:
6
+
7
+ ### Phase 1 — Domain Detection
8
+
9
+ The operator scans the user's request for trigger signals and maps to a primary marketing domain:
10
+
11
+ | Signal Pattern | Domain |
12
+ |---|---|
13
+ | "conversions", "landing page", "bounce rate", "CRO", URL shared | CRO |
14
+ | "rankings", "traffic", "SEO", "organic", "indexing" | SEO |
15
+ | "content strategy", "blog", "editorial", "pillars" | Content |
16
+ | "email", "sequence", "nurture", "cold outbound" | Email |
17
+ | "launch", "go-to-market", "GTM", "product launch" | Launch |
18
+ | "competitors", "alternatives", "positioning" | Competitive |
19
+ | "write copy", "headline", "ad copy" | Copy |
20
+ | "growth ideas", "referral", "pricing", "churn" | Growth |
21
+
22
+ When signals are ambiguous or span multiple domains, the 3-question gate resolves the primary domain.
23
+
24
+ ### Phase 2 — Framework Selection
25
+
26
+ Once the domain is identified, the operator loads the appropriate template and framework from `templates/`. Each framework defines:
27
+
28
+ 1. **Evaluation dimensions** — what to assess
29
+ 2. **Scoring criteria** — how to rate findings (where applicable)
30
+ 3. **Output structure** — required sections in the deliverable
31
+ 4. **Cross-references** — when to chain to another domain
32
+
33
+ ## Cross-Domain Chaining
34
+
35
+ Skills are interconnected. The operator follows upstream-to-downstream ordering:
36
+
37
+ ```
38
+ customer-research → content-strategy → copywriting
39
+ competitor-analysis → pricing-strategy → launch-strategy
40
+ seo-audit → content-strategy → programmatic-seo
41
+ page-cro → copywriting → ab-test-setup
42
+ ```
43
+
44
+ Each domain in the chain produces its own deliverable. Outputs are never merged across domains.
45
+
46
+ ## Relationship to Upstream Skills
47
+
48
+ The dispatch table maps to 36+ skills from [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills). The operator consolidates these into 8 primary domains with framework summaries rather than loading individual skill files. This keeps the cognitive load manageable while preserving the evaluation rigor of the underlying frameworks.
49
+
50
+ Users who want deeper skill-level granularity can install the upstream skills alongside this kit. The operator's dispatch table documents which upstream skill maps to which domain.