Market Report

Marketing Report Generator (Markdown Format)

Skill Purpose

Generate a comprehensive, professionally formatted marketing report in Markdown. This skill compiles data from all previous audit and analysis results into a single, client-ready document with scores, findings, recommendations, and a prioritized action plan with revenue impact estimates.

When to Use

• User wants a full marketing report for a client or their own business
• User has completed one or more audit skills and wants a compiled report
• User asks for a marketing assessment, scorecard, or analysis document
• Triggered by /market report or /market report <domain>

Dynamic Workflow orchestration

This report is a multi-angle synthesis, not a single linear write-up. The 6 scorecard categories + competitor analysis are file-disjoint, independently-evidenced units — fan them out, verify adversarially, then synthesize the narrative yourself.

1. Plan the units. Resolve which of the natural units have source data (Website & Conversion, SEO & Organic, Content & Messaging, Social, Email & Automation, Paid, + Competitor matrix). A unit with no source file is scored "estimate" and flagged, never silently inflated.
2. Fan out (parallel). Run one sub-agent per available unit, each reading ONLY its own source file(s) (e.g. SEO unit reads SEO-AUDIT.md). Each returns: category score with the per-factor table filled, 3-5 cited findings (file:line or source URL), what's working, gaps, ranked recommendations, and a revenue-impact estimate with its confidence factor. Scope rule: one writer per unit, no sub-agent touches another's source or score.
3. Adversarially verify (≥3 skeptic graders, 2-of-3 consensus). Before a unit's numbers enter the report, three skeptic lenses try to falsify them: (a) Evidence lens — is every score and finding backed by a real citation, or invented? (b) Inflation lens — are revenue estimates anchored to actual traffic/conversion data with a conservative confidence factor, not wishful math? (c) Consistency lens — do per-factor points sum correctly and match the stated category score and rating band? A unit ships only on ≥2-of-3 pass; otherwise it loops back to its sub-agent with the specific falsification.
4. Loop-until-dry for discovery. When the set of available source files is unknown (the user just says "compile what we have"), keep discovering and scoring units until no new source file is found — do not hard-code to a fixed 6.
5. Synthesize yourself. Compute the weighted overall score, write the executive summary, top-3 priority actions, and 30-60-90 roadmap from the verified unit outputs. Never paste a sub-agent's section verbatim as the verdict — the narrative and prioritization are your job.

How to Execute

Step 1: Collect All Available Data

Before generating the report, check for any existing audit data from previous skill runs. Look for these files in the project directory:

Possible data sources:

• MARKETING-AUDIT.md -- from /market audit
• LANDING-CRO.md -- from /market landing
• SEO-AUDIT.md -- from /market seo
• BRAND-VOICE.md -- from /market brand
• COMPETITOR-ANALYSIS.md -- from /market competitors
• FUNNEL-ANALYSIS.md -- from /market funnel
• CONTENT-AUDIT.md -- from content analysis
• AD-AUDIT.md -- from /market ads
• SOCIAL-AUDIT.md -- from /market social
• EMAIL-AUDIT.md -- from /market emails

If no previous data exists, inform the user and offer to:

1. Run a quick audit first (recommended)
2. Generate a report based on available information (website URL, user-provided data)
3. Create a report template they can fill in

Step 2: Calculate the Marketing Scorecard

Score across 6 categories, each worth up to 100 points. The overall score is the weighted average.

Category 1: Website & Conversion (Weight: 25%)

Evaluate based on landing page analysis, CRO findings, and UX assessment.

Category 2: SEO & Organic (Weight: 20%)

Evaluate based on SEO audit findings.

Category 3: Content & Messaging (Weight: 15%)

Evaluate based on brand voice analysis and content audit.

Category 4: Social Media & Community (Weight: 15%)

Evaluate based on social media presence and engagement.

Category 5: Email & Automation (Weight: 15%)

Evaluate based on email marketing assessment.

Category 6: Paid Advertising (Weight: 10%)

Evaluate based on ad account audit (if applicable).

Overall Score Calculation

Overall Score = (Website * 0.25) + (SEO * 0.20) + (Content * 0.15) + (Social * 0.15) + (Email * 0.15) + (Paid * 0.10)

Score Interpretation:

Step 3: Write Category Deep-Dives

For each of the 6 categories, provide:

1. Score and Rating -- X/100 with interpretation
2. Key Findings -- 3-5 specific observations with evidence
3. What's Working -- Positive elements to preserve and build on
4. Gaps and Issues -- Problems identified with severity ratings
5. Recommendations -- Specific, actionable improvements ranked by impact
6. Revenue Impact Estimate -- Estimated financial impact of implementing recommendations

Revenue Impact Estimation Framework:

Impact = (Estimated traffic change * Conversion rate change * Average deal value) * Confidence factor

Example:
- Current monthly traffic: 10,000
- Recommended SEO improvements could increase traffic 30%: +3,000 visits
- Current conversion rate: 2%, CRO could improve to 3%: +1% = +130 conversions
- Average deal value: $500
- Estimated monthly revenue impact: $65,000
- Confidence factor (conservative): 0.5
- Conservative estimate: $32,500/month additional revenue

Step 4: Competitor Comparison Summary

If competitor data is available from /market competitors, include:

Competitive Positioning Matrix:

Competitive Advantages: What the client does better Competitive Gaps: Where competitors outperform the client Opportunities: Spaces competitors are not addressing

Step 5: Content Quality Assessment

Summarize content findings across all channels:

• Website copy -- Clarity, persuasiveness, brand alignment
• Blog content -- Depth, expertise, SEO optimization, publishing cadence
• Social media content -- Engagement quality, brand consistency, platform optimization
• Email content -- Subject line effectiveness, body copy quality, CTA strength
• Ad creative -- Messaging clarity, visual quality, offer presentation

Step 6: Conversion Optimization Summary

Compile all conversion-related findings:

• Primary conversion paths -- How visitors become customers
• Funnel leaks -- Where potential customers drop off
• CRO quick wins -- Changes that can be implemented immediately
• Testing opportunities -- A/B tests recommended with hypotheses
• Benchmark comparison -- Current rates vs industry standards

Step 7: SEO Snapshot

Summarize SEO health in a scannable format:

SEO Health Snapshot:
- Title Tags: [Optimized / Needs Work / Missing]
- Meta Descriptions: [Optimized / Needs Work / Missing]
- H1 Tags: [Proper / Issues / Missing]
- Image Alt Text: [Complete / Partial / Missing]
- Page Speed: [Fast / Moderate / Slow]
- Mobile-Friendly: [Yes / Partially / No]
- Schema Markup: [Present / Partial / Missing]
- Robots.txt: [Configured / Issues / Missing]
- Sitemap: [Present / Issues / Missing]
- HTTPS: [Yes / No]
- Core Web Vitals: [Pass / Needs Work / Fail]

Step 8: Build the Prioritized Action Plan

Organize all recommendations into three tiers:

Quick Wins (Implement This Week)

High impact, low effort changes. These should be implementable within 1-5 business days.

Format each item as:

- [ ] [Action item]: [Specific description]
  - Impact: [HIGH/MEDIUM/LOW]
  - Effort: [1-5 hours]
  - Expected Result: [Specific outcome]
  - Revenue Impact: [$X/month estimated]

Medium-Term (Implement This Month)

Moderate impact, moderate effort. These require 1-4 weeks.

Strategic (Implement This Quarter)

High impact, high effort. These are foundational changes that require planning and sustained effort.

Step 9: Build the 30-60-90 Day Roadmap

Days 1-30: Foundation & Quick Wins

• Week 1: Implement all quick wins from the action plan
• Week 2: Set up tracking and analytics baseline
• Week 3: Begin medium-term improvements
• Week 4: First performance review and adjustment

Days 31-60: Growth & Optimization

• Week 5-6: Launch core campaign improvements
• Week 7: A/B testing program begins
• Week 8: Content strategy implementation

Days 61-90: Scale & Expand

• Week 9-10: Scale what's working, cut what isn't
• Week 11: Expand to new channels or campaigns
• Week 12: Comprehensive review, update strategy for next quarter

Step 10: Appendix

Include methodology notes so the client understands how scores were derived:

Scoring Methodology:

• How each category was evaluated
• Data sources used
• Benchmarks referenced
• Limitations and assumptions
• Date of analysis

Tools Used:

• List any tools or scripts used in the analysis
• Reference to scripts/analyze_page.py if used

Glossary:

• Define marketing terms that a non-marketer client may not know
• Keep it relevant to terms used in the report

Output Format

Generate a file called MARKETING-REPORT.md with:

# Marketing Report
## [Company/Domain Name]
### Prepared by: [Agent/Agency Name]
### Date: [Date]

---

## Executive Summary

### Overall Marketing Score: [X/100] -- [Rating]

[2-3 paragraph summary covering: current state assessment, top 3 findings, estimated revenue impact of implementing recommendations, and recommended first steps]

### Score Breakdown
| Category | Score | Rating |
|---|---|---|
| Website & Conversion | X/100 | [Rating] |
| SEO & Organic | X/100 | [Rating] |
| Content & Messaging | X/100 | [Rating] |
| Social Media | X/100 | [Rating] |
| Email & Automation | X/100 | [Rating] |
| Paid Advertising | X/100 | [Rating] |
| **Overall** | **X/100** | **[Rating]** |

### Top 3 Priority Actions
1. [Most impactful recommendation with revenue estimate]
2. [Second most impactful recommendation]
3. [Third most impactful recommendation]

---

## Detailed Findings

### 1. Website & Conversion [X/100]
[Deep-dive analysis with findings, what's working, gaps, recommendations]

### 2. SEO & Organic [X/100]
[Deep-dive analysis]

### 3. Content & Messaging [X/100]
[Deep-dive analysis]

### 4. Social Media [X/100]
[Deep-dive analysis]

### 5. Email & Automation [X/100]
[Deep-dive analysis]

### 6. Paid Advertising [X/100]
[Deep-dive analysis]

---

## Competitor Comparison
[Matrix and analysis]

---

## SEO Snapshot
[Health checklist]

---

## Conversion Optimization Summary
[Funnel analysis and CRO recommendations]

---

## Revenue Impact Summary
| Recommendation | Estimated Monthly Impact | Confidence | Priority |
|---|---|---|---|
| [Rec 1] | $X,XXX | High/Medium/Low | 1 |
| [Rec 2] | $X,XXX | High/Medium/Low | 2 |
| ... | ... | ... | ... |
| **Total Estimated Impact** | **$XX,XXX/month** | | |

---

## Prioritized Action Plan

### Quick Wins (This Week)
- [ ] [Action items with impact and effort]

### Medium-Term (This Month)
- [ ] [Action items]

### Strategic (This Quarter)
- [ ] [Action items]

---

## 30-60-90 Day Roadmap
[Week-by-week plan]

---

## Appendix
### Methodology
### Tools Used
### Glossary
### Data Sources

Key Principles

• This report should be impressive enough to use as a sales tool. A well-crafted marketing report can open the door to a client engagement.
• Always lead with insights and opportunities, not criticism. Frame everything through the lens of growth potential.
• Quantify everything possible. "$32,000/month in unrealized revenue" is more compelling than "you're leaving money on the table."
• Make the action plan so specific that someone could hand it to a junior marketer and they could execute it.
• Use professional formatting: consistent headers, tables for data, checkboxes for action items, clear visual hierarchy.
• If data from previous skills is available, reference specific findings. If not, be transparent about what's based on analysis vs estimation.
• The report should tell a story: Here's where you are, here's where you could be, here's how to get there, and here's what it's worth.

Constraints

MUST DO

• Verify all claims with data or sources
• Include actionable recommendations, not just observations
• Consider the target audience and business context
• Provide specific examples, not generic advice

MUST NOT DO

• Make claims without supporting evidence
• Ignore the user's specific business context
• Provide generic one-size-fits-all recommendations
• Skip competitive or market context when relevant

Verify before delivering (run this checklist)

The report is not "done" until every item passes:

• MARKETING-REPORT.md exists and renders (no broken tables, all 6 category sections present).
• Overall score recomputes exactly from the category scores × weights (0.25/0.20/0.15/0.15/0.15/0.10).
• Every category score equals the sum of its per-factor points (no arithmetic drift).
• Every finding, score, and revenue figure has a citation (source file file:line or URL) OR is explicitly labeled an estimate with its assumptions — zero uncited numbers.
• Revenue-impact totals in the summary table match the per-recommendation figures.
• Categories with no source data are flagged as estimates in the Appendix methodology, not hidden.
• The Top-3 priority actions trace to the highest verified revenue-impact recommendations.

If any box fails, fix it and re-run the checklist before reporting done.