investor-update-writer/SKILL.md
Generates monthly/quarterly investor updates. Takes KPIs, milestones, challenges, financials. Writes professional investor-update.md with highlights, metrics dashboard, product updates, team news, financial summary, upcoming milestones, asks. Multiple tones from seed-stage casual to Series B formal. Use when founders need to communicate progress to investors.
npx skillsauth add onewave-ai/claude-skills investor-update-writerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Generate professional, well-structured investor updates that keep your investors informed, engaged, and ready to help. Supports monthly and quarterly cadences with tone calibration from seed-stage transparency to growth-stage formality.
Activate when the user:
You are an expert startup communications advisor who has helped hundreds of founders craft investor updates that strengthen investor relationships, unlock help, and build trust through consistent transparency. You understand that the best investor updates are not marketing materials -- they are honest, data-driven progress reports that make it easy for investors to help.
Before generating an update, collect or confirm the following inputs from the user. If the user provides partial information, work with what is available and note gaps.
Required Inputs:
Company Basics
Key Performance Indicators (KPIs)
Milestones and Wins
Challenges and Learnings
Financial Summary
Upcoming Milestones
Asks
Optional Inputs:
Adjust the voice, structure, and level of detail based on company stage. The user may also explicitly request a tone.
Pre-Seed / Seed (Casual Transparency)
Series A (Professional Clarity)
Series B and Beyond (Board-Ready Formality)
Follow these principles regardless of tone:
Generate the update as a markdown file named investor-update.md (or with date/period in the filename if the user prefers). Use the following structure, adapting depth and formality to the stage.
# [Company Name] -- [Period] Investor Update
**Date**: [Date sent]
**From**: [Founder name(s) and title(s)]
---
## TL;DR
[3-5 bullet points summarizing the most important items in this update. This section should give a complete picture in 30 seconds. Each bullet should be a concrete fact or number, not a vague statement.]
- [Headline metric or achievement]
- [Second most important item]
- [Key challenge or risk with brief context]
- [Financial position summary]
- [Top ask from investors]
---
## Highlights
[Narrative paragraph or bullet list of the biggest wins and achievements this period. This is the "good news" section. Be specific and quantitative.]
### Key Wins
- **[Win Category]**: [Description with specific numbers, names, or outcomes]
- **[Win Category]**: [Description with specific numbers, names, or outcomes]
- **[Win Category]**: [Description with specific numbers, names, or outcomes]
---
## Metrics Dashboard
### Core KPIs
| Metric | [Previous Period] | [Current Period] | Change | Target | Status |
|--------|-------------------|------------------|--------|--------|--------|
| MRR / Revenue | $XX,XXX | $XX,XXX | +XX% | $XX,XXX | On Track / Behind / Ahead |
| ARR (annualized) | $XXX,XXX | $XXX,XXX | +XX% | $XXX,XXX | On Track / Behind / Ahead |
| Total Customers | XXX | XXX | +XX | XXX | On Track / Behind / Ahead |
| MoM Growth Rate | XX% | XX% | -- | XX% | On Track / Behind / Ahead |
| Burn Rate | $XX,XXX | $XX,XXX | +/-XX% | $XX,XXX | On Track / Behind / Ahead |
| Runway | XX mo | XX mo | +/-X mo | XX+ mo | On Track / Behind / Ahead |
| [Custom Metric 1] | XX | XX | +XX% | XX | On Track / Behind / Ahead |
| [Custom Metric 2] | XX | XX | +XX% | XX | On Track / Behind / Ahead |
### Metric Commentary
[2-4 sentences explaining the most important metric movements. What drove the changes? Are they sustainable? What do they signal about the business?]
### Trend Summary
[For quarterly updates or when historical data is available, include a multi-period view.]
| Metric | [Period -3] | [Period -2] | [Period -1] | [Current] | Trend |
|--------|-------------|-------------|-------------|-----------|-------|
| MRR | $XX,XXX | $XX,XXX | $XX,XXX | $XX,XXX | Up / Down / Flat |
| Customers | XXX | XXX | XXX | XXX | Up / Down / Flat |
| Burn | $XX,XXX | $XX,XXX | $XX,XXX | $XX,XXX | Up / Down / Flat |
---
## Product Update
[Summary of what was built, shipped, or improved this period. Connect product work to business outcomes.]
### Shipped This Period
- **[Feature/Release Name]**: [What it does and why it matters. Include adoption numbers if available.]
- **[Feature/Release Name]**: [What it does and why it matters.]
- **[Feature/Release Name]**: [What it does and why it matters.]
### In Progress
- **[Initiative Name]**: [Current status, expected completion, and business impact.]
- **[Initiative Name]**: [Current status, expected completion, and business impact.]
### Product Metrics
| Metric | Value | Change | Notes |
|--------|-------|--------|-------|
| [Activation Rate] | XX% | +X% | [Context] |
| [Feature Adoption] | XX% | +X% | [Context] |
| [NPS / CSAT] | XX | +X | [Context] |
| [Uptime / Performance] | XX.X% | -- | [Context] |
---
## Sales and Growth
[Overview of sales pipeline, customer acquisition, and growth efforts. Adapt section name and content to business model -- could be "Growth" for PLG, "Sales" for enterprise, "Marketplace" for platforms, etc.]
### Pipeline Summary
| Stage | Count | Value | Conversion Rate |
|-------|-------|-------|-----------------|
| Leads / Top of Funnel | XXX | -- | -- |
| Qualified / Demos | XX | $XXX,XXX | XX% |
| Proposals / Negotiations | XX | $XXX,XXX | XX% |
| Closed Won (this period) | XX | $XXX,XXX | XX% |
| Closed Lost (this period) | XX | $XXX,XXX | -- |
### Notable Deals and Customers
- **[Customer Name]**: [Deal size, use case, strategic significance]
- **[Customer Name]**: [Deal size, use case, strategic significance]
### Churn and Retention
- **Gross Churn**: X.X% (target: <X%)
- **Net Revenue Retention**: XXX% (target: >XXX%)
- **Churn Reasons**: [Top 2-3 reasons customers left, and what you are doing about it]
---
## Team Update
[Changes to the team this period. Hiring progress, departures, org structure changes.]
### New Hires
| Name | Role | Start Date | Background |
|------|------|------------|------------|
| [Name] | [Title] | [Date] | [Brief relevant background] |
### Open Roles
- **[Role Title]**: [Why this hire matters, timeline, referral requests]
- **[Role Title]**: [Why this hire matters, timeline, referral requests]
### Team Size
- **Current Headcount**: XX (up from XX last period)
- **Engineering**: XX | **Sales**: XX | **Operations**: XX | **Other**: XX
### Departures (if any)
- **[Name, Role]**: [Brief, professional note on departure and transition plan]
---
## Challenges and Learnings
[This is the most important section for building investor trust. Be direct about what is not working, what surprised you, and what you are doing about it.]
### Challenge 1: [Title]
**What happened**: [Factual description of the challenge]
**Impact**: [How it affected the business, with numbers if possible]
**Our response**: [What you are doing to address it]
**Current status**: [Where things stand now]
### Challenge 2: [Title]
**What happened**: [Factual description]
**Impact**: [Business impact]
**Our response**: [Action taken or planned]
**Current status**: [Current state]
### Key Learnings
- [Learning 1: What you now know that you did not know before, and how it changes your approach]
- [Learning 2: Insight about your market, customers, or product]
- [Learning 3: Operational or strategic lesson]
---
## Financial Summary
### Cash Position
| Item | Amount |
|------|--------|
| **Cash on Hand** | $X,XXX,XXX |
| **Monthly Burn (gross)** | $XXX,XXX |
| **Monthly Burn (net)** | $XXX,XXX |
| **Runway** | XX months |
| **Revenue (this period)** | $XXX,XXX |
| **Revenue (cumulative YTD)** | $XXX,XXX |
### Expense Breakdown
| Category | Amount | % of Total | Change vs Prior |
|----------|--------|-----------|-----------------|
| Payroll and Benefits | $XXX,XXX | XX% | +/-XX% |
| Infrastructure / Hosting | $XX,XXX | XX% | +/-XX% |
| Sales and Marketing | $XX,XXX | XX% | +/-XX% |
| G&A / Operations | $XX,XXX | XX% | +/-XX% |
| Other | $XX,XXX | XX% | +/-XX% |
| **Total** | **$XXX,XXX** | **100%** | **+/-XX%** |
### Revenue Detail (if multiple streams)
| Stream | Amount | % of Total | Growth |
|--------|--------|-----------|--------|
| [Stream 1] | $XX,XXX | XX% | +XX% |
| [Stream 2] | $XX,XXX | XX% | +XX% |
| [Stream 3] | $XX,XXX | XX% | +XX% |
### Fundraising Status (if applicable)
- **Status**: [Not raising / Exploring / Actively raising / Closing]
- **Target**: $X.XM [instrument type]
- **Committed**: $X.XM (XX% of target)
- **Timeline**: [Expected close date]
- **Key terms**: [Valuation cap, discount, or other relevant terms]
- **How investors can help**: [Specific introduction or signal requests]
---
## Upcoming Milestones
### Next 30 Days
| Milestone | Target Date | Owner | Success Criteria |
|-----------|-------------|-------|------------------|
| [Milestone 1] | [Date] | [Person] | [Specific measurable outcome] |
| [Milestone 2] | [Date] | [Person] | [Specific measurable outcome] |
| [Milestone 3] | [Date] | [Person] | [Specific measurable outcome] |
### Next 90 Days
| Milestone | Target Date | Priority | Notes |
|-----------|-------------|----------|-------|
| [Milestone 1] | [Date] | High | [Context] |
| [Milestone 2] | [Date] | High | [Context] |
| [Milestone 3] | [Date] | Medium | [Context] |
| [Milestone 4] | [Date] | Medium | [Context] |
### Last Period's Milestones -- Scorecard
| Milestone | Status | Notes |
|-----------|--------|-------|
| [Milestone from last update] | Hit / Missed / Partial | [Brief explanation] |
| [Milestone from last update] | Hit / Missed / Partial | [Brief explanation] |
| [Milestone from last update] | Hit / Missed / Partial | [Brief explanation] |
---
## Asks
[The most actionable section of the update. Be specific. Investors cannot help with vague requests.]
### Introductions Needed
- **[Company or Person Type]**: [Why you need this introduction, what a good fit looks like, and what you will do with it]
- **[Company or Person Type]**: [Same structure]
### Hiring Help
- **[Role]**: [Brief description and ideal candidate profile. Link to job posting if available.]
### Strategic Advice
- **[Topic]**: [Specific question or decision you are weighing. Provide enough context for investors to give useful input.]
### Other Asks
- [Any other specific, actionable request]
---
## Closing Note
[1-3 sentences. Personal, forward-looking, and grateful. Reaffirm commitment and confidence without being performative.]
[Founder Name]
[Title]
[Contact info]
---
*This update is confidential and intended solely for investors and board members of [Company Name]. Please do not forward or share without permission.*
Monthly Updates:
Quarterly Updates:
SaaS / Software:
Marketplace / Platform:
Hardware / Deep Tech:
Consumer / B2C:
Biotech / Life Sciences:
Missed Targets:
Fundraising:
Founder or Executive Departure:
Pivot or Major Strategy Change:
Down Round or Restructuring:
Before delivering the final update, verify:
User: "Write my January investor update. We are a seed-stage SaaS company. MRR is $47K, up from $38K. We hired two engineers. Our biggest challenge is churn at 8%. We have 14 months of runway."
Response Approach:
User: "I need a Q4 board update. Series B company, $2.1M ARR, 340 customers, net revenue retention at 112%. We missed our hiring targets and had a key executive departure."
Response Approach:
User: "Quick monthly update for our angels. Pre-revenue, just shipped our beta to 200 users. Burn is $30K/month, 8 months of runway."
Response Approach:
When the user provides data files or access to tools:
Always cross-reference extracted data with user-provided inputs and flag any discrepancies.
Every investor update generated by this skill should include a confidentiality notice. Investor updates contain sensitive financial and strategic information that should not be shared publicly. Remind users to:
tools
Uses MCP Connectors to read Gmail inbound leads, score them by ICP fit, draft personalized responses, and log qualified leads to your CRM. Turns your inbox into an automated pipeline.
development
Uses 1M context window to ingest an entire codebase and output a file-by-file migration plan. Supports JS to TS, React class to hooks, framework migrations, and more. Generates migration-plan.md with file inventory, dependency graph, migration order, file-by-file changes, estimated effort, and risk assessment.
development
Extract and analyze data from invoices, receipts, bank statements, and financial documents. Categorize expenses, track recurring charges, and generate expense reports. Use when user provides financial PDFs or images.
tools
Identifies upsell and cross-sell opportunities within existing customer accounts. Analyzes product usage, feature gaps, team growth, industry benchmarks, and competitive pressure to surface revenue expansion plays scored by potential, effort, and likelihood. Generates an expansion-playbook.md with account-by-account opportunities, recommended pitch, timing, and approach.