
Investor Update Writer
- 160 installs
- 237 repo stars
- Updated July 15, 2026
- onewave-ai/claude-skills
Draft periodic investor updates with metrics, milestones, risks, and asks formatted for email newsletters or stakeholder decks.
About
Produces polished investor update drafts combining key metrics, milestone recaps, risk disclosures, and funding asks into email- or deck-ready formats for recurring stakeholder lifecycle communications.
- Metrics narrative
- Milestone recap
- Risk disclosure
- Funding asks
- Stakeholder formatting
Investor Update Writer by the numbers
- 160 all-time installs (skills.sh)
- +4 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #280 of 688 Office & Documents skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/onewave-ai/claude-skills --skill investor-update-writerAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 160 |
|---|---|
| repo stars | ★ 237 |
| Last updated | July 15, 2026 |
| Repository | onewave-ai/claude-skills ↗ |
What it does
Draft periodic investor updates with metrics, milestones, risks, and asks formatted for email newsletters or stakeholder decks.
Files
Investor Update Writer
Generate professional, honest, data-driven investor updates that keep investors informed and ready to help, with tone calibrated from seed-stage transparency to growth-stage formality.
Contents
references/output-template.md-- full investor-update.md structure to producereferences/tone-and-cadence.md-- voice by stage; monthly vs quarterly depthreferences/industry-metrics.md-- which metrics to emphasize by business modelreferences/sensitive-situations.md-- handling misses, departures, pivots, down rounds; mistakes to avoidreferences/examples.md-- worked request-to-approach examples
Workflow
1. Gather inputs. Collect or confirm: company basics (name, period, stage, industry); KPIs (revenue/MRR/ARR current and prior, burn, runway, customer count, growth rate, domain metrics); milestones and wins; challenges and learnings; financial summary (cash, revenue breakdown, expenses, fundraising status); upcoming milestones; and asks. Optional inputs include team changes, customer stories, competitive shifts, roadmap, cohort/retention data, and pipeline. Work with whatever is available and note gaps.
2. Calibrate tone and cadence. Select the voice for the company's stage and the depth for monthly vs quarterly. See references/tone-and-cadence.md. Honor any explicit tone request.
3. Select industry emphasis. Choose the metrics that matter for the business model. See references/industry-metrics.md.
4. Draft against the template. Produce investor-update.md following references/output-template.md. Add the date or period to the filename if the user prefers. Omit sections with no material content.
5. Apply the writing principles. Lead with the headline. Be honest about challenges and frame them with a response plan. Use numbers, not adjectives. Make it scannable with headers, bold, tables, and bullets. End with specific, actionable asks. Keep the format consistent period over period. Respect reader time (3-5 min monthly, deeper quarterly). Show trajectory with period-over-period comparisons. Use no emojis. Connect every metric to what it means for the business.
6. Handle sensitive content. For missed targets, departures, pivots, down rounds, or fundraising, follow references/sensitive-situations.md.
7. Integrate data sources. Given files or connected tools, extract and format automatically: parse CSV/spreadsheets for KPIs and trends; read prior updates for format consistency and period-over-period deltas; pull cash/burn/revenue/expenses from financial documents; pull pipeline, customer counts, deal values, and churn from CRM exports; incorporate usage, activation, and adoption from product analytics. Cross-reference extracted data with user-provided inputs and flag discrepancies.
8. Run the quality checklist. Confirm before delivering:
- TL;DR present, covering the 3-5 most important items
- Every KPI shows current and prior values with percentage change
- At least one challenge or learning described honestly
- Financial summary includes cash position, burn rate, and runway
- Upcoming milestones include specific dates and measurable criteria
- Asks section contains at least one specific, actionable request
- Tone matches company stage and user preference
- No emojis anywhere
- Dollar amounts and percentages formatted consistently
- Readable in under 5 minutes (monthly) or 10 minutes (quarterly)
- Previous-period milestones scored as hit, missed, or partial
- Confidentiality notice and contact information included
9. Remind on confidentiality. Every update includes a confidentiality notice. Advise the user to send via secure channels (not public links), use BCC or a dedicated platform for large lists, review for anything they are not comfortable sharing, and consider separate versions for different investor tiers.
Example Requests and Response Approaches
Example 1: Seed-stage monthly
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: 1. Use the seed-stage casual tone. 2. Calculate MoM growth (23.7%). 3. Structure with the full template but lighter depth. 4. Emphasize the strong growth rate as the lead. 5. Address 8% churn directly in challenges with context. 6. Flag runway as adequate but worth monitoring given burn. 7. Ask the user about specific asks for investors. 8. Generate the complete investor-update.md file.
Example 2: Series B quarterly board update
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: 1. Use the Series B formal tone. 2. Structure as a full quarterly report with trend data. 3. Lead with ARR and NRR strength. 4. Address the hiring miss and executive departure transparently in Challenges. 5. Include a detailed financial summary with expense breakdown. 6. Add multi-period trend analysis. 7. Include a milestone scorecard from Q3 commitments. 8. Generate a comprehensive board-ready document.
Example 3: Pre-revenue angel update
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: 1. Use the pre-seed casual tone. 2. Keep it concise -- aim for 600-800 words. 3. Lead with the beta launch as the headline. 4. Focus on qualitative user feedback and engagement signals. 5. Be transparent about pre-revenue status and path to monetization. 6. Flag the 8-month runway and any fundraising plans. 7. Ask for beta testers, introductions, or feedback channels. 8. Generate a shorter, narrative-style update.
Industry-Specific Metrics
Emphasize the metrics that matter for the company's business model.
SaaS / Software
- Emphasize MRR, ARR, NRR, churn, CAC, LTV
- Include logo count and expansion revenue
- Report on activation and feature adoption
- Track sales cycle length and ACV trends
Marketplace / Platform
- Emphasize GMV, take rate, liquidity metrics
- Report supply and demand side separately
- Track matching efficiency and repeat usage
- Include geographic or vertical expansion data
Hardware / Deep Tech
- Emphasize development milestones and technical progress
- Report on supply chain and manufacturing
- Track unit economics and BOM cost
- Include regulatory or certification progress
Consumer / B2C
- Emphasize DAU/MAU, engagement, retention curves
- Report on acquisition channels and CAC by channel
- Track viral coefficient and organic growth
- Include cohort analysis
Biotech / Life Sciences
- Emphasize clinical milestones and regulatory progress
- Report on IP portfolio and patent status
- Track partnership and licensing pipeline
- Include scientific advisory board activity
Investor Update Output Template
Generate the update as a markdown file named investor-update.md (add the date or period to the filename if the user prefers). Adapt depth and formality to the company stage. Omit sections that have no material content for the period.
# [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. Give a complete picture in 30 seconds. Each bullet is 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 this period. 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 -- "Growth" for PLG, "Sales" for enterprise, "Marketplace" for platforms.]
### 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
[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.*Handling Sensitive Situations
Missed Targets
- State the miss clearly with exact numbers
- Explain root cause without making excuses
- Describe corrective action with specific steps
- Set revised expectations with a clear timeline
Fundraising
- If actively raising, state it directly with timeline and progress
- If not raising, say so to prevent speculation
- Never misrepresent traction or financials
- Be clear about bridge financing needs if relevant
Founder or Executive Departure
- Address directly in the update; do not let investors hear it elsewhere
- Explain the transition plan
- Emphasize continuity and stability
- Provide a timeline for replacement if applicable
Pivot or Major Strategy Change
- Frame the data and learnings that led to the decision
- Explain the new direction with conviction and specificity
- Acknowledge what is being left behind
- Set new milestones aligned to the updated strategy
Down Round or Restructuring
- Lead with the facts and timeline
- Explain the business rationale
- Detail the path to recovery with milestones
- Be explicit about what the company needs from investors
Common Mistakes to Avoid
1. All highlights, no challenges. Investors see through one-sided updates and lose trust. 2. Vanity metrics. Report metrics that matter to the business, not ones that look impressive on the surface. 3. No asks. Every update should include at least one specific, actionable request. 4. Inconsistent format. Changing the format each month makes it hard to track progress. 5. Too long. Monthly updates over 2000 words lose readers. Stay disciplined. 6. Too infrequent. Monthly is the standard cadence. Quarterly is the minimum. Going silent damages trust. 7. Burying bad news. Put challenges in their own section, visibly. Do not hide them in footnotes. 8. No numbers. Qualitative statements without quantitative backing are not useful. 9. Stale data. Send updates within the first week of the new period while data is fresh. 10. Generic asks. "Help us with introductions" is not actionable. "We are looking for an introduction to the VP of Engineering at Acme Corp because they match our ICP" is.
Tone and Cadence Calibration
Tone by Stage
Adjust voice, structure, and level of detail based on company stage. Honor an explicit tone request from the user if given.
Pre-Seed / Seed (Casual Transparency)
- First-person voice, founder speaking directly
- Conversational but not sloppy
- High emphasis on learnings and pivots
- Acceptable to express uncertainty honestly
- Shorter format, less formal structure
- Focus on discovery metrics and product-market fit signals
- Address investors as partners in the journey
- Example opening: "Hi everyone -- here is our January update. It was a month of real progress on the product side, though sales took longer than we hoped."
Series A (Professional Clarity)
- More structured and data-forward
- Balance between narrative and metrics
- Clear section headers and organized flow
- Specific targets and accountability
- Professional but still personal
- Include comparative data (MoM, QoQ)
- Example opening: "Team -- please find below our Q1 update. We closed the quarter at $X ARR, representing Y% QoQ growth, and made significant progress on our enterprise pipeline."
Series B and Beyond (Board-Ready Formality)
- Highly structured executive communication
- Lead with scorecard and KPI dashboard
- Detailed financial reporting
- Strategic context and market positioning
- Department-level breakdowns
- Forward-looking guidance with scenarios
- Example opening: "Dear Investors and Board Members, I am pleased to share our Q1 FY2026 operating update. The company delivered $X.XM in revenue, exceeding plan by Z%, while maintaining disciplined cost management."
Cadence
Monthly Updates
- Keep it shorter (aim for 800-1200 words in the final output)
- Go lighter on financial detail -- cash position and burn are sufficient
- Skip departmental breakdowns unless there is material news
- Focus on momentum indicators and near-term milestones
- Abbreviate the pipeline summary
- Treat trend tables as optional
Quarterly Updates
- Provide full depth on all sections (1500-2500 words)
- Include multi-period trend data
- Provide deeper financial analysis with expense breakdown
- Include department-level reporting
- Add strategic context and market commentary
- Add a scenario planning or outlook section
- Provide full pipeline and retention analysis
- Report year-to-date progress against the annual plan