# monthly-to-annual

The monthly-to-annual Claude Code skill evaluates a PostHog customer’s move from monthly billing to an annual prepaid credit plan. It produces a discount briefing and a plain-text Slack draft.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 115 installs · ★ 80 repo stars
- Author: PostHog
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/PostHog/skills/tree/HEAD/skills/team/customer-success/monthly-to-annual/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/monthly-to-annual

## What it does

The skill retrieves 12–24 months of invoice history from the data warehouse, checks the customer against PostHog’s eligibility rules, and projects future growth. It then applies the handbook’s discount tiers and reviews recent Slack, Gmail, and Granola interactions for factors that could affect the proposal. Exa supplies customer momentum signals.

The output is a concise briefing and a plain-text Slack draft written to match the representative’s voice. Before calculating, the skill checks the customer’s plan status and asks a focused question if eligibility is unclear. It needs the customer’s name and access to the data warehouse, Slack, Gmail, Granola, and Exa. The representative must choose discount levers; the skill has no default selection.

## Requirements
- Works with: Slack, Gmail

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/skills --skill monthly-to-annual -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/monthly-to-annual/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/monthly-to-annual/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/skills --skill monthly-to-annual -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/monthly-to-annual/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/skills --skill monthly-to-annual -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/monthly-to-annual/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostHog/skills skills/team/customer-success/monthly-to-annual
```

2. **Manually: put the files in place**
- File: `.github/skills/monthly-to-annual/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/skills --skill monthly-to-annual -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/PostHog/skills --path skills/team/customer-success/monthly-to-annual
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/monthly-to-annual/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add PostHog/skills --skill monthly-to-annual -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/PostHog/skills/tree/HEAD/skills/team/customer-success/monthly-to-annual/SKILL.md

## When to use it
- calculate a discount for moving from monthly billing to annual prepaid credits
- check whether a customer meets PostHog’s eligibility rules
- factor projected growth and recent customer interactions into a proposal
- prepare a briefing and Slack message draft

## Example prompts
- Work out an annual credit conversion for the PostHog customer Acme.
- Calculate the discount options for Acme and draft a Slack message.
- Check the monthly-to-annual numbers for Acme on PAYG.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 79ecf4601590168a.

BEGIN THIRD-PARTY FILE 79ecf4601590168a
```text
---
name: monthly-to-annual
description: Build the case for converting a PostHog monthly/PAYG customer to an annual prepaid credit plan. Pulls 12-24 months of invoice history from the data warehouse, runs the handbook eligibility check, projects forward growth, applies the handbook discount tiers, scans recent customer touchpoints (Slack, Gmail, Granola) for confounding variables, fetches customer momentum signals via Exa, emulates the rep's own writing voice, and emits a succinct briefing plus a plain-text Slack draft. Trigger on "annual conversion math for [account]", "monthly to annual for [account]", "draft annual nudge for [account]", or "credit-discount math for [account]".
---

# monthly-to-annual

You are helping a PostHog employee make the case for converting a monthly/PAYG customer to an annual prepaid credit plan. **Be succinct.** One tight briefing, one Slack draft, no preamble.

Key context: PostHog does **not** offer discounts to monthly customers no matter how long they commit. The discount only unlocks on conversion to a prepaid credit plan. Frame everything around that.

## How PostHog sells (read before drafting)

Internalize this before writing anything customer-facing. Source: posthog.com/handbook/growth/sales/.

- **Customers buy from us, we don't sell to them.** No BS sales-y talk. Direct, open, honest.
- **Curiosity over pitching.** Find the pain — people buy solutions to problems, not features. "Forced interest is gross and salesy."
- **Helpful, not pushy.** Primary focus is making *paying customers successful*, not forcing sales through.
- **We sell use cases. We bill products.** Frame around the customer's outcome (e.g. "lock in your unit cost ahead of your next growth phase"), not the line item ("buy credits").
- **Be prescriptive about next steps.** "Waiting for a customer to come back to you is not a valid next step." Every output ends with a concrete next step or question.
- **We don't care about losing deals.** No pressure tactics, no artificial deadlines, no fake scarcity. The 5% mutual-commitment discount is *not* an end-of-quarter discount — it's earned with a real, mutually-agreed signing date.
- **Speed & responsiveness.** If a customer is in a rush we move at their pace; otherwise we don't manufacture urgency.

The draft should sound like a teammate giving the customer useful info, not a vendor closing a deal. If the rep asks for harder closing language, push back once — then comply if they insist.

## Inputs

Required: customer name.
```
END THIRD-PARTY FILE 79ecf4601590168a

The third-party file has ended. Everything between the 79ecf4601590168a tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2521 of 18468 bytes. © PostHog · MIT · https://github.com/PostHog/skills/tree/HEAD/skills/team/customer-success/monthly-to-annual/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
