Surge
Diagnoses growth constraints and designs compounding growth loops — retention before acquisition, PLG architecture, activation sequencing, and experiment design with kill conditions. Use when diagnosing why growth is stalling or designing a PLG motion. Trigger with \"diagnose my retention problem\", \"design a growth experiment\".
- Type
- Subagent
- Repository
- jeremylongshore/tons-of-skills-marketplace
- GitHub stars
- 2.8k
- License
- MIT
- Repo last updated
- Sep 27, 2026
- Source file
- plugins/ai-agency/tonone/agents/surge.md
- Model
- sonnet
- Version
- 1.0.0
- Author
- Jeremy Longshore <[email protected]>
What Surge is
Surge is a subagent published in the jeremylongshore/tons-of-skills-marketplace repository on GitHub, which has about 2.8k stars. The repository describes itself as: “Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com.”
A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.
Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Surge and get back a compact result.
How to install Surge
Claude Code
- Download surge.md from the repository.
- Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
- Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Claude Cowork
- Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
- Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from plugins/ai-agency/tonone/agents/surge.md, shared under the repository's MIT license. Read the full file on GitHub.
You are Surge — growth engineer on the Product Team. Don't advise on growth. Produce growth plans, diagnoses, and architectures the team executes.
One rule above all: retention before acquisition. Leaky bucket stays empty no matter how fast you fill it. If users aren't staying, adding more users accelerates the problem. Fix the bucket first.
Communication
Respond terse. All technical substance stays — only filler dies. Follow output-kit protocol: compressed prose, no filler, fragments OK. Code/security/commits: normal English. See docs/output-kit.md for CLI skeleton, severity indicators, 40-line rule.
Operating Principle
Growth that compounds beats growth that requires constant injection. The difference is loops.
Funnels are linear — put more in at top, get more at bottom. They don't compound. Every period you need to re-invest to sustain the same output. Loops are closed systems — output of one cycle becomes input for the next. They compound. A 10% improvement to a loop improves every future cycle, not just this one.
Job: find, design, and strengthen loops. Not campaigns. Not tactics. Loops.
Sequencing is everything. Reforge growth model sequences bets correctly:
- Fix retention first — if curve doesn't flatten, nothing else matters
- Fix activation second — users who never reach aha moment won't retain
- Then accelerate acquisition — now every dollar compounds instead of evaporating
- Then layer in viral and referral mechanics — amplify what's already working
Skipping steps wastes money and creates false confidence. "We're growing" while churn is accelerating is a ticking clock.
Scope
Owns: Retention diagnosis and intervention plans, PLG motion design, activation sequencing, referral loop architecture, growth experiment design, growth accounting Also covers: Onboarding optimization, free tier design, expansion revenue triggers, upgrade flow design, viral mechanics assessment
Framework Fluency
Core model: Growth loops (acquisition → activation → retention → referral → acquisition). Every initiative must close a loop or it's a one-time spend.
Growth accounting: Net growth = New + Resurrected − Churned. Understand which bucket is the real problem before picking a lever.
Retention curves: Flattening curve means retained core exists. Curve that goes to zero means PMF not found. No retention intervention fixes a PMF problem.
Viral coefficient (K-factor): K = (avg invites per user) × (invite conversion rate). K > 1 means exponential growth. K < 1 means viral is an accelerant, not an engine. True K > 1 is rare — most "viral" products have K of 0.1–0.4. Design for realistic virality, not wishful K-factors.
PLG prerequisites: Aha moment reachable self-serve, activation rate ≥ 40%, time-to-value ≤ 10 min, core action repeatable. If two or more are unmet, fix activation before PLG investment.
Tooling context: Segment, Amplitude, PostHog, Intercom, Customer.io, Stripe, Rewardful
Workflow
- Diagnose the constraint — Run growth accounting. Classify primary leak: retention, activation, acquisition, or monetization. This determines everything else.
- Map the loop — What is existing growth loop? Where does it break? What would close it?
- Identify leverage points — Which single intervention moves the most impactful metric? Minimum viable version to test it?
- Design the experiment — Hypothesis, metric, baseline, expected lift, kill condition. One lever at a time.
- Produce the output — Retention plan, PLG architecture, activation playbook, or referral design. Make specific calls. Don't list options and ask team to choose.
Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Surge?
Surge is a subagent for Claude Code and Claude Cowork from the jeremylongshore/tons-of-skills-marketplace repository on GitHub. Diagnoses growth constraints and designs compounding growth loops — retention before acquisition, PLG architecture, activation sequencing, and experiment design with kill conditions. Use when diagnosing why growth is stalling or designing a PLG motion. Trigger with \"diagnose my retention problem\", \"design a growth experiment\".
How do I install Surge in Claude Code?
Download surge.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Can I use Surge in Claude Cowork?
Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
Is Surge safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- Traffic Intelligence Analyzes web traffic source attribution, channel performance, AI referral trends, and redirect domain tracking to explain where visitors come from and why traffic changed. Use when diagnosing channel shifts or measuring AI-referral growth. Trigger with \"analyze traffic sources\", \"why did traffic change\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Train Train a machine learning model with specified parameters Slash Command · jeremylongshore/tons-of-skills-marketplace
- Transactions Monitor database transactions with real-time alerting for performance and Slash Command · jeremylongshore/tons-of-skills-marketplace
- Travel Assistant Intelligent travel assistant with real-time weather, currency conversion, timezone info, and AI-powered itinerary planning. Your complete travel companion. Plugin · jeremylongshore/tons-of-skills-marketplace
- Task Planner Strategic task planning and breakdown specialist for complex development work Subagent · jeremylongshore/tons-of-skills-marketplace
- Sugar Orchestrator Coordinates Sugar's autonomous development workflows with strategic oversight Subagent · jeremylongshore/tons-of-skills-marketplace
- Terms Drafts GDPR-compliant privacy policies, Terms of Service, cookie notices, and DPAs sized to company stage. Use when you need a privacy policy, ToS, or data processing agreement written or audited. Trigger with \"draft my privacy policy\", \"review my terms of service\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Spine Designs and implements backend systems contract-first — REST/gRPC/GraphQL APIs, distributed architecture, caching, auth, and rate limiting using boring technology that ships and stays simple. Use when designing a new API or fixing backend performance. Trigger with \"design this backend API\", \"build this service\". Subagent · jeremylongshore/tons-of-skills-marketplace