Skip to content

Commit d4e5bc5

Browse files
Annette Faynburdclaude
andcommitted
add role picker and personalized paths to carta-investors tutorial
Section 1 now asks the user to identify as GP, CFO/Controller, or Deal Team (1/2/3), then shows a role-specific use case table, key tables, and "start here" prompts tailored to that persona. Section 4 demo and Section 7 wrap-up cheat sheet also branch on the selected role. Automatic role detection from firm settings is not yet available via the carta MCP — this is noted as a future improvement once the firm people endpoint is exposed. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 658d1b6 commit d4e5bc5

1 file changed

Lines changed: 252 additions & 50 deletions

File tree

  • plugins/carta-investors/skills/carta-investors-tutorial

plugins/carta-investors/skills/carta-investors-tutorial/SKILL.md

Lines changed: 252 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22
name: carta-investors-tutorial
33
description: >
44
Interactive 5-minute walkthrough of the carta-investors plugin. Covers what's possible with
5-
your firm's data, a live snapshot of your firm, and 3 real-world scenarios: year-end reporting,
6-
fundraising benchmarks, and LP meeting prep. Trigger with: "investors tutorial", "show me the
7-
tutorial", "getting started with investors plugin", "how do I use the investors plugin", "demo",
5+
your firm's data, a live snapshot of your firm, and 3 real-world scenarios personalized to
6+
your role. Trigger with: "investors tutorial", "show me the tutorial",
7+
"getting started with investors plugin", "how do I use the investors plugin", "demo",
88
"walk me through the investors plugin", "what can I do with carta", "how does this work".
99
allowed-tools:
1010
- Bash(carta auth-status)
@@ -21,52 +21,159 @@ You are running the **carta-investors plugin tutorial**. This is an interactive,
2121
walkthrough — pause after each section and wait for the user to say "next", "continue", or
2222
press Enter before proceeding.
2323

24+
**Important:** Track the user's role selection from Section 1 — use it to personalize
25+
Section 4 (the demo scenario) and Section 7 (the wrap-up cheat sheet).
26+
2427
---
2528

2629
## Section 0: Welcome
2730

2831
Welcome to **carta-investors** — your AI-powered data layer, connected directly to your firm's
2932
complete data in Carta's data warehouse.
3033

31-
In the next 5 minutes you'll see what's possible, get a live snapshot of your firm's data, and
32-
walk through three scenarios fund managers use every day.
34+
This isn't a dashboard or a report template. It's a live connection to your fund financials,
35+
portfolio companies, LP capital accounts, benchmarks, and more. Whatever question you'd normally
36+
take to a spreadsheet or a finance team, you can ask here.
37+
38+
In the next 5 minutes you'll see what's possible for your specific role, get a live snapshot of
39+
your firm's data, and walk through three real scenarios.
3340

3441
Say **"next"** to start.
3542

3643
---
3744

38-
## Section 1: What's Possible
45+
## Section 1: What Can I Do? (Role Picker)
46+
47+
The data warehouse covers a lot of ground — fund financials, portfolio companies, LP accounts,
48+
benchmarks, regulatory data. The most useful starting point depends on who you are.
49+
50+
**Which best describes your role?**
51+
52+
```
53+
1 — GP / Managing Partner
54+
2 — CFO / Controller / Fund Finance
55+
3 — Deal Team / Investment Team
56+
```
57+
58+
Type a number (or just describe your role) and I'll show you what's most relevant for you.
59+
60+
---
61+
62+
### Path 1A — GP / Managing Partner
63+
64+
Fund managers use carta-investors most for three things: understanding how their funds are
65+
performing relative to peers, getting a real-time portfolio view before LP conversations, and
66+
tracking deployment and returns over time.
67+
68+
**What you can do:**
69+
70+
| Use Case | Example Prompt |
71+
|---|---|
72+
| **Fund performance vs. peers** | "How does Fund III compare to 2019 vintage VCs on IRR, TVPI, and DPI? Show me percentiles." |
73+
| **Portfolio snapshot for an LP call** | "I have a call with [LP name] in an hour — show me their account, the fund NAV, and our benchmark standing." |
74+
| **Top performers and laggards** | "Rank all active investments by MOIC. Which are in the top and bottom quartile?" |
75+
| **NAV trend over time** | "Show me quarterly NAV for each fund from 2022 to today." |
76+
| **Deployment pace** | "How much capital have we called vs. total commitment by fund? How much is left to deploy?" |
77+
| **Unrealized value by company** | "What's our total unrealized FMV broken down by portfolio company?" |
78+
| **Concentration analysis** | "What's our portfolio breakdown by stage and geography?" |
79+
| **Fundraising deck data** | "Pull IRR, TVPI, and DPI for Fund II and III vs. peer percentiles — formatted for a deck." |
80+
81+
**Key tables you'll use most:**
82+
- `TEMPORAL_FUND_COHORT_BENCHMARKS` — IRR/TVPI/DPI percentiles by vintage year and AUM bucket
83+
- `AGGREGATE_INVESTMENTS` — active portfolio, cost basis, FMV, MOIC
84+
- `MONTHLY_NAV_CALCULATIONS` — NAV, contributions, distributions, DPI, TVPI over time
85+
- `PARTNER_DATA` — LP account details for investor call prep
86+
87+
**Early adopter patterns:** GPs are using this to pull benchmarking data minutes before an LP
88+
meeting, build full portfolio MOIC rankings before board meetings, and track NAV and DPI trends
89+
across all funds in a single query. The benchmarking table (`TEMPORAL_FUND_COHORT_BENCHMARKS`)
90+
is the most valuable discovery — most people don't know it exists until they find it here.
91+
92+
**Start here:**
93+
- *"How does [fund name] compare to peers?"*
94+
- *"Show me all active investments ranked by MOIC."*
95+
- *"What's the NAV trend for all our funds over the last 8 quarters?"*
96+
97+
Say **"next"** to see your firm's data.
98+
99+
---
100+
101+
### Path 1B — CFO / Controller / Fund Finance
39102

40-
This isn't a dashboard or a report template — it's a direct connection to everything your firm
41-
has on Carta. Whatever question you'd normally take to a spreadsheet, a finance team, or a Carta
42-
support ticket, you can ask here instead.
103+
Fund finance teams use carta-investors most for year-end reporting, LP capital account
104+
management, and pulling audit-ready data without waiting on Carta exports or support tickets.
43105

44-
Here's what fund managers are doing with it:
106+
**What you can do:**
45107

46108
| Use Case | Example Prompt |
47109
|---|---|
48-
| **Year-end financial reporting** | "Pull NAV, contributions, distributions, and expenses by account for all funds — 2025 year-end" |
49-
| **Portfolio company KPI dashboard** | "Show me revenue, gross margin, and headcount for all active portfolio companies as of Q4 2025" |
50-
| **Fundraising deck data** | "How does Fund III compare to peers on IRR, TVPI, and DPI? Show me percentiles by vintage year" |
51-
| **LP meeting prep** | "I have a call with [LP name] in an hour — pull their commitment, contributions, distributions, and current NAV" |
52-
| **Capital call reconciliation** | "For the Q1 2025 capital call — show me called vs. contributed per LP and flag any gaps" |
53-
| **Year-end portfolio snapshot** | "What did our portfolio look like at December 31, 2025? Cost basis, FMV, and unrealized gain/loss per company" |
54-
| **LP geography and segmentation** | "Which of our LPs are based in California? What's their total commitment across all funds?" |
55-
| **New investment tracking** | "What investments did we make in 2025? Show first close date, invested amount, and fund" |
56-
| **K-1 and tax prep** | "Pull total contributions, distributions, and income allocations per LP across all funds for 2025" |
57-
| **Tear sheets for LP reporting** | "Download tear sheets for all active portfolio companies in Fund II" |
58-
59-
Every one of these pulls live data from your firm's Carta account — fund financials, investment
60-
history, LP capital accounts, portfolio company metrics, and peer benchmarks. No exports, no
61-
spreadsheets. Just ask.
62-
63-
Real patterns from early adopters: teams have used this to tackle year-end financial reporting
64-
across multiple funds in a single session, build full portfolio summaries ahead of board meetings,
65-
run capital call reconciliation for the first time without a spreadsheet, and pull LP account
66-
snapshots minutes before an investor call. The most common starting point across every firm:
67-
exploring what tables are available and then going deep on one fund.
68-
69-
Say **"next"** to see a live snapshot of your firm.
110+
| **Year-end financial reporting** | "Pull NAV, contributions, distributions, and total expenses by account for all funds — 2025 year-end." |
111+
| **LP capital account statements** | "Show me contributions, distributions, and ending NAV per LP for Fund II as of December 31, 2025." |
112+
| **Capital call reconciliation** | "For the Q1 2025 capital call — show me amount called vs. contributed per LP and flag any outstanding." |
113+
| **Expenses by account** | "What were total management fees, admin expenses, and fund expenses for 2025, by fund?" |
114+
| **Journal entry review** | "Show me all journal entries posted to Fund III in Q4 2025, grouped by account type." |
115+
| **Outstanding receivables** | "Which LPs have outstanding receivables? Show amounts and aging." |
116+
| **Regulatory AUM (Form ADV)** | "What's our total AUM as of December 31, 2025 across all funds and SPVs?" |
117+
| **K-1 prep** | "Pull total contributions, distributions, and income allocations per LP across all funds for 2025." |
118+
119+
**Key tables you'll use most:**
120+
- `JOURNAL_ENTRIES` — all GL activity; cash, cost of investment, income, liabilities
121+
- `MONTHLY_NAV_CALCULATIONS` — NAV, contributions, distributions per fund per month
122+
- `PARTNER_DATA` — LP commitment, contributed capital, distributions, NAV
123+
- `STATEMENT_OF_OPS` — P&L / income statement data
124+
- `ALLOCATIONS` — capital call detail; called vs. contributed per LP
125+
126+
**Early adopter patterns:** Finance controllers are using this to pull year-end fund financials
127+
across all funds in one session — NAV, contributions, distributions, and expenses by account —
128+
work that used to take hours of export-and-stitch. Capital call reconciliation (called vs.
129+
contributed per LP) is one of the most-used queries; most teams hadn't thought to query
130+
`ALLOCATIONS` directly before.
131+
132+
**Start here:**
133+
- *"Pull year-end 2025 financials for all our funds — NAV, contributions, distributions, expenses."*
134+
- *"Show me capital called vs. contributed per LP for the most recent capital call."*
135+
- *"What are our outstanding LP receivables?"*
136+
137+
Say **"next"** to see your firm's data.
138+
139+
---
140+
141+
### Path 1C — Deal Team / Investment Team
142+
143+
Investment teams use carta-investors most for portfolio company financial analysis, sector and
144+
geography breakdowns, and building the kind of data views that usually require custom exports or
145+
waiting on the finance team.
146+
147+
**What you can do:**
148+
149+
| Use Case | Example Prompt |
150+
|---|---|
151+
| **Portfolio company KPIs** | "Show me trailing revenue, gross margin, and EBITDA for all active portfolio companies as of Q4 2025." |
152+
| **Geography-based analysis** | "Which of our portfolio companies are based in Brazil? What's their combined revenue?" |
153+
| **Sector and stage breakdown** | "Break down our active portfolio by sector and stage — count and total FMV for each." |
154+
| **Entry vs. current valuation** | "Compare entry post-money valuation vs. current valuation for all active investments." |
155+
| **Best and worst performers** | "Rank all active investments by MOIC. Which are at write-off risk?" |
156+
| **New investments this year** | "What investments did we make in 2025? Show company, amount, fund, and first close date." |
157+
| **Follow-on tracking** | "Which portfolio companies have received follow-on from us? Show total invested by round." |
158+
| **Revenue by region** | "What's the most recent annual revenue for all our companies headquartered in Latin America?" |
159+
160+
**Key tables you'll use most:**
161+
- `COMPANY_FINANCIALS` — revenue, EBITDA, gross margin, headcount per portfolio company per period
162+
- `AGGREGATE_INVESTMENTS` — investment details, FMV, MOIC, entry valuation, geography, sector
163+
- `AGGREGATE_INVESTMENTS_HISTORY` — point-in-time portfolio data for any historical date
164+
- `JOURNAL_ENTRIES` — cost basis, unrealized gains, investment-level GL activity
165+
166+
**Early adopter patterns:** Deal teams are using this to build full portfolio summaries before
167+
board meetings — cost basis, FMV, and first wire date per company — work that used to require
168+
requesting a data export. Geography and sector queries are a standout: you can ask "show me all
169+
portfolio companies in Southeast Asia with revenue over $10M" and get an answer in seconds.
170+
171+
**Start here:**
172+
- *"Show me trailing revenue and gross margin for all active portfolio companies — Q4 2025."*
173+
- *"Which of our active investments are headquartered in [region]?"*
174+
- *"Rank all investments by MOIC and show entry valuation vs. current."*
175+
176+
Say **"next"** to see your firm's data.
70177

71178
---
72179

@@ -153,15 +260,19 @@ Say **"next"** to start the demo.
153260

154261
---
155262

156-
## Section 4: Demo — Scenario 1: Fundraising Benchmarks
263+
## Section 4: Demo — Scenario 1 (Role-Adaptive)
264+
265+
Show the scenario that matches the role the user picked in Section 1. If uncertain, use 4A.
266+
267+
---
268+
269+
### Scenario 1A — GP: Fundraising Benchmarks
157270

158271
**The situation:** You're raising Fund IV and have an LP intro call next week. They'll ask how
159272
Fund III performed. Let's see how it stacks up against peers.
160273

161274
> *Imagine you just asked: "How does Redwood Growth Fund III compare to peers?"*
162275
163-
Here's what the plugin would return:
164-
165276
```
166277
Redwood Growth Fund III — Performance vs. Peers
167278
Vintage Year: 2019 | AUM Bucket: $100M–$500M | Entity Type: VC
@@ -175,10 +286,65 @@ DPI 0.6x 0.0x 0.1x 0.3x 0.6x 1.1x
175286
Standing: Net IRR — 78th percentile (Top Quartile)
176287
```
177288

178-
Fund III is in the **top quartile** for its vintage. That's a headline number you can lead
179-
with on the LP call — or drop straight into a fundraising deck.
289+
Fund III is in the **top quartile** for its vintage — that's your headline number for the LP
290+
call and your fundraising deck.
291+
292+
To run this for real: *"How does [your fund name] compare to peers?"*
293+
294+
Say **"next"** for Scenario 2.
295+
296+
---
297+
298+
### Scenario 1B — CFO: Year-End Financial Reporting
299+
300+
**The situation:** It's early January. You need year-end 2025 fund financials for your
301+
accountants and LP annual reports. Instead of pulling reports from the UI and stitching
302+
together spreadsheets, you ask.
303+
304+
> *Imagine you asked: "Pull year-end 2025 financials for all our funds."*
305+
306+
```
307+
Year-End 2025 — Fund Summary (3 funds)
308+
309+
Redwood I Redwood II Redwood III
310+
──────────────────────────────────────────────────────────────
311+
NAV (Dec 31) $42.3M $89.1M $31.7M
312+
Contributions (YTD) $4.1M $12.0M $8.4M
313+
Distributions (YTD) $6.2M $0.0M $0.0M
314+
Mgmt Fee Expense $0.4M $0.9M $0.3M
315+
```
316+
317+
Then Claude asks: *"Want me to break this down by LP, or pull the journal entries for audit?"*
318+
319+
To run this for real: *"Pull year-end [year] financials for all our funds."*
320+
321+
Say **"next"** for Scenario 2.
322+
323+
---
324+
325+
### Scenario 1C — Deal Team: Portfolio Company KPI Query
326+
327+
**The situation:** Your GP is preparing for a board meeting and needs a current snapshot of all
328+
portfolio companies — revenue trend, gross margin, and FMV. You pull it in one ask.
329+
330+
> *Imagine you asked: "Show me trailing revenue, gross margin, and FMV for all active portfolio
331+
> companies as of Q4 2025."*
332+
333+
```
334+
Active Portfolio — Q4 2025
335+
336+
Company Revenue (TTM) Gross Margin FMV
337+
────────────────────────────────────────────────────────────
338+
Nova Dynamics $14.2M 68% $18.4M
339+
Maple Street Health $8.7M 55% $9.1M
340+
ClearPath Logistics $22.1M 41% $11.3M
341+
Ridgewater AI $3.4M 74% $7.8M
342+
...
343+
```
344+
345+
Then Claude asks: *"Want me to add entry valuation and MOIC, or filter to a specific sector?"*
180346

181-
To run this for real, just ask: *"How does [your fund name] compare to peers?"*
347+
To run this for real: *"Show me revenue and gross margin for all active portfolio companies."*
182348

183349
Say **"next"** for Scenario 2.
184350

@@ -261,22 +427,58 @@ Say **"next"** to wrap up.
261427

262428
---
263429

264-
## Section 7: Wrap-Up
430+
## Section 7: Wrap-Up (Role-Adaptive)
265431

266-
Here's a quick reference for the most common workflows:
432+
Show the cheat sheet that matches the user's role from Section 1. If uncertain, show all three.
433+
434+
---
435+
436+
### Wrap-Up 7A — GP
437+
438+
| What you want | How to ask |
439+
|---|---|
440+
| Fund performance vs. peers | "How does [fund] compare to peers on IRR, TVPI, DPI?" |
441+
| Portfolio MOIC ranking | "Rank all active investments by MOIC" |
442+
| NAV trend over time | "Show quarterly NAV for all funds from [year] to today" |
443+
| Deployment pace | "How much capital has been called vs. total commitment by fund?" |
444+
| LP call prep | "I have a call with [LP name], get me ready" |
445+
| Fundraising benchmarks | "Show IRR/TVPI/DPI percentiles for [fund] vs. [vintage] peers" |
446+
| Portfolio snapshot | "Show all active investments — cost, FMV, MOIC, unrealized gain" |
447+
| Concentration analysis | "Break down the portfolio by stage and geography" |
448+
449+
---
450+
451+
### Wrap-Up 7B — CFO / Controller
267452

268453
| What you want | How to ask |
269454
|---|---|
270-
| Year-end fund financials | "Pull year-end [year] financials for all our funds" |
271-
| Portfolio snapshot | "Show me all active investments — cost, FMV, IRR" |
272-
| Fundraising benchmarks | "How does [fund] compare to peers?" |
273-
| LP account summary | "I have a call with [LP name], get me ready" |
274-
| Capital call reconciliation | "Show called vs contributed per LP for the [date] call" |
275-
| Point-in-time portfolio | "What did our portfolio look like at December 31, 2025?" |
276-
| LP geography | "Which of our LPs are based in [state/country]?" |
277-
| Tear sheets | "Download tear sheets for all active portcos in [fund name]" |
278-
279-
The more specific you are — fund name, date range, LP name — the sharper the output.
455+
| Year-end fund financials | "Pull year-end [year] NAV, contributions, distributions, and expenses for all funds" |
456+
| LP capital account statements | "Show contributions, distributions, and ending NAV per LP for [fund] as of [date]" |
457+
| Capital call reconciliation | "Show called vs. contributed per LP for the [date] capital call" |
458+
| Journal entry review | "Show all journal entries for [fund] in Q4 [year] grouped by account" |
459+
| Outstanding receivables | "Which LPs have outstanding receivables?" |
460+
| Regulatory AUM | "What's our total AUM as of December 31, [year]?" |
461+
| Expense breakdown | "What were total management fees and expenses by fund for [year]?" |
462+
| K-1 prep | "Pull contributions, distributions, and income allocations per LP for [year]" |
463+
464+
---
465+
466+
### Wrap-Up 7C — Deal Team
467+
468+
| What you want | How to ask |
469+
|---|---|
470+
| Portfolio company KPIs | "Show trailing revenue, gross margin, and EBITDA for all active portcos as of Q4 [year]" |
471+
| Geography filter | "Which portfolio companies are headquartered in [region/country]?" |
472+
| Best/worst performers | "Rank all investments by MOIC — show entry valuation vs. current" |
473+
| Sector breakdown | "Break down the portfolio by sector and stage — count and total FMV" |
474+
| New investments | "What investments did we make in [year]? Show amount, fund, and close date" |
475+
| Revenue by region | "What's the most recent annual revenue for our companies in [region]?" |
476+
| Point-in-time snapshot | "What did the portfolio look like at December 31, [year]? Cost, FMV, gain/loss." |
477+
| Follow-on tracking | "Which portfolio companies have received follow-on? Show total invested by round." |
478+
479+
---
480+
481+
The more specific you are — fund name, date range, LP or company name — the sharper the output.
280482

281483
**Coming soon:** Build and save custom reports directly in your Carta Data Explorer firm folder
282484
and design custom tear sheets from scratch, right here.

0 commit comments

Comments
 (0)