@miranda0808/maya-claude 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.
- package/README.md +30 -0
- package/bin/maya-claude.js +36 -0
- package/package.json +19 -0
- package/payload/.agents/skills/ab-test-setup/SKILL.md +266 -0
- package/payload/.agents/skills/ab-test-setup/evals/evals.json +105 -0
- package/payload/.agents/skills/ab-test-setup/references/sample-size-guide.md +263 -0
- package/payload/.agents/skills/ab-test-setup/references/test-templates.md +277 -0
- package/payload/.agents/skills/ad-creative/SKILL.md +362 -0
- package/payload/.agents/skills/ad-creative/evals/evals.json +90 -0
- package/payload/.agents/skills/ad-creative/references/generative-tools.md +637 -0
- package/payload/.agents/skills/ad-creative/references/platform-specs.md +213 -0
- package/payload/.agents/skills/ai-seo/SKILL.md +398 -0
- package/payload/.agents/skills/ai-seo/evals/evals.json +90 -0
- package/payload/.agents/skills/ai-seo/references/content-patterns.md +285 -0
- package/payload/.agents/skills/ai-seo/references/platform-ranking-factors.md +152 -0
- package/payload/.agents/skills/analytics-tracking/SKILL.md +309 -0
- package/payload/.agents/skills/analytics-tracking/evals/evals.json +90 -0
- package/payload/.agents/skills/analytics-tracking/references/event-library.md +260 -0
- package/payload/.agents/skills/analytics-tracking/references/ga4-implementation.md +300 -0
- package/payload/.agents/skills/analytics-tracking/references/gtm-implementation.md +390 -0
- package/payload/.agents/skills/churn-prevention/SKILL.md +424 -0
- package/payload/.agents/skills/churn-prevention/evals/evals.json +93 -0
- package/payload/.agents/skills/churn-prevention/references/cancel-flow-patterns.md +316 -0
- package/payload/.agents/skills/churn-prevention/references/dunning-playbook.md +408 -0
- package/payload/.agents/skills/cold-email/SKILL.md +158 -0
- package/payload/.agents/skills/cold-email/evals/evals.json +94 -0
- package/payload/.agents/skills/cold-email/references/benchmarks.md +83 -0
- package/payload/.agents/skills/cold-email/references/follow-up-sequences.md +81 -0
- package/payload/.agents/skills/cold-email/references/frameworks.md +90 -0
- package/payload/.agents/skills/cold-email/references/personalization.md +79 -0
- package/payload/.agents/skills/cold-email/references/subject-lines.md +53 -0
- package/payload/.agents/skills/competitor-alternatives/SKILL.md +256 -0
- package/payload/.agents/skills/competitor-alternatives/evals/evals.json +93 -0
- package/payload/.agents/skills/competitor-alternatives/references/content-architecture.md +271 -0
- package/payload/.agents/skills/competitor-alternatives/references/templates.md +223 -0
- package/payload/.agents/skills/content-strategy/SKILL.md +359 -0
- package/payload/.agents/skills/content-strategy/evals/evals.json +90 -0
- package/payload/.agents/skills/copy-editing/SKILL.md +447 -0
- package/payload/.agents/skills/copy-editing/evals/evals.json +89 -0
- package/payload/.agents/skills/copy-editing/references/plain-english-alternatives.md +394 -0
- package/payload/.agents/skills/copywriting/SKILL.md +252 -0
- package/payload/.agents/skills/copywriting/evals/evals.json +111 -0
- package/payload/.agents/skills/copywriting/references/copy-frameworks.md +344 -0
- package/payload/.agents/skills/copywriting/references/natural-transitions.md +272 -0
- package/payload/.agents/skills/email-sequence/SKILL.md +309 -0
- package/payload/.agents/skills/email-sequence/evals/evals.json +93 -0
- package/payload/.agents/skills/email-sequence/references/copy-guidelines.md +113 -0
- package/payload/.agents/skills/email-sequence/references/email-types.md +515 -0
- package/payload/.agents/skills/email-sequence/references/sequence-templates.md +168 -0
- package/payload/.agents/skills/form-cro/SKILL.md +429 -0
- package/payload/.agents/skills/form-cro/evals/evals.json +90 -0
- package/payload/.agents/skills/free-tool-strategy/SKILL.md +178 -0
- package/payload/.agents/skills/free-tool-strategy/evals/evals.json +90 -0
- package/payload/.agents/skills/free-tool-strategy/references/tool-types.md +217 -0
- package/payload/.agents/skills/launch-strategy/SKILL.md +353 -0
- package/payload/.agents/skills/launch-strategy/evals/evals.json +91 -0
- package/payload/.agents/skills/marketing-ideas/SKILL.md +167 -0
- package/payload/.agents/skills/marketing-ideas/evals/evals.json +90 -0
- package/payload/.agents/skills/marketing-ideas/references/ideas-by-category.md +366 -0
- package/payload/.agents/skills/marketing-psychology/SKILL.md +455 -0
- package/payload/.agents/skills/marketing-psychology/evals/evals.json +88 -0
- package/payload/.agents/skills/onboarding-cro/SKILL.md +220 -0
- package/payload/.agents/skills/onboarding-cro/evals/evals.json +92 -0
- package/payload/.agents/skills/onboarding-cro/references/experiments.md +258 -0
- package/payload/.agents/skills/page-cro/SKILL.md +182 -0
- package/payload/.agents/skills/page-cro/evals/evals.json +111 -0
- package/payload/.agents/skills/page-cro/references/experiments.md +248 -0
- package/payload/.agents/skills/paid-ads/SKILL.md +315 -0
- package/payload/.agents/skills/paid-ads/evals/evals.json +90 -0
- package/payload/.agents/skills/paid-ads/references/ad-copy-templates.md +207 -0
- package/payload/.agents/skills/paid-ads/references/audience-targeting.md +243 -0
- package/payload/.agents/skills/paid-ads/references/platform-setup-checklists.md +277 -0
- package/payload/.agents/skills/paywall-upgrade-cro/SKILL.md +227 -0
- package/payload/.agents/skills/paywall-upgrade-cro/evals/evals.json +93 -0
- package/payload/.agents/skills/paywall-upgrade-cro/references/experiments.md +164 -0
- package/payload/.agents/skills/popup-cro/SKILL.md +453 -0
- package/payload/.agents/skills/popup-cro/evals/evals.json +94 -0
- package/payload/.agents/skills/pricing-strategy/SKILL.md +231 -0
- package/payload/.agents/skills/pricing-strategy/evals/evals.json +90 -0
- package/payload/.agents/skills/pricing-strategy/references/research-methods.md +152 -0
- package/payload/.agents/skills/pricing-strategy/references/tier-structure.md +232 -0
- package/payload/.agents/skills/product-marketing-context/SKILL.md +27 -0
- package/payload/.agents/skills/product-marketing-context/evals/evals.json +40 -0
- package/payload/.agents/skills/programmatic-seo/SKILL.md +238 -0
- package/payload/.agents/skills/programmatic-seo/evals/evals.json +94 -0
- package/payload/.agents/skills/programmatic-seo/references/playbooks.md +308 -0
- package/payload/.agents/skills/referral-program/SKILL.md +255 -0
- package/payload/.agents/skills/referral-program/evals/evals.json +89 -0
- package/payload/.agents/skills/referral-program/references/affiliate-programs.md +164 -0
- package/payload/.agents/skills/referral-program/references/program-examples.md +143 -0
- package/payload/.agents/skills/revops/SKILL.md +343 -0
- package/payload/.agents/skills/revops/evals/evals.json +91 -0
- package/payload/.agents/skills/revops/references/automation-playbooks.md +290 -0
- package/payload/.agents/skills/revops/references/lifecycle-definitions.md +278 -0
- package/payload/.agents/skills/revops/references/routing-rules.md +203 -0
- package/payload/.agents/skills/revops/references/scoring-models.md +247 -0
- package/payload/.agents/skills/sales-enablement/SKILL.md +349 -0
- package/payload/.agents/skills/sales-enablement/evals/evals.json +91 -0
- package/payload/.agents/skills/sales-enablement/references/deck-frameworks.md +263 -0
- package/payload/.agents/skills/sales-enablement/references/demo-scripts.md +355 -0
- package/payload/.agents/skills/sales-enablement/references/objection-library.md +270 -0
- package/payload/.agents/skills/sales-enablement/references/one-pager-templates.md +208 -0
- package/payload/.agents/skills/schema-markup/SKILL.md +179 -0
- package/payload/.agents/skills/schema-markup/evals/evals.json +87 -0
- package/payload/.agents/skills/schema-markup/references/schema-examples.md +398 -0
- package/payload/.agents/skills/seo-audit/SKILL.md +412 -0
- package/payload/.agents/skills/seo-audit/evals/evals.json +136 -0
- package/payload/.agents/skills/seo-audit/references/ai-writing-detection.md +200 -0
- package/payload/.agents/skills/signup-flow-cro/SKILL.md +359 -0
- package/payload/.agents/skills/signup-flow-cro/evals/evals.json +88 -0
- package/payload/.agents/skills/site-architecture/SKILL.md +357 -0
- package/payload/.agents/skills/site-architecture/evals/evals.json +88 -0
- package/payload/.agents/skills/site-architecture/references/mermaid-templates.md +216 -0
- package/payload/.agents/skills/site-architecture/references/navigation-patterns.md +305 -0
- package/payload/.agents/skills/site-architecture/references/site-type-templates.md +293 -0
- package/payload/.agents/skills/social-content/SKILL.md +278 -0
- package/payload/.agents/skills/social-content/evals/evals.json +92 -0
- package/payload/.agents/skills/social-content/references/platforms.md +170 -0
- package/payload/.agents/skills/social-content/references/post-templates.md +177 -0
- package/payload/.agents/skills/social-content/references/reverse-engineering.md +195 -0
- package/payload/.maya/executor.md +79 -0
- package/payload/.maya/meta-api-agent.md +48 -0
- package/payload/.maya/modes/consult.md +63 -0
- package/payload/.maya/modes/task.md +97 -0
- package/payload/.maya/planner.md +69 -0
- package/payload/.maya/researcher.md +51 -0
- package/payload/.maya/templates/plan.md +77 -0
- package/payload/.maya/templates/state.md +87 -0
- package/payload/.maya/templates/task-packet.md +75 -0
- package/payload/MAYA-CATALOG.md +115 -0
- package/payload/MAYA-DEPENDENCIES.md +58 -0
- package/payload/MAYA.md +151 -0
- package/payload/campaigns/README.md +14 -0
- package/payload/commands/maya-consult.md +28 -0
- package/payload/commands/maya-task.md +38 -0
- package/payload/commands/product.md +55 -0
- package/payload/research/README.md +14 -0
- package/payload/templates/README.md +15 -0
- package/payload/templates/plan.md +77 -0
- package/payload/templates/state.md +87 -0
- package/payload/templates/task-packet.md +75 -0
- package/payload/tools/REGISTRY.md +368 -0
- package/payload/tools/clis/README.md +187 -0
- package/payload/tools/clis/activecampaign.js +435 -0
- package/payload/tools/clis/adobe-analytics.js +161 -0
- package/payload/tools/clis/ahrefs.js +192 -0
- package/payload/tools/clis/amplitude.js +182 -0
- package/payload/tools/clis/apollo.js +142 -0
- package/payload/tools/clis/beehiiv.js +245 -0
- package/payload/tools/clis/brevo.js +368 -0
- package/payload/tools/clis/buffer.js +260 -0
- package/payload/tools/clis/calendly.js +253 -0
- package/payload/tools/clis/clearbit.js +163 -0
- package/payload/tools/clis/customer-io.js +205 -0
- package/payload/tools/clis/dataforseo.js +257 -0
- package/payload/tools/clis/demio.js +149 -0
- package/payload/tools/clis/dub.js +158 -0
- package/payload/tools/clis/g2.js +186 -0
- package/payload/tools/clis/ga4.js +194 -0
- package/payload/tools/clis/google-ads.js +189 -0
- package/payload/tools/clis/google-search-console.js +166 -0
- package/payload/tools/clis/hotjar.js +167 -0
- package/payload/tools/clis/hunter.js +249 -0
- package/payload/tools/clis/instantly.js +270 -0
- package/payload/tools/clis/intercom.js +399 -0
- package/payload/tools/clis/keywords-everywhere.js +185 -0
- package/payload/tools/clis/kit.js +232 -0
- package/payload/tools/clis/klaviyo.js +348 -0
- package/payload/tools/clis/lemlist.js +221 -0
- package/payload/tools/clis/linkedin-ads.js +185 -0
- package/payload/tools/clis/livestorm.js +292 -0
- package/payload/tools/clis/mailchimp.js +220 -0
- package/payload/tools/clis/mention-me.js +161 -0
- package/payload/tools/clis/meta-ads.js +181 -0
- package/payload/tools/clis/mixpanel.js +248 -0
- package/payload/tools/clis/onesignal.js +241 -0
- package/payload/tools/clis/optimizely.js +233 -0
- package/payload/tools/clis/paddle.js +385 -0
- package/payload/tools/clis/partnerstack.js +382 -0
- package/payload/tools/clis/plausible.js +249 -0
- package/payload/tools/clis/postmark.js +375 -0
- package/payload/tools/clis/resend.js +370 -0
- package/payload/tools/clis/rewardful.js +160 -0
- package/payload/tools/clis/savvycal.js +223 -0
- package/payload/tools/clis/segment.js +192 -0
- package/payload/tools/clis/semrush.js +207 -0
- package/payload/tools/clis/sendgrid.js +211 -0
- package/payload/tools/clis/snov.js +237 -0
- package/payload/tools/clis/tiktok-ads.js +190 -0
- package/payload/tools/clis/tolt.js +153 -0
- package/payload/tools/clis/trustpilot.js +276 -0
- package/payload/tools/clis/typeform.js +269 -0
- package/payload/tools/clis/wistia.js +256 -0
- package/payload/tools/clis/zapier.js +160 -0
- package/payload/tools/integrations/activecampaign.md +337 -0
- package/payload/tools/integrations/adobe-analytics.md +156 -0
- package/payload/tools/integrations/ahrefs.md +142 -0
- package/payload/tools/integrations/amplitude.md +135 -0
- package/payload/tools/integrations/apollo.md +148 -0
- package/payload/tools/integrations/beehiiv.md +157 -0
- package/payload/tools/integrations/brevo.md +268 -0
- package/payload/tools/integrations/buffer.md +138 -0
- package/payload/tools/integrations/calendly.md +161 -0
- package/payload/tools/integrations/clearbit.md +142 -0
- package/payload/tools/integrations/customer-io.md +187 -0
- package/payload/tools/integrations/dataforseo.md +165 -0
- package/payload/tools/integrations/demio.md +182 -0
- package/payload/tools/integrations/dub-co.md +160 -0
- package/payload/tools/integrations/g2.md +179 -0
- package/payload/tools/integrations/ga4.md +126 -0
- package/payload/tools/integrations/google-ads.md +159 -0
- package/payload/tools/integrations/google-search-console.md +147 -0
- package/payload/tools/integrations/hotjar.md +147 -0
- package/payload/tools/integrations/hubspot.md +178 -0
- package/payload/tools/integrations/hunter.md +90 -0
- package/payload/tools/integrations/instantly.md +104 -0
- package/payload/tools/integrations/intercom.md +292 -0
- package/payload/tools/integrations/keywords-everywhere.md +207 -0
- package/payload/tools/integrations/kit.md +167 -0
- package/payload/tools/integrations/klaviyo.md +228 -0
- package/payload/tools/integrations/lemlist.md +110 -0
- package/payload/tools/integrations/linkedin-ads.md +164 -0
- package/payload/tools/integrations/livestorm.md +313 -0
- package/payload/tools/integrations/mailchimp.md +150 -0
- package/payload/tools/integrations/mention-me.md +160 -0
- package/payload/tools/integrations/meta-ads.md +147 -0
- package/payload/tools/integrations/mixpanel.md +137 -0
- package/payload/tools/integrations/onesignal.md +229 -0
- package/payload/tools/integrations/optimizely.md +171 -0
- package/payload/tools/integrations/paddle.md +212 -0
- package/payload/tools/integrations/partnerstack.md +222 -0
- package/payload/tools/integrations/plausible.md +177 -0
- package/payload/tools/integrations/posthog.md +151 -0
- package/payload/tools/integrations/postmark.md +234 -0
- package/payload/tools/integrations/resend.md +168 -0
- package/payload/tools/integrations/rewardful.md +147 -0
- package/payload/tools/integrations/salesforce.md +150 -0
- package/payload/tools/integrations/savvycal.md +181 -0
- package/payload/tools/integrations/segment.md +159 -0
- package/payload/tools/integrations/semrush.md +121 -0
- package/payload/tools/integrations/sendgrid.md +161 -0
- package/payload/tools/integrations/shopify.md +176 -0
- package/payload/tools/integrations/snov.md +94 -0
- package/payload/tools/integrations/stripe.md +148 -0
- package/payload/tools/integrations/tiktok-ads.md +161 -0
- package/payload/tools/integrations/tolt.md +144 -0
- package/payload/tools/integrations/trustpilot.md +191 -0
- package/payload/tools/integrations/typeform.md +190 -0
- package/payload/tools/integrations/webflow.md +198 -0
- package/payload/tools/integrations/wistia.md +164 -0
- package/payload/tools/integrations/wordpress.md +175 -0
- package/payload/tools/integrations/zapier.md +150 -0
- package/payload/tools/meta/README.md +55 -0
- package/payload/tools/meta/meta-cache-schema.md +65 -0
- package/payload/tools/meta/meta-fetch.ps1 +324 -0
- package/payload/tools/meta/meta-fetch.test.ps1 +38 -0
- package/vendor/shared-installer/manifests/claude-files.json +13 -0
- package/vendor/shared-installer/manifests/codex-files.json +13 -0
- package/vendor/shared-installer/manifests/common-files.json +13 -0
- package/vendor/shared-installer/package.json +15 -0
- package/vendor/shared-installer/src/bootstrap.js +12 -0
- package/vendor/shared-installer/src/cli-options.js +53 -0
- package/vendor/shared-installer/src/fs.js +105 -0
- package/vendor/shared-installer/src/index.js +44 -0
- package/vendor/shared-installer/src/install.js +157 -0
- package/vendor/shared-installer/src/manifest.js +52 -0
- package/vendor/shared-installer/templates/claude/.claude/skills/.gitkeep +1 -0
- package/vendor/shared-installer/templates/claude/CLAUDE.md +27 -0
- package/vendor/shared-installer/templates/codex/.agent/skills/.gitkeep +1 -0
- package/vendor/shared-installer/templates/codex/AGENTS.md +27 -0
|
@@ -0,0 +1,270 @@
|
|
|
1
|
+
# Objection Library
|
|
2
|
+
|
|
3
|
+
Common B2B SaaS objections with response frameworks. Organized by category for quick reference.
|
|
4
|
+
|
|
5
|
+
## Quick-Reference Table
|
|
6
|
+
|
|
7
|
+
For live calls. Find the objection, scan the response, reference the proof.
|
|
8
|
+
|
|
9
|
+
| Objection | Response (1-line) | Proof Point |
|
|
10
|
+
|-----------|--------------------|-------------|
|
|
11
|
+
| "Too expensive" | "Compared to what? Let's look at what the problem costs you today." | ROI case study showing payback in X months |
|
|
12
|
+
| "No budget" | "When budget opens up, what would need to be true for this to be a priority?" | Customer who started with a pilot to prove value |
|
|
13
|
+
| "Competitor is cheaper" | "They are — here's what you give up at that price point." | Feature comparison + customer who switched |
|
|
14
|
+
| "Not the right time" | "What changes next quarter that makes it better timing?" | Cost-of-delay calculation |
|
|
15
|
+
| "Maybe next quarter" | "Happy to reconnect. What would a pilot look like before then?" | Customer who started small and expanded |
|
|
16
|
+
| "We use X already" | "How's that working for [specific pain area]?" | Customer who switched from X |
|
|
17
|
+
| "What makes you different?" | "For teams like yours, the biggest difference is [specific differentiator]." | Side-by-side comparison for their use case |
|
|
18
|
+
| "Need to check with my boss" | "Absolutely. What would help you make the case? I can send materials." | Champion one-pager, ROI calculator |
|
|
19
|
+
| "The committee decides" | "Who's on the committee and what does each person care about?" | Multi-persona case study |
|
|
20
|
+
| "What we have works fine" | "It does work — the question is whether it's costing you more than it should." | Benchmark data showing efficiency gaps |
|
|
21
|
+
| "Not broken, don't fix it" | "Agreed — this isn't about fixing, it's about the opportunity cost of the current approach." | Customer who didn't know what they were missing |
|
|
22
|
+
| "Does it integrate with X?" | "Yes / Let me check and get you specifics by end of day." | Integration documentation, customer using same stack |
|
|
23
|
+
| "Security concerns" | "Completely fair. Here's our security overview — happy to loop in our team." | SOC 2 report, security whitepaper |
|
|
24
|
+
| "Can it scale?" | "We serve companies from [small] to [large]. Here's an example at your scale." | Case study at similar scale |
|
|
25
|
+
| "We tried something like this before" | "What went wrong? Understanding that helps me show how we're different." | Customer with same failed experience who succeeded with you |
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## Detailed Objection Responses
|
|
30
|
+
|
|
31
|
+
### Price Objections
|
|
32
|
+
|
|
33
|
+
#### "It's too expensive"
|
|
34
|
+
|
|
35
|
+
**Why they say it:** May be genuine budget constraint, sticker shock, or negotiation tactic. Often means they don't yet see enough value to justify the cost.
|
|
36
|
+
|
|
37
|
+
**Response approach:**
|
|
38
|
+
1. Don't defend the price immediately. Ask "Compared to what?"
|
|
39
|
+
2. Reframe from cost to investment — what does the problem cost them today?
|
|
40
|
+
3. Walk through the ROI calculation together
|
|
41
|
+
4. If budget is real, explore smaller starting points
|
|
42
|
+
|
|
43
|
+
**Talk track:**
|
|
44
|
+
> "I hear that. Let me ask — what's the cost of the problem we discussed? You mentioned your team spends [X hours] on [task] every week. At your team's loaded cost, that's roughly [$ amount] per year. Our solution runs [$ price] — so the question is whether eliminating that problem is worth the investment."
|
|
45
|
+
|
|
46
|
+
**Proof point:** ROI calculator or case study showing payback period.
|
|
47
|
+
|
|
48
|
+
**Follow-up question:** "If the ROI was clear, is this something you'd prioritize this quarter?"
|
|
49
|
+
|
|
50
|
+
---
|
|
51
|
+
|
|
52
|
+
#### "We don't have budget for this"
|
|
53
|
+
|
|
54
|
+
**Why they say it:** Budget may genuinely be allocated. Or they haven't identified budget because priority isn't established.
|
|
55
|
+
|
|
56
|
+
**Response approach:**
|
|
57
|
+
1. Validate — budget constraints are real
|
|
58
|
+
2. Understand timing — when does budget cycle reset?
|
|
59
|
+
3. Explore alternatives — pilot, smaller scope, different budget line
|
|
60
|
+
4. Help them build the business case to create budget
|
|
61
|
+
|
|
62
|
+
**Talk track:**
|
|
63
|
+
> "Totally understand. Two questions: When does your next budget cycle open? And — if we could show clear ROI with a limited pilot, is that something you could fund from a different line item? Sometimes teams fund this from the efficiency savings it creates."
|
|
64
|
+
|
|
65
|
+
**Proof point:** Customer who started with a small pilot and expanded after proving ROI.
|
|
66
|
+
|
|
67
|
+
**Follow-up question:** "Would it help if I put together an ROI brief you could share with your finance team?"
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
#### "Competitor X is cheaper"
|
|
72
|
+
|
|
73
|
+
**Why they say it:** They're comparing prices, possibly without comparing capabilities. May be using competitor price as leverage.
|
|
74
|
+
|
|
75
|
+
**Response approach:**
|
|
76
|
+
1. Acknowledge the price difference — don't pretend it doesn't exist
|
|
77
|
+
2. Shift to total cost of ownership and value delivered
|
|
78
|
+
3. Highlight what they lose at the lower price point
|
|
79
|
+
4. Share proof from customers who evaluated both
|
|
80
|
+
|
|
81
|
+
**Talk track:**
|
|
82
|
+
> "You're right, [Competitor] is less expensive. Here's what I've seen from teams who evaluated both: [Competitor] works well for [their strength]. Where it falls short is [specific gap]. Customers like [name] actually switched to us after starting with [Competitor] because [specific reason]. The question is whether [specific capability] is worth the difference for your team."
|
|
83
|
+
|
|
84
|
+
**Proof point:** Customer who switched from the competitor, with specific reasons.
|
|
85
|
+
|
|
86
|
+
**Follow-up question:** "What's most important to your team — the lowest price or the best fit for [their specific need]?"
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
### Timing Objections
|
|
91
|
+
|
|
92
|
+
#### "Not the right time"
|
|
93
|
+
|
|
94
|
+
**Why they say it:** Competing priorities, organizational change, genuine capacity constraint, or lack of urgency.
|
|
95
|
+
|
|
96
|
+
**Response approach:**
|
|
97
|
+
1. Understand what's competing for their attention
|
|
98
|
+
2. Quantify the cost of waiting
|
|
99
|
+
3. Explore low-commitment next steps that keep momentum
|
|
100
|
+
4. Set a concrete follow-up date
|
|
101
|
+
|
|
102
|
+
**Talk track:**
|
|
103
|
+
> "I get it — timing matters. Can I ask what's taking priority right now? The reason I bring up timing is that every month of [problem], based on our earlier conversation, costs your team roughly [$ amount]. A 3-month delay is [$ amount]. What if we mapped out a start date that works with your calendar so you're not losing that value?"
|
|
104
|
+
|
|
105
|
+
**Proof point:** Cost-of-delay calculation based on their specific numbers.
|
|
106
|
+
|
|
107
|
+
**Follow-up question:** "What would need to change for this to move up in priority?"
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
#### "Maybe next quarter"
|
|
112
|
+
|
|
113
|
+
**Why they say it:** Genuine scheduling, or a polite way of saying "not interested enough right now."
|
|
114
|
+
|
|
115
|
+
**Response approach:**
|
|
116
|
+
1. Accept the timeline gracefully
|
|
117
|
+
2. Propose a small action now that maintains momentum
|
|
118
|
+
3. Get a specific date for follow-up
|
|
119
|
+
4. Send value in the meantime (content, benchmarks, insights)
|
|
120
|
+
|
|
121
|
+
**Talk track:**
|
|
122
|
+
> "Next quarter works. To make sure we hit the ground running, would it make sense to do [small next step] now? That way when Q[X] starts, you're not starting from scratch. I'll also send over [relevant content] in the meantime. Can we lock in [specific date] to reconnect?"
|
|
123
|
+
|
|
124
|
+
**Proof point:** Customer who started the evaluation process early and was live by their target date.
|
|
125
|
+
|
|
126
|
+
**Follow-up question:** "Is there anything I can send between now and then that would be helpful?"
|
|
127
|
+
|
|
128
|
+
---
|
|
129
|
+
|
|
130
|
+
### Competition Objections
|
|
131
|
+
|
|
132
|
+
#### "We already use X"
|
|
133
|
+
|
|
134
|
+
**Why they say it:** They have an existing solution and switching has real costs. May be satisfied, or may have frustrations they haven't voiced.
|
|
135
|
+
|
|
136
|
+
**Response approach:**
|
|
137
|
+
1. Don't trash the competitor — ask how it's working
|
|
138
|
+
2. Probe for specific pain points with their current solution
|
|
139
|
+
3. Position as complementary if possible, replacement if not
|
|
140
|
+
4. Offer a side-by-side comparison or trial
|
|
141
|
+
|
|
142
|
+
**Talk track:**
|
|
143
|
+
> "How's that working for you? Specifically, when it comes to [area where you're stronger] — is that meeting your needs? The reason I ask is that most teams who come to us from [Competitor] tell us [specific pain point] was the tipping point. Not saying that's you, but worth exploring."
|
|
144
|
+
|
|
145
|
+
**Proof point:** Customer who switched from that specific competitor.
|
|
146
|
+
|
|
147
|
+
**Follow-up question:** "If you could change one thing about your current setup, what would it be?"
|
|
148
|
+
|
|
149
|
+
---
|
|
150
|
+
|
|
151
|
+
#### "What makes you different?"
|
|
152
|
+
|
|
153
|
+
**Why they say it:** They're evaluating options and want a clear differentiator. Sometimes a genuine question, sometimes a test.
|
|
154
|
+
|
|
155
|
+
**Response approach:**
|
|
156
|
+
1. Don't list features — give the one thing that matters most for their situation
|
|
157
|
+
2. Tie the differentiator to their specific pain
|
|
158
|
+
3. Back it up with proof
|
|
159
|
+
4. Offer to show, not just tell
|
|
160
|
+
|
|
161
|
+
**Talk track:**
|
|
162
|
+
> "For teams like yours — [their industry/size/use case] — the biggest difference is [specific differentiator]. That matters because [connection to their pain]. For example, [Customer] was evaluating us alongside [Competitor] and chose us because [specific reason]. Want me to walk you through how that works?"
|
|
163
|
+
|
|
164
|
+
**Proof point:** Case study of a customer who chose you over alternatives.
|
|
165
|
+
|
|
166
|
+
**Follow-up question:** "What's the most important criteria for your decision?"
|
|
167
|
+
|
|
168
|
+
---
|
|
169
|
+
|
|
170
|
+
### Authority Objections
|
|
171
|
+
|
|
172
|
+
#### "I need to check with my boss"
|
|
173
|
+
|
|
174
|
+
**Why they say it:** They may not be the decision maker, or they need internal buy-in to proceed. Could also be a stall tactic.
|
|
175
|
+
|
|
176
|
+
**Response approach:**
|
|
177
|
+
1. Support them, don't pressure them
|
|
178
|
+
2. Arm them with materials to sell internally
|
|
179
|
+
3. Offer to join a meeting with their boss
|
|
180
|
+
4. Understand what their boss cares about
|
|
181
|
+
|
|
182
|
+
**Talk track:**
|
|
183
|
+
> "Absolutely — what would help you make the case? I can put together a one-pager that covers the ROI and addresses the concerns your boss is likely to have. Also happy to jump on a quick call with them if that would be helpful. What does your boss typically prioritize — cost savings, risk reduction, or efficiency?"
|
|
184
|
+
|
|
185
|
+
**Proof point:** Champion enablement one-pager, ROI calculator.
|
|
186
|
+
|
|
187
|
+
**Follow-up question:** "What questions do you think your boss will ask?"
|
|
188
|
+
|
|
189
|
+
---
|
|
190
|
+
|
|
191
|
+
#### "A committee decides this"
|
|
192
|
+
|
|
193
|
+
**Why they say it:** Enterprise buying involves multiple stakeholders. Genuine process, not a brush-off.
|
|
194
|
+
|
|
195
|
+
**Response approach:**
|
|
196
|
+
1. Map the buying committee — who's involved and what each person cares about
|
|
197
|
+
2. Provide persona-specific materials
|
|
198
|
+
3. Offer to present to the committee
|
|
199
|
+
4. Help your champion navigate the internal process
|
|
200
|
+
|
|
201
|
+
**Talk track:**
|
|
202
|
+
> "That makes sense. Can you walk me through who's on the committee and what each person cares about? I can tailor materials for each stakeholder so you're not doing all the heavy lifting. I've also got a deck designed for executive presentations if that would be useful."
|
|
203
|
+
|
|
204
|
+
**Proof point:** Multi-stakeholder case study showing how different personas were addressed.
|
|
205
|
+
|
|
206
|
+
**Follow-up question:** "Who on the committee is most likely to push back, and what would their concern be?"
|
|
207
|
+
|
|
208
|
+
---
|
|
209
|
+
|
|
210
|
+
### Status Quo Objections
|
|
211
|
+
|
|
212
|
+
#### "What we have works fine"
|
|
213
|
+
|
|
214
|
+
**Why they say it:** Inertia is real. The current solution may be adequate, and change has real costs.
|
|
215
|
+
|
|
216
|
+
**Response approach:**
|
|
217
|
+
1. Agree — don't argue with their experience
|
|
218
|
+
2. Shift from "broken vs. fixed" to "good vs. great"
|
|
219
|
+
3. Introduce the concept of opportunity cost
|
|
220
|
+
4. Show what peers are achieving
|
|
221
|
+
|
|
222
|
+
**Talk track:**
|
|
223
|
+
> "It probably does work — and I wouldn't suggest changing something that's truly meeting your needs. The question I'd ask is: is 'works fine' the bar? Teams using [your product] are seeing [specific outcome]. If you're leaving [X% improvement] on the table, is that worth exploring?"
|
|
224
|
+
|
|
225
|
+
**Proof point:** Benchmark data showing what's possible vs. status quo.
|
|
226
|
+
|
|
227
|
+
**Follow-up question:** "If there were one area where your current approach could be better, what would it be?"
|
|
228
|
+
|
|
229
|
+
---
|
|
230
|
+
|
|
231
|
+
### Technical Objections
|
|
232
|
+
|
|
233
|
+
#### "Does it integrate with X?"
|
|
234
|
+
|
|
235
|
+
**Why they say it:** Integration is a real requirement. They need to know your product fits their stack.
|
|
236
|
+
|
|
237
|
+
**Response approach:**
|
|
238
|
+
1. Answer directly — yes, no, or "let me check"
|
|
239
|
+
2. If yes, provide specifics (native, API, Zapier, etc.)
|
|
240
|
+
3. If no, explain alternatives or workarounds
|
|
241
|
+
4. Never bluff — they'll find out during evaluation
|
|
242
|
+
|
|
243
|
+
**Talk track (if yes):**
|
|
244
|
+
> "Yes, we integrate with [X] natively. It takes about [time] to set up. [Customer] runs the same stack and here's how they have it configured."
|
|
245
|
+
|
|
246
|
+
**Talk track (if no):**
|
|
247
|
+
> "We don't have a native integration with [X] today. Here's what customers typically do: [alternative]. We also have an open API that [description]. Would it help to get our technical team on a call to explore options?"
|
|
248
|
+
|
|
249
|
+
**Proof point:** Customer using the same tech stack, integration documentation.
|
|
250
|
+
|
|
251
|
+
**Follow-up question:** "What other tools are in your stack that we'd need to work with?"
|
|
252
|
+
|
|
253
|
+
---
|
|
254
|
+
|
|
255
|
+
#### "We have security concerns"
|
|
256
|
+
|
|
257
|
+
**Why they say it:** Legitimate concern, especially in regulated industries or enterprise. Non-negotiable for many buyers.
|
|
258
|
+
|
|
259
|
+
**Response approach:**
|
|
260
|
+
1. Take it seriously — never dismiss security concerns
|
|
261
|
+
2. Provide documentation proactively (SOC 2, security whitepaper)
|
|
262
|
+
3. Offer to loop in your security team
|
|
263
|
+
4. Ask about their specific requirements
|
|
264
|
+
|
|
265
|
+
**Talk track:**
|
|
266
|
+
> "That's exactly the right question to ask. Here's our security overview — we're [SOC 2 Type II / ISO 27001 / etc.] certified, and I can share our full security documentation. We also have a security team that's happy to do a review call with your infosec team. What are your specific requirements?"
|
|
267
|
+
|
|
268
|
+
**Proof point:** Security certifications, compliance documentation, customers in regulated industries.
|
|
269
|
+
|
|
270
|
+
**Follow-up question:** "Do you have a security questionnaire you'd like us to fill out?"
|
|
@@ -0,0 +1,208 @@
|
|
|
1
|
+
# One-Pager Templates
|
|
2
|
+
|
|
3
|
+
Templates for different one-pager use cases, with layout guidance and copy prompts.
|
|
4
|
+
|
|
5
|
+
## Product Overview One-Pager
|
|
6
|
+
|
|
7
|
+
The default one-pager. Introduces your product to someone who knows nothing about you.
|
|
8
|
+
|
|
9
|
+
### Structure
|
|
10
|
+
|
|
11
|
+
```
|
|
12
|
+
[Logo] [Tagline]
|
|
13
|
+
|
|
14
|
+
HEADLINE: One sentence describing what you do and who it's for.
|
|
15
|
+
|
|
16
|
+
THE PROBLEM
|
|
17
|
+
2-3 sentences describing the pain your buyer faces.
|
|
18
|
+
|
|
19
|
+
THE SOLUTION
|
|
20
|
+
2-3 sentences describing how your product solves it.
|
|
21
|
+
|
|
22
|
+
WHY [YOUR PRODUCT]
|
|
23
|
+
• Differentiator 1 — One sentence explaining the benefit
|
|
24
|
+
• Differentiator 2 — One sentence explaining the benefit
|
|
25
|
+
• Differentiator 3 — One sentence explaining the benefit
|
|
26
|
+
|
|
27
|
+
PROOF
|
|
28
|
+
"Customer quote with specific result." — Name, Title, Company
|
|
29
|
+
[Optional: 2-3 metric callouts: "X% improvement", "Y hours saved"]
|
|
30
|
+
|
|
31
|
+
[CTA Button/Link] [Contact: name@company.com]
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
### Copy Prompts
|
|
35
|
+
|
|
36
|
+
- Headline: "What do you do, in one sentence, that makes someone say 'tell me more'?"
|
|
37
|
+
- Problem: "What is your buyer struggling with before they find you?"
|
|
38
|
+
- Differentiators: "If you could only tell them 3 things, what would make them choose you?"
|
|
39
|
+
|
|
40
|
+
---
|
|
41
|
+
|
|
42
|
+
## Use-Case Specific One-Pager
|
|
43
|
+
|
|
44
|
+
Tailored to a specific workflow, vertical, or problem. More targeted than the product overview.
|
|
45
|
+
|
|
46
|
+
### Structure
|
|
47
|
+
|
|
48
|
+
```
|
|
49
|
+
[Logo] [Use Case: e.g., "For Sales Teams"]
|
|
50
|
+
|
|
51
|
+
HEADLINE: How [your product] helps [persona] [achieve outcome].
|
|
52
|
+
|
|
53
|
+
THE CHALLENGE
|
|
54
|
+
When [persona] needs to [task], they face [specific pain].
|
|
55
|
+
This leads to [consequence]: [time wasted / money lost / risk].
|
|
56
|
+
|
|
57
|
+
HOW IT WORKS
|
|
58
|
+
1. [Step 1] — What happens and why it matters
|
|
59
|
+
2. [Step 2] — What happens and why it matters
|
|
60
|
+
3. [Step 3] — What happens and why it matters
|
|
61
|
+
|
|
62
|
+
RESULTS
|
|
63
|
+
• [Metric 1]: Before → After
|
|
64
|
+
• [Metric 2]: Before → After
|
|
65
|
+
• [Metric 3]: Before → After
|
|
66
|
+
|
|
67
|
+
CUSTOMER SPOTLIGHT
|
|
68
|
+
"Quote about this specific use case." — Name, Title, Company
|
|
69
|
+
|
|
70
|
+
[CTA: "See it in action" or "Start a pilot"] [Contact info]
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
### When to Use
|
|
74
|
+
|
|
75
|
+
- Different buyer personas need different one-pagers
|
|
76
|
+
- Industry-specific versions (healthcare, fintech, e-commerce)
|
|
77
|
+
- Use-case versions (reporting, onboarding, security)
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
81
|
+
## Post-Meeting Leave-Behind
|
|
82
|
+
|
|
83
|
+
Designed to reinforce a conversation that already happened. Summarizes what you discussed and proposes next steps.
|
|
84
|
+
|
|
85
|
+
### Structure
|
|
86
|
+
|
|
87
|
+
```
|
|
88
|
+
[Logo] [Date of Meeting]
|
|
89
|
+
|
|
90
|
+
MEETING RECAP: [Company Name]
|
|
91
|
+
|
|
92
|
+
WHAT WE DISCUSSED
|
|
93
|
+
• [Pain point 1 they mentioned]
|
|
94
|
+
• [Pain point 2 they mentioned]
|
|
95
|
+
• [Goal they're trying to achieve]
|
|
96
|
+
|
|
97
|
+
HOW [YOUR PRODUCT] HELPS
|
|
98
|
+
• [Solution to pain 1] — [Specific capability or workflow]
|
|
99
|
+
• [Solution to pain 2] — [Specific capability or workflow]
|
|
100
|
+
• [How you help them reach their goal]
|
|
101
|
+
|
|
102
|
+
RELEVANT PROOF
|
|
103
|
+
"Quote from a similar customer." — Name, Title, Company
|
|
104
|
+
[1-2 metrics from a similar customer]
|
|
105
|
+
|
|
106
|
+
PROPOSED NEXT STEPS
|
|
107
|
+
1. [Next step with date]
|
|
108
|
+
2. [Follow-up action]
|
|
109
|
+
3. [Decision timeline]
|
|
110
|
+
|
|
111
|
+
[Your name] | [Your title] | [Email] | [Phone]
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
### Tips
|
|
115
|
+
|
|
116
|
+
- Send within 24 hours of the meeting
|
|
117
|
+
- Reference specific things they said (shows you listened)
|
|
118
|
+
- Keep proposed next steps concrete and time-bound
|
|
119
|
+
- This is the asset your champion forwards to their boss
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
## Champion Enablement One-Pager
|
|
124
|
+
|
|
125
|
+
Designed specifically for your internal champion to share with their team and leadership. Written to make them look smart.
|
|
126
|
+
|
|
127
|
+
### Structure
|
|
128
|
+
|
|
129
|
+
```
|
|
130
|
+
[Logo]
|
|
131
|
+
|
|
132
|
+
WHY WE'RE EVALUATING [YOUR PRODUCT]
|
|
133
|
+
|
|
134
|
+
THE SITUATION
|
|
135
|
+
[2-3 sentences about the internal challenge, written as if the champion
|
|
136
|
+
is explaining it to their team. Use "we" and "our" language.]
|
|
137
|
+
|
|
138
|
+
WHAT [YOUR PRODUCT] DOES
|
|
139
|
+
[1-2 sentences. Plain language, no jargon.]
|
|
140
|
+
|
|
141
|
+
WHY THIS SOLUTION
|
|
142
|
+
• [Reason 1] — How it solves our specific problem
|
|
143
|
+
• [Reason 2] — How it compares to what we do today
|
|
144
|
+
• [Reason 3] — How it compares to alternatives we evaluated
|
|
145
|
+
|
|
146
|
+
EXPECTED IMPACT
|
|
147
|
+
• [Metric]: Current state → Expected state
|
|
148
|
+
• [Metric]: Current state → Expected state
|
|
149
|
+
• [Time to value]: Live within [X weeks]
|
|
150
|
+
|
|
151
|
+
WHO ELSE USES IT
|
|
152
|
+
[2-3 recognizable company names in their industry]
|
|
153
|
+
"Relevant customer quote." — Name, Title, Company
|
|
154
|
+
|
|
155
|
+
NEXT STEPS
|
|
156
|
+
• [What we're doing next]
|
|
157
|
+
• [What we need from the team]
|
|
158
|
+
• [Decision timeline]
|
|
159
|
+
|
|
160
|
+
Questions? Talk to [Champion name] or [Your name at email].
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
### Why This Works
|
|
164
|
+
|
|
165
|
+
- Written in the champion's voice, not yours
|
|
166
|
+
- Answers the questions their boss will ask
|
|
167
|
+
- Includes peer proof from companies they respect
|
|
168
|
+
- Clear ask and timeline to drive internal momentum
|
|
169
|
+
|
|
170
|
+
---
|
|
171
|
+
|
|
172
|
+
## Layout Guidance
|
|
173
|
+
|
|
174
|
+
### Visual Hierarchy
|
|
175
|
+
|
|
176
|
+
1. **Headline** — Largest text, top of page, immediately communicates value
|
|
177
|
+
2. **Section headers** — Bold, clear, act as scannable anchors
|
|
178
|
+
3. **Body text** — Short sentences, bullet points preferred over paragraphs
|
|
179
|
+
4. **Proof elements** — Metrics and quotes should visually stand out (larger font, color, or callout box)
|
|
180
|
+
5. **CTA** — Prominent placement, bottom of page or bottom-right
|
|
181
|
+
|
|
182
|
+
### Whitespace
|
|
183
|
+
|
|
184
|
+
- Margins: at least 0.75" on all sides
|
|
185
|
+
- Space between sections: enough to visually separate (don't cram)
|
|
186
|
+
- If it feels crowded, cut content. Never shrink font below 9pt.
|
|
187
|
+
|
|
188
|
+
### Font Sizing
|
|
189
|
+
|
|
190
|
+
| Element | Suggested Size |
|
|
191
|
+
|---------|---------------|
|
|
192
|
+
| Headline | 18-24pt |
|
|
193
|
+
| Section headers | 12-14pt bold |
|
|
194
|
+
| Body text | 10-11pt |
|
|
195
|
+
| Fine print / footer | 8-9pt |
|
|
196
|
+
|
|
197
|
+
### Color
|
|
198
|
+
|
|
199
|
+
- Use brand colors for headers and accents
|
|
200
|
+
- Keep body text dark (black or near-black) on white
|
|
201
|
+
- Limit accent colors to 1-2 for visual consistency
|
|
202
|
+
- Use color to draw attention to metrics and CTAs
|
|
203
|
+
|
|
204
|
+
### File Format
|
|
205
|
+
|
|
206
|
+
- **PDF** for email attachments and leave-behinds
|
|
207
|
+
- **Google Slides / PowerPoint** for editable versions reps can customize
|
|
208
|
+
- Always include both — reps will customize, prospects want clean PDFs
|
|
@@ -0,0 +1,179 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: schema-markup
|
|
3
|
+
description: When the user wants to add, fix, or optimize schema markup and structured data on their site. Also use when the user mentions "schema markup," "structured data," "JSON-LD," "rich snippets," "schema.org," "FAQ schema," "product schema," "review schema," "breadcrumb schema," "Google rich results," "knowledge panel," "star ratings in search," or "add structured data." Use this whenever someone wants their pages to show enhanced results in Google. For broader SEO issues, see seo-audit. For AI search optimization, see ai-seo.
|
|
4
|
+
metadata:
|
|
5
|
+
version: 1.1.0
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Schema Markup
|
|
9
|
+
|
|
10
|
+
You are an expert in structured data and schema markup. Your goal is to implement schema.org markup that helps search engines understand content and enables rich results in search.
|
|
11
|
+
|
|
12
|
+
## Initial Assessment
|
|
13
|
+
|
|
14
|
+
**Use approved context inputs first:**
|
|
15
|
+
In Maya task workflows, start with the approved `TASK-PACKET.md` inputs and listed brand sections. If `PRODUCT.md` is explicitly provided or the work is being done in consult-style standalone usage, read `PRODUCT.md` before asking questions. If `PRODUCT.md` is missing, do not pretend the output is fully brand-calibrated.
|
|
16
|
+
|
|
17
|
+
Before implementing schema, understand:
|
|
18
|
+
|
|
19
|
+
1. **Page Type** - What kind of page? What's the primary content? What rich results are possible?
|
|
20
|
+
|
|
21
|
+
2. **Current State** - Any existing schema? Errors in implementation? Which rich results already appearing?
|
|
22
|
+
|
|
23
|
+
3. **Goals** - Which rich results are you targeting? What's the business value?
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## Core Principles
|
|
28
|
+
|
|
29
|
+
### 1. Accuracy First
|
|
30
|
+
- Schema must accurately represent page content
|
|
31
|
+
- Don't markup content that doesn't exist
|
|
32
|
+
- Keep updated when content changes
|
|
33
|
+
|
|
34
|
+
### 2. Use JSON-LD
|
|
35
|
+
- Google recommends JSON-LD format
|
|
36
|
+
- Easier to implement and maintain
|
|
37
|
+
- Place in `<head>` or end of `<body>`
|
|
38
|
+
|
|
39
|
+
### 3. Follow Google's Guidelines
|
|
40
|
+
- Only use markup Google supports
|
|
41
|
+
- Avoid spam tactics
|
|
42
|
+
- Review eligibility requirements
|
|
43
|
+
|
|
44
|
+
### 4. Validate Everything
|
|
45
|
+
- Test before deploying
|
|
46
|
+
- Monitor Search Console
|
|
47
|
+
- Fix errors promptly
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## Common Schema Types
|
|
52
|
+
|
|
53
|
+
| Type | Use For | Required Properties |
|
|
54
|
+
|------|---------|-------------------|
|
|
55
|
+
| Organization | Company homepage/about | name, url |
|
|
56
|
+
| WebSite | Homepage (search box) | name, url |
|
|
57
|
+
| Article | Blog posts, news | headline, image, datePublished, author |
|
|
58
|
+
| Product | Product pages | name, image, offers |
|
|
59
|
+
| SoftwareApplication | SaaS/app pages | name, offers |
|
|
60
|
+
| FAQPage | FAQ content | mainEntity (Q&A array) |
|
|
61
|
+
| HowTo | Tutorials | name, step |
|
|
62
|
+
| BreadcrumbList | Any page with breadcrumbs | itemListElement |
|
|
63
|
+
| LocalBusiness | Local business pages | name, address |
|
|
64
|
+
| Event | Events, webinars | name, startDate, location |
|
|
65
|
+
|
|
66
|
+
**For complete JSON-LD examples**: See [references/schema-examples.md](references/schema-examples.md)
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## Quick Reference
|
|
71
|
+
|
|
72
|
+
### Organization (Company Page)
|
|
73
|
+
Required: name, url
|
|
74
|
+
Recommended: logo, sameAs (social profiles), contactPoint
|
|
75
|
+
|
|
76
|
+
### Article/BlogPosting
|
|
77
|
+
Required: headline, image, datePublished, author
|
|
78
|
+
Recommended: dateModified, publisher, description
|
|
79
|
+
|
|
80
|
+
### Product
|
|
81
|
+
Required: name, image, offers (price + availability)
|
|
82
|
+
Recommended: sku, brand, aggregateRating, review
|
|
83
|
+
|
|
84
|
+
### FAQPage
|
|
85
|
+
Required: mainEntity (array of Question/Answer pairs)
|
|
86
|
+
|
|
87
|
+
### BreadcrumbList
|
|
88
|
+
Required: itemListElement (array with position, name, item)
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## Multiple Schema Types
|
|
93
|
+
|
|
94
|
+
You can combine multiple schema types on one page using `@graph`:
|
|
95
|
+
|
|
96
|
+
```json
|
|
97
|
+
{
|
|
98
|
+
"@context": "https://schema.org",
|
|
99
|
+
"@graph": [
|
|
100
|
+
{ "@type": "Organization", ... },
|
|
101
|
+
{ "@type": "WebSite", ... },
|
|
102
|
+
{ "@type": "BreadcrumbList", ... }
|
|
103
|
+
]
|
|
104
|
+
}
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## Validation and Testing
|
|
110
|
+
|
|
111
|
+
### Tools
|
|
112
|
+
- **Google Rich Results Test**: https://search.google.com/test/rich-results
|
|
113
|
+
- **Schema.org Validator**: https://validator.schema.org/
|
|
114
|
+
- **Search Console**: Enhancements reports
|
|
115
|
+
|
|
116
|
+
### Common Errors
|
|
117
|
+
|
|
118
|
+
**Missing required properties** - Check Google's documentation for required fields
|
|
119
|
+
|
|
120
|
+
**Invalid values** - Dates must be ISO 8601, URLs fully qualified, enumerations exact
|
|
121
|
+
|
|
122
|
+
**Mismatch with page content** - Schema doesn't match visible content
|
|
123
|
+
|
|
124
|
+
---
|
|
125
|
+
|
|
126
|
+
## Implementation
|
|
127
|
+
|
|
128
|
+
### Static Sites
|
|
129
|
+
- Add JSON-LD directly in HTML template
|
|
130
|
+
- Use includes/partials for reusable schema
|
|
131
|
+
|
|
132
|
+
### Dynamic Sites (React, Next.js)
|
|
133
|
+
- Component that renders schema
|
|
134
|
+
- Server-side rendered for SEO
|
|
135
|
+
- Serialize data to JSON-LD
|
|
136
|
+
|
|
137
|
+
### CMS / WordPress
|
|
138
|
+
- Plugins (Yoast, Rank Math, Schema Pro)
|
|
139
|
+
- Theme modifications
|
|
140
|
+
- Custom fields to structured data
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
## Output Format
|
|
145
|
+
|
|
146
|
+
### Schema Implementation
|
|
147
|
+
```json
|
|
148
|
+
// Full JSON-LD code block
|
|
149
|
+
{
|
|
150
|
+
"@context": "https://schema.org",
|
|
151
|
+
"@type": "...",
|
|
152
|
+
// Complete markup
|
|
153
|
+
}
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
### Testing Checklist
|
|
157
|
+
- [ ] Validates in Rich Results Test
|
|
158
|
+
- [ ] No errors or warnings
|
|
159
|
+
- [ ] Matches page content
|
|
160
|
+
- [ ] All required properties included
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## Task-Specific Questions
|
|
165
|
+
|
|
166
|
+
1. What type of page is this?
|
|
167
|
+
2. What rich results are you hoping to achieve?
|
|
168
|
+
3. What data is available to populate the schema?
|
|
169
|
+
4. Is there existing schema on the page?
|
|
170
|
+
5. What's your tech stack?
|
|
171
|
+
|
|
172
|
+
---
|
|
173
|
+
|
|
174
|
+
## Related Skills
|
|
175
|
+
|
|
176
|
+
- **seo-audit**: For overall SEO including schema review
|
|
177
|
+
- **ai-seo**: For AI search optimization (schema helps AI understand content)
|
|
178
|
+
- **programmatic-seo**: For templated schema at scale
|
|
179
|
+
- **site-architecture**: For breadcrumb structure and navigation schema planning
|