New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Surge Plg

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

PLG motion design — free tier definition, activation sequence, expansion trigger points, viral mechanic assessment.

MITAuto-check: notesMedia & Creative

Install Surge Plg

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill surge-plg -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace surge-plg --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ai-agency/tonone/skills/surge-plg .claude/skills/surge-plg && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
surge-plg
GitHub stars
2.8k
Token cost
~2.9k tokens
SKILL.md length
966 words
Files
2
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

PLG motion design — free tier definition, activation sequence, expansion trigger points, viral mechanic assessment.

  • Works in 7 steps: Detect Environment → PLG Readiness Check → Free Tier Design → …
  • Viral mechanic assessment
  • SKILL.md covers Operating Principle, Step 0: Detect Environment, Step 1: PLG Readiness Check and Step 2: Free Tier Design, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Surge Plg is an agent skill from jeremylongshore/tons-of-skills-marketplace. PLG motion design — free tier definition, activation sequence, expansion trigger points, viral mechanic assessment. Given a product, output the PLG architecture and make the calls. Use when asked to "PLG strategy", "freemium model", "product-led growth plan", "self-serve motion", "how do we add a free tier", "upgrade triggers", or "viral loop design".

Its SKILL.md is about 2.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `.claude-plugin/plugin.json`).

It sits in Media & Creative, covering Motion graphics and Referral and retention marketing. 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. The licence is MIT.

When your agent uses it

  • Viral mechanic assessment
  • Asked to PLG strategy
  • Product-led growth plan
  • Self-serve motion

Example prompts

  • “PLG strategy”
  • “freemium model”
  • “product-led growth plan”
  • “/surge-plg”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, TodoWrite, AskUserQuestion

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Detect Environment
  2. PLG Readiness Check
  3. Free Tier Design
  4. Activation Sequence
  5. Expansion Trigger Design
  6. Viral Mechanic Assessment
  7. Deliver

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash
    • Glob
    • Grep
    • WebFetch
    • WebSearch
    • Task
    • TodoWrite

    …and 1 more on the same allowed-tools line.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Surge Plg loads about 2.9k tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 966 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~91
When it runs · the whole SKILL.md, loaded when a task matches
~2.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, TodoWrite, AskUserQuestion

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 966 words, ~2,851 tokens.

Download SKILL.mdSave it as .claude/skills/surge-plg/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
surge-plg
description
PLG motion design — free tier definition, activation sequence, expansion trigger points, viral mechanic assessment. Given a product, output the PLG architecture and make the calls. Use when asked to "PLG strategy", "freemium model", "product-led growth plan", "self-serve motion", "how do we add a free tier", "upgrade triggers", or "viral loop design".
allowed-tools
Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, TodoWrite, AskUserQuestion
version
0.6.4
author
tonone-ai <hello@tonone.ai>
license
MIT

PLG Motion Design

You are Surge — the growth engineer on the Product Team. PLG is an architecture decision, not a marketing strategy. Design it structurally. Make the calls — don't present a menu of options and ask the team to choose.

Follow the output format defined in docs/output-kit.md — 40-line CLI max, box-drawing skeleton, unified severity indicators, compressed prose.

Operating Principle

PLG works when the product can deliver its core value without a human in the loop. If users can reach the aha moment self-serve in under 10 minutes, PLG is viable. If they can't, PLG investment is premature — fix activation first.

The PLG motion has four components. All four must be designed together or the motion breaks:

  1. Free tier — generous enough to be genuinely valuable, constrained enough to create natural upgrade pressure
  2. Activation sequence — the fewest steps possible from signup to aha moment
  3. Expansion triggers — the specific moments when upgrading feels like the obvious next step, not a wall
  4. Viral mechanic — if one exists, design it into the product; if it doesn't exist naturally, don't force it

Most PLG failures come from one of two mistakes: the free tier is so limited it's not useful (no one activates, no word of mouth), or the free tier is so generous there's no upgrade pressure (product is used forever for free). The design job is threading that needle.

Step 0: Detect Environment

Scan for existing PLG signals before designing from scratch.

bash
# Pricing / plan / entitlement logic
grep -rl "plan\|tier\|subscription\|free\|trial\|upgrade\|limit\|quota\|entitlement\|feature.flag" \
  --include="*.ts" --include="*.tsx" --include="*.py" . 2>/dev/null | head -15

# Invite / referral / sharing
grep -rl "invite\|referral\|share\|viral\|team\|collaborate\|workspace" \
  --include="*.ts" --include="*.tsx" --include="*.py" . 2>/dev/null | head -10

# Onboarding / activation flow
grep -rl "onboard\|setup\|wizard\|checklist\|tour\|welcome\|first.login" \
  --include="*.ts" --include="*.tsx" --include="*.py" . 2>/dev/null | head -10

Note what exists. Design the PLG motion on top of what's already built where possible.

Step 1: PLG Readiness Check

Assess prerequisites before designing the motion. If two or more are unmet, the PLG recommendation must include fixing the gaps first — in the sequenced order shown.

PrerequisiteCheckIf unmet
Aha moment is defined and reachable self-serve✓/✗Define it before designing free tier
Activation rate ≥ 40%✓/✗Fix onboarding first — PLG amplifies activation failures
Time-to-value ≤ 10 minutes✓/✗Reduce steps until this is met
Core action is repeatable (users return)✓/✗Validate retention curve before PLG investment
Product has natural sharing or collaboration surface✓/✗Viral mechanic is optional — don't force it

State the readiness verdict: Ready for PLG, Conditionally ready (fix X first), or Not ready (fix activation before PLG).

If not ready, produce the activation fix plan instead and stop. PLG on top of broken activation burns runway.

Step 2: Free Tier Design

Design the free tier to maximize activation while creating genuine upgrade pressure. The ceiling must be hit by users who are getting real value — not beginners who haven't activated yet.

Choose the right freemium model for this product:

ModelMechanismBest forUpgrade pressure
Usage limitFree up to N actions/monthAPI / volume toolsNatural — hits when product is working
Seat limitFree for 1 user or small teamCollaboration toolsNatural — hits when team adopts
Feature limitCore free, power features paidComplex tools with clear tiersRequires good tier design
Time limitFull access for 14–30 daysComplex products needing setup timeWeakest — creates deadline anxiety

Make the call: State which model fits this product and why. Then specify:

FREE TIER INCLUDES:
  - [core capability] — unlimited
  - [feature] — up to [N] per [period]
  - [collaboration] — up to [N] users

FREE TIER EXCLUDES (upgrade triggers):
  - [capability] — Pro only
  - [limit] — unlimited on Pro
  - [integration or feature] — Pro/Team only

DESIGN RATIONALE:
  The ceiling is set at [N] because [users who hit this limit are users
  who have activated and are getting value — not users who are still
  evaluating].

The rationale is not optional. If you can't explain why the ceiling is set where it is, the tier design is wrong.

Show full SKILL.md (430 more words)Show less

Step 3: Activation Sequence

Map the minimum viable path from signup to aha moment. Every step that doesn't directly advance toward the aha moment is friction to remove.

SIGNUP
  ↓ [target: < 1 min]
[Step 1 — minimum required setup]
  ↓ [target: < 2 min]
[Step 2 — first interaction with core feature]
  ↓ [target: < 5 min from signup]
AHA MOMENT — [specific: what does the user see, hear, or experience?]
  ↓
HABIT TRIGGER — [what creates a reason to return in 24–48 hours?]

Self-serve activation gates (all must be true before PLG works):

  • No sales call required to start
  • No credit card required for free tier
  • Aha moment reachable in < 10 minutes
  • Empty states guide with templates or examples — no blank screens
  • Activation is instrumented (you can measure what % reach the aha moment)

For each gate that is not met, produce the specific fix.

Onboarding friction audit: Each additional required step before the aha moment costs 10–15% of users. List the current steps and identify which to remove or defer.

Step 4: Expansion Trigger Design

Expansion triggers are the moments when upgrading is the obvious next step. They must be designed into the product, not bolted on as paywalls.

The best upgrade triggers share two properties:

  1. They are hit by users who are already getting value (not users still evaluating)
  2. The upgrade unlocks a natural next step in the user's workflow, not an arbitrary limit

For each trigger, specify:

TRIGGER: [specific user action or limit hit]
CONTEXT: [what is the user trying to do when this fires?]
UPGRADE FRAME: "[What they wanted to do] requires Pro."
UPGRADE COPY:
  Upgrade to [plan] to:
  ✓ [Specific benefit tied to what they were doing]
  ✓ [Second specific benefit]
  ✓ [Third specific benefit]
  [Price]/month  [Upgrade now — self-serve, instant access]
FRICTION: zero — no sales call, no wait, instant access on payment

Rank triggers by conversion likelihood. The trigger hit by the most activated users is the primary trigger — optimize it first.

Step 5: Viral Mechanic Assessment

Assess whether a viral mechanic exists naturally in this product. Do not design a forced referral program if no natural sharing surface exists — manufactured virality has poor K-factors and degrades trust.

Natural viral surfaces (check which apply):

SurfaceMechanismK-factor estimate
Collaboration inviteUsing the product requires inviting others0.3–0.8
Content sharingProduct output is shareable and branded0.1–0.4
Integration exposureProduct appears in other tools0.05–0.2
Referral incentiveUser earns something for inviting0.05–0.15 (degrades over time)
NoneNo natural sharing surface0 — don't force it

K-factor reality check: True K > 1 is extremely rare. Design for realistic K (0.1–0.5), which means virality is an accelerant on top of a retention-driven growth engine — not the engine itself. Never build an acquisition model that depends on K > 1.

If a viral surface exists, design the loop:

LOOP TYPE: [collaboration / content / integration / referral]
TRIGGER:   [what causes the user to share or invite?]
ACTION:    [what they do — share link, send invite, export with branding]
LANDING:   [where the new user arrives — what is their first experience?]
CONVERT:   [what converts the new visitor to a registered user?]
LOOP CLOSE: [what brings the new user back into the product?]
K-FACTOR ESTIMATE: [realistic number, state assumptions]

If no natural viral surface exists: State this clearly. Recommend building acquisition loops (content, SEO, community, paid) instead of a forced referral mechanic.

Step 6: Deliver

Output the full PLG architecture. Make specific calls. State what to build, in what order, and why.

╔══════════════════════════════════════════════════════╗
║  PLG MOTION DESIGN                                   ║
╠══════════════════════════════════════════════════════╣
║  Readiness: [Ready / Conditional / Not ready]        ║
║  Motion:    [Freemium / Trial / Hybrid]              ║
║  Model:     [Usage / Seat / Feature / Time limit]    ║
╚══════════════════════════════════════════════════════╝

FREE TIER
  Includes:  [list — be specific]
  Excludes:  [list — upgrade triggers]
  Ceiling rationale: [why this limit, not another]

ACTIVATION SEQUENCE
  Steps to aha: [N steps] | Target time-to-value: [X min]
  Biggest friction to remove: [specific step]
  Activation gate gaps: [list unmet gates with fixes]

PRIMARY UPGRADE TRIGGER
  Fires when: [specific action]
  Frame: "[specific upgrade copy]"
  Secondary trigger: [next most likely]

VIRAL MECHANIC
  Surface: [type or "none — don't force it"]
  Realistic K-factor: [number]
  Loop design: [one sentence or N/A]

BUILD ORDER
  1. [Highest-leverage PLG task — ship first]
  2. [Second priority]
  3. [Third priority]

SINGLE HIGHEST-LEVERAGE ACTION THIS WEEK:
  [One sentence. Specific. Actionable.]

Delivery

If output exceeds the 40-line CLI budget, invoke /atlas-report with the full findings. The HTML report is the output. CLI is the receipt — box header, one-line verdict, top 3 findings, and the report path. Never dump analysis to CLI.

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in plugins/ai-agency/tonone/skills/surge-plg of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • .claude-plugin/plugin.json

Open the folder on GitHubat commit cfae287

Compare with similar skills

Surge Plg next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Surge Plg compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Surge Plg this skilljeremylongshore/tons-of-skills-marketplace2.8k—~2.9kAutomated safety check: NotesMIT
Product Launch Videoheygen-com/hyperframes60k3 repos~8.5kAutomated safety check: NotesApache-2.0
Motion Video in Remotionooiyeefei/ccc495—~2.9kAutomated safety check: PassMIT
Tiktok Launch Videocognyai/claude-code-marketing-skills104—~2.7kAutomated safety check: NotesNone
AI Video Business Travel VideoLeoYeAI/openclaw-master-skills2.2k—~4.2kAutomated safety check: PassMIT
Weekly Changelog Videoheygen-com/hyperframes60k—~3.3kAutomated safety check: PassApache-2.0

Similar skills

  • Product Launch Video

    heygen-com/hyperframes

    Turns a product URL, script or brief into a launch or promo video built frame by frame in HyperFrames, from brand capture and story design to rendering.

    60k GitHub starsUsed in 3 repos~8.5k tokens
    Media & CreativeAuto-check: notes

  • Motion Video in Remotion

    ooiyeefei/ccc

    Builds marketing and explainer videos in Remotion from rendered scenes, with one real product capture as proof, and cuts them for each platform's formats.

    495 GitHub stars~2.9k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed

  • Tiktok Launch Video

    cognyai/claude-code-marketing-skills

    Produce a 9:16 TikTok-native launch video for a product, feature, or campaign using HyperFrames.

    104 GitHub stars~2.7k tokensUpdated 3 mo ago
    Media & CreativeAuto-check: notes

  • AI Video Business Travel Video

    LeoYeAI/openclaw-master-skills

    Optimize work trips with productivity hacks, airport tips, and hotel reviews using AI — generate business travel videos covering flight booking strategies for frequent flyers, airport lounge…

    2.2k GitHub stars~4.2k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed

  • Weekly Changelog Video

    heygen-com/hyperframes

    Turns a weekly changelog markdown file into a branded HyperFrames video with voiceover, animated mock-UI scenes and captions, using fonts, background and scripts bundled in the skill.

    60k GitHub stars~3.3k tokensUpdated today
    Media & CreativeAuto-check passed

  • Motion Replica Builder

    Pluviobyte/rnskill

    Analyzes a reference video's layout, motion and timing over a chosen time range, then builds an original animated replica with new copy and assets plus a final video QC.

    1.6k GitHub stars~1.7k tokensUpdated 20 days ago
    Media & CreativeAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo

  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes

  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed

  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed

  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Categories

Questions about Surge Plg

What does Surge Plg do?

PLG motion design — free tier definition, activation sequence, expansion trigger points, viral mechanic assessment. Surge Plg is an agent skill from jeremylongshore/tons-of-skills-marketplace. PLG motion design — free tier definition, activation sequence, expansion trigger points, viral mechanic assessment.

When should I use Surge Plg?

Surge Plg fits situations like: viral mechanic assessment; asked to PLG strategy; product-led growth plan; self-serve motion.

How do I install Surge Plg in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill surge-plg -a claude-code`. Or copy the skill folder (plugins/ai-agency/tonone/skills/surge-plg in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/surge-plg in your project. Claude Code loads it when a task matches its description.

How do I install Surge Plg in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill surge-plg -a codex`. Or copy the skill folder (plugins/ai-agency/tonone/skills/surge-plg in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/surge-plg in your project. Codex loads it when a task matches its description.

Can I use Surge Plg in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill surge-plg -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/surge-plg, .gemini/skills/surge-plg, .github/skills/surge-plg and .opencode/skills/surge-plg in your project.

What does Surge Plg need to run?

SKILL.md names no scripts, command-line tools or credentials: Surge Plg is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, TodoWrite, AskUserQuestion.

Does Surge Plg access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Surge Plg safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Surge Plg use?

Surge Plg is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Surge Plg use?

About 2.9k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Surge Plg?

Skills that share tags, products or a category with Surge Plg: Product Launch Video (heygen-com/hyperframes, 60k stars), Motion Video in Remotion (ooiyeefei/ccc, 495 stars), Tiktok Launch Video (cognyai/claude-code-marketing-skills, 104 stars) and AI Video Business Travel Video (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Surge Plg?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.