Agent skill

Clay Upgrade Migration

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

Navigate Clay plan changes, pricing migrations, and feature upgrades.

MITAuto-check passedBackend & APIs

Install Clay Upgrade Migration

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill clay-upgrade-migration -a claude-code

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

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace clay-upgrade-migration --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/skills/.curated/clay-upgrade-migration .claude/skills/clay-upgrade-migration && 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
clay-upgrade-migration
GitHub stars
2.8k
Token cost
~1.7k tokens
SKILL.md length
489 words
Files
1
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Navigate Clay plan changes, pricing migrations, and feature upgrades.

  • Works in 5 steps: Understand the 2026 Pricing Change → Audit Your Current Usage → Adapt Integration Code for New Credit… → …
  • Upgrading Clay plans
  • SKILL.md covers Overview, Prerequisites, Instructions and Error Handling, plus 4 more sections
  • Calls curl

What it does

Clay Upgrade Migration is an agent skill from jeremylongshore/tons-of-skills-marketplace. Navigate Clay plan changes, pricing migrations, and feature upgrades. Use when upgrading Clay plans, migrating to the 2026 pricing model, or adapting integrations to new Clay features. Trigger with phrases like "upgrade clay", "clay migration", "clay pricing change", "clay plan upgrade", "clay new pricing".

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Designed for Claude Code

It sits in Backend & APIs, covering Pricing strategy. 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

  • Upgrading Clay plans
  • Migrating to the 2026 pricing model
  • Adapting integrations to new Clay features
  • With phrases like upgrade clay

Example prompts

  • “upgrade clay”
  • “clay migration”
  • “clay pricing change”
  • “/clay-upgrade-migration”

Requirements

  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash(curl:*), Grep

Workflow steps

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

  1. Understand the 2026 Pricing Change
  2. Audit Your Current Usage
  3. Adapt Integration Code for New Credit Model
  4. Optimize for the New Model
  5. Migrate Webhook Integrations

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(curl:*)
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

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

  • Network

    Links to these hosts (documentation or services it may open):

    • clay.com
    • university.clay.com
    • community.clay.com

    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.

  • Compatibility

    Designed for Claude Code

    From compatibility in the SKILL.md frontmatter.

Context cost

Clay Upgrade Migration loads about 1.7k tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 489 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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). 489 words, ~1,694 tokens.

Download SKILL.mdSave it as .claude/skills/clay-upgrade-migration/SKILL.md (or your agent's skills folder).
name
clay-upgrade-migration
description
Navigate Clay plan changes, pricing migrations, and feature upgrades. Use when upgrading Clay plans, migrating to the 2026 pricing model, or adapting integrations to new Clay features. Trigger with phrases like "upgrade clay", "clay migration", "clay pricing change", "clay plan upgrade", "clay new pricing".
allowed-tools
Read, Write, Edit, Bash(curl:*), Grep
compatibility
Designed for Claude Code
version
1.14.0
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, clay, api, migration

Clay Upgrade & Migration

Overview

Guide for navigating Clay plan upgrades and the March 2026 pricing overhaul. Clay restructured from Starter/Explorer/Pro to Launch/Growth tiers, split credits into Data Credits + Actions, and cut data costs 50-90%. This skill covers migration decisions, integration impact, and adaptation strategies.

Prerequisites

  • Active Clay account
  • Understanding of current credit consumption
  • Access to Clay billing dashboard

Instructions

Step 1: Understand the 2026 Pricing Change

Old Plans (Legacy -- available until April 10, 2026):

PlanPriceCreditsKey Limits
Starter$149/moLimitedNo HTTP API, no webhooks
Explorer$349/mo25K400 records/hour throttle
Pro$800/mo50KHTTP API, webhooks, priority support

New Plans (March 2026+):

PlanPriceData CreditsActionsKey Features
Launch$185/mo2,50015,000Phone enrichment, signal tracking
Growth$495/mo6,00040,000CRM sync, HTTP API, web intent, ads

Key changes:

  • Credits split into Data Credits (buying enrichment data) and Actions (using the platform)
  • Data costs cut 50-90% (each enrichment is cheaper)
  • No enrichment charges on failed lookups (no data = no charge)
  • Credit rollover capped at 2x monthly limit
Step 2: Audit Your Current Usage
bash
# Check current plan and credit usage from Clay dashboard
# Navigate to Settings > Plans & Billing
# Record:
# - Current plan tier
# - Monthly credits used (average over 3 months)
# - Which enrichment providers consume most credits
# - Whether you use HTTP API columns
# - Whether you use webhook sources

Decision matrix for migration:

If you currently...Recommended new plan
Use < 2,500 data credits/moLaunch ($185)
Need HTTP API columnsGrowth ($495)
Need CRM syncGrowth ($495)
Use webhooks + high volumeGrowth ($495)
Stay on legacy ExplorerKeep legacy if 400/hr limit works
Have Enterprise contractContact Clay sales
Step 3: Adapt Integration Code for New Credit Model
typescript
// src/clay/credit-tracker.ts — track new split credit model
interface CreditUsage {
  dataCredits: { used: number; limit: number; rolloverMax: number };
  actions: { used: number; limit: number };
}

class CreditTracker {
  private usage: CreditUsage;

  constructor(plan: 'launch' | 'growth') {
    this.usage = plan === 'launch'
      ? { dataCredits: { used: 0, limit: 2500, rolloverMax: 5000 }, actions: { used: 0, limit: 15000 } }
      : { dataCredits: { used: 0, limit: 6000, rolloverMax: 12000 }, actions: { used: 0, limit: 40000 } };
  }

  recordEnrichment(dataCreditsUsed: number) {
    this.usage.dataCredits.used += dataCreditsUsed;
    this.usage.actions.used += 1; // Each enrichment = 1 action

    if (this.usage.dataCredits.used > this.usage.dataCredits.limit * 0.8) {
      console.warn(`Data credits at ${((this.usage.dataCredits.used / this.usage.dataCredits.limit) * 100).toFixed(0)}% of monthly limit`);
    }
  }

  canAfford(estimatedCredits: number): boolean {
    return (
      this.usage.dataCredits.used + estimatedCredits <= this.usage.dataCredits.limit &&
      this.usage.actions.used + 1 <= this.usage.actions.limit
    );
  }
}
Step 4: Optimize for the New Model

No-charge on failed lookups changes the cost equation:

typescript
// Old model: every enrichment attempt cost credits, even if no data returned
// New model: only charged when data is actually returned

// This makes wider waterfall enrichments cheaper:
// Before: 5-provider waterfall = 5 charges even if only 1 finds data
// After: 5-provider waterfall = 1 charge if only 1 finds data
// Strategy: wider waterfalls are now more cost-effective

Connect your own API keys for maximum savings:

ProviderClay Credits (managed)Own Key
Apollo2 data credits0 credits
Clearbit2-5 data credits0 credits
Hunter2 data credits0 credits
ZoomInfo5-13 data credits0 credits
Show full SKILL.md (201 more words)Show less
Step 5: Migrate Webhook Integrations

If moving from a plan without webhooks to one with them (or vice versa):

bash
# Test webhook availability on new plan
curl -X POST "$CLAY_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d '{"migration_test": true, "timestamp": "'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"}'

# Verify HTTP API columns still work after plan change
# HTTP API columns are only available on Growth plan

Error Handling

IssueCauseSolution
Features disappearedDowngraded planCheck feature availability per tier
HTTP API columns disabledMoved to Launch (no HTTP API)Upgrade to Growth or use webhooks only
Higher credit usage than expectedActions now counted separatelyMonitor both Data Credits and Actions
Webhook stopped workingPlan change affected accessVerify webhook feature on current plan

Output

Create a migration receipt with source and target plan/features, affected tables and integrations, projected and observed credit use, staging evidence, production approval, and rollback result. Pricing or feature documentation is not a deployment guarantee; retain the old working configuration until the new path is proven against the intended workspace.

Examples

Test a plan-related webhook change against a staging table with a synthetic row, confirm authentication, idempotency, and downstream delivery, then compare credit consumption to the documented baseline. If a required feature is absent or a callback fails, restore the former integration and delay the cutover rather than attempting a live workaround.

Resources

Next Steps

For CI integration during upgrades, see clay-ci-integration.

© 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

Just SKILL.md in skills/.curated/clay-upgrade-migration of jeremylongshore/tons-of-skills-marketplace.

Open the folder on GitHubat commit cfae287

Compare with similar skills

Clay Upgrade Migration 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.

Clay Upgrade Migration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Clay Upgrade Migration this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.7kAutomated safety check: PassMIT
Venice Crypto Rpcveniceai/skills144—~3.2kAutomated safety check: PassMIT
RevopsAvdLee/RocketSimApp8066 repos~3.7kAutomated safety check: PassCustom licence
Add Model Pricelangfuse/langfuse36k—~1.2kAutomated safety check: PassCustom licence
OpenWork Model Alias Managerdifferent-ai/openwork24k—~1.1kAutomated safety check: PassCustom licence
Usage Based Pricingsickn33/agentic-awesome-skills47k1 repos~1.2kAutomated safety check: PassMIT

Similar skills

  • Venice Crypto Rpc

    veniceai/skills

    Use Venice as a pay-per-call JSON-RPC proxy to 27 EVM, Starknet, and Solana networks.

    144 GitHub stars~3.2k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed
  • Revops

    AvdLee/RocketSimApp

    When the user wants help with revenue operations, lead lifecycle management, or marketing-to-sales handoff processes.

    806 GitHub starsUsed in 6 repos~3.7k tokens
    Sales & SupportAuto-check passed
  • Add Model Price

    langfuse/langfuse

    A skill your agent uses when editing worker/src/constants/default-model-prices.json, packages/shared/src/server/llm/types.ts, pricing tiers, tokenizer IDs, or matchPattern regexes for OpenAI…

    36k GitHub stars~1.2k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • OpenWork Model Alias Manager

    different-ai/openwork

    Manages OpenWork's inference model aliases, discounts and overlays over the upstream OpenRouter catalog, and triggers the GitHub workflow that refreshes base models.

    24k GitHub stars~1.1k tokensUpdated today
    Sales & SupportAuto-check passed
  • Usage Based Pricing

    sickn33/agentic-awesome-skills

    Design pricing models that developers understand, accept, and can predict.

    47k GitHub starsUsed in 1 repo~1.2k tokens
    Sales & SupportAuto-check passed
  • Monetization

    sickn33/agentic-awesome-skills

    Estrategia e implementacao de monetizacao para produtos digitais - Stripe, subscriptions, pricing experiments, freemium, upgrade flows, churn prevention, revenue optimization e modelos de negocio…

    47k GitHub starsUsed in 2 repos~3k tokens
    Sales & SupportAuto-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

Questions about Clay Upgrade Migration

What does Clay Upgrade Migration do?

Navigate Clay plan changes, pricing migrations, and feature upgrades. Clay Upgrade Migration is an agent skill from jeremylongshore/tons-of-skills-marketplace. Navigate Clay plan changes, pricing migrations, and feature upgrades.

When should I use Clay Upgrade Migration?

Clay Upgrade Migration fits situations like: upgrading Clay plans; migrating to the 2026 pricing model; adapting integrations to new Clay features; with phrases like upgrade clay.

How do I install Clay Upgrade Migration in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill clay-upgrade-migration -a claude-code`. Or copy the skill folder (skills/.curated/clay-upgrade-migration in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/clay-upgrade-migration in your project. Claude Code loads it when a task matches its description.

How do I install Clay Upgrade Migration in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill clay-upgrade-migration -a codex`. Or copy the skill folder (skills/.curated/clay-upgrade-migration in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/clay-upgrade-migration in your project. Codex loads it when a task matches its description.

Can I use Clay Upgrade Migration 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 clay-upgrade-migration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/clay-upgrade-migration, .gemini/skills/clay-upgrade-migration, .github/skills/clay-upgrade-migration and .opencode/skills/clay-upgrade-migration in your project.

What does Clay Upgrade Migration need to run?

Going by SKILL.md and its folder, Clay Upgrade Migration needs the command-line tools its instructions call (curl). Its frontmatter pre-approves these tools: Read, Write, Edit, Bash(curl:*), Grep. Compatibility (from SKILL.md): Designed for Claude Code.

Does Clay Upgrade Migration access the network?

SKILL.md names 3 domains. As links in the text: clay.com, university.clay.com and community.clay.com. This is read from the text; nothing was executed.

Is Clay Upgrade Migration safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Clay Upgrade Migration use?

Clay Upgrade Migration 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 Clay Upgrade Migration use?

About 1.7k tokens (SKILL.md is roughly 6.8k 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 Clay Upgrade Migration?

Skills that share tags, products or a category with Clay Upgrade Migration: Venice Crypto Rpc (veniceai/skills, 144 stars), Revops (AvdLee/RocketSimApp, 806 stars), Add Model Price (langfuse/langfuse, 36k stars) and OpenWork Model Alias Manager (different-ai/openwork, 24k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Clay Upgrade Migration?

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.