agentsclimarketplace

Yc weekly growth compass

Skill magnus919/agent-skills/yc-weekly-growth-compass

Paul Graham's "Startup = Growth" framework as an operational tool. Computes weekly growth rates, benchmarks against YC tiers (1% concerning, 5-7% good, 10%+ exceptional), projects compound growth over time, and frames every startup decision through the question "does this serve your target growth rate?" Ships a deterministic CLI calculator. Load when founders ask about growth rate, weekly growth, startup traction, metrics, or whether they're moving fast enough.From its SKILL.md

Install
npx -y skills add magnus919/agent-skills --skill yc-weekly-growth-compass

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • 29 days oldThe repository was created 29 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
  • 21 stars21 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

7.7 KB, ~1.7k tokens by cl100k_base, as published. Nobody here has run it

Weekly Growth Compass

"If there's one number every founder should always know, it's the company's growth rate. That's the measure of a startup. If you don't know that number, you don't even know if you're doing well or badly." — Paul Graham, "Startup = Growth" (September 2012)

This skill operationalizes Y Combinator's core growth philosophy into a repeatable weekly practice. The growth rate is not just a metric — it's a compass for every decision a founder makes.

When to Load

TriggerExample
"What's my growth rate?"Routine founder check-in
"Are we growing fast enough?"Trajectory anxiety
"Should we prioritize feature X or growth Y?"Decision framing
"Where will we be in a year?"Projection/planning
"How does our growth compare to YC benchmarks?"Benchmarking
"Is this initiative worth doing?"Growth compass check
"How long to double our revenue?"Milestone planning

How to Use

Quick Rule of Thumb (No Script)

YC's empirical benchmarks, based on measuring thousands of startups:

Weekly GrowthAnnualizedYC Assessment
1%1.7xConcerning — haven't found product-market fit
2%2.8xBelow average — need significant acceleration
5%12.6xGood — solid trajectory, keep pushing
7%33.7xVery good — exceptional progress
10%142.0xOutstanding — rare breakout trajectory

The inflection point: 5-7% weekly is the target zone YC coaches for.

Growth Compass Exercise (No Script)

Use this heuristic for any strategic decision:

  1. State your target weekly growth rate (e.g., "7%")
  2. For any proposed initiative, ask: "Does this serve our target growth rate?"
  3. If yes → do it. If no → defer or drop it.
  4. At end of week, measure actual growth. If you missed target, something else matters more than the thing you did.

This transforms the bewildering complexity of startup building into a single optimization problem, exactly as Graham intended.

Full Analysis (Script)

python scripts/growth-compass.py \
  --current-value 1200 \
  --previous-value 1000 \
  --period weekly

Or with a full series for trending:

python scripts/growth-compass.py \
  --series "1000,1050,1100,1200,1350,1420" \
  --period weekly

Required inputs

FlagDescriptionExample
--current-valueMetric value this period1200
--previous-valueMetric value last period1000
Or --seriesComma-separated values over time"1000,1050,1100"
--periodweekly, monthly, or quarterlyweekly

Optional inputs

FlagDescriptionExample
--project-weeksWeeks to project forward (default: 52)104
--target-revenueTarget metric to reach100000
--metric-nameLabel for the metric (default: "users/revenue")"MRR"
--jsonMachine-readable JSON output
--add-to-weeklyAfter computation, log this week's value for next check

Output fields

FieldMeaning
growth_rate_pctCalculated growth rate for the period
yc_assessmentBenchmark label (Concerning/Below Average/Good/Very Good/Outstanding)
projected_1yrValue after 52 weeks at current rate
projected_2yrValue after 104 weeks at current rate
doubling_timePeriods to double at current rate
time_to_targetIf target set, periods to reach it
assessmentPlain-English interpretation

Methodology

Growth Rate Calculation

growth_rate = ((current_value - previous_value) / previous_value) × 100

For series with 3+ data points, the script computes:

  • Period-over-period rates for each interval
  • Mean growth rate (arithmetic average)
  • Median growth rate (robust to outliers)
  • Compound weekly growth rate (CWGR) — fitted from first to last value

The Compass Principle

From Graham's essay: "We usually advise startups to pick a growth rate they think they can hit, and then just try to hit it every week. If they decide to grow at 7% a week and they hit that number, they're successful for that week. There's nothing more they need to do. But if they don't hit it, they've failed in the only thing that mattered."

The script operationalizes this by:

  1. Computing whether you hit your target
  2. Projecting forward at current rate vs. target rate
  3. Showing the gap in absolute terms so founders feel the urgency

Compound Growth Projection

future_value = current_value × (1 + growth_rate/100)^periods

The magic of compound growth at YC benchmarks:

Starting from $1,000/month MRR:

Weekly GrowthMonth 12Month 24Month 36
1%$1,700$2,900$4,900
5%$12,600$159,000$2.0M
7%$33,700$1.1M$38M
10%$142,000$20.2M$2.9B

The difference between 5% and 7% weekly is the difference between a lifestyle business and a category-defining company. Small variations in growth rate produce qualitatively different outcomes.

The Decision Framework

For the Founder

  1. Monday: Set this week's growth target
  2. Every decision: "Does this serve the target?"
  3. Friday: Measure actual growth
  4. If hit: Successful week, nothing else matters
  5. If missed: Alarmed. What went wrong? Adjust.

For the Investor/Advisor

Use YC's diagnostic frame:

What's your weekly growth rate?  ─→  < 5%: Founders aren't doing
    ↓                                    unscalable things
    ↓                                5-7%: Good, keep pushing
    ↓                                10%+: Exceptional
What's your growth rate trend?     ─→  Accelerating: product-market fit
    ↓                                    Decelerating: market saturation or churn
    ↓                                    Flat: plateau, needs intervention
Is revenue growing same as users?  ─→  No: monetization gap

Example: Early YC Company Assessment

python scripts/growth-compass.py \
  --current-value 35000 \
  --previous-value 32000 \
  --period monthly \
  --metric-name "MRR" \
  --target-revenue 100000

Growth rate: 9.4% monthly (~2.3% weekly) YC assessment: Below average weekly, solid monthly 1-year projection: ~$107K MRR Doubling time: ~7.7 months Months to $100K MRR: ~12 months

References

  • references/growth-compass-framework.md — Full essay breakdown with quotes
  • assets/compound-growth-table.md — Reference table for quick lookup
  • yc-default-alive-calculator companion skill — For financial sustainability analysis

What ships with it: 4 files

31.6 KB alongside SKILL.md, 1 of them executable

scripts/

Keep looking

Skills are one crate of 326,834. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.