sales-skills/sales-revive
skills/sales-revive/SKILL.md
Revive Adserver platform help — free open-source self-hosted ad server for managing display and email newsletter ads across websites, apps, and video players. Use when setting up Revive Adserver on your own server to manage ad campaigns, email newsletter zone only shows one banner and you need multiple ads rotating, ads not displaying after installation or PHP upgrade, geo-targeting rules aren't matching the right countries or cities, XML-RPC API calls failing with authentication errors, campaign statistics not tracking impressions or clicks correctly, trying to decide between self-hosted Revive and hosted alternatives like AdButler or Epom, or need to integrate Revive ad zones into your email newsletter. Do NOT use for general newsletter monetization strategy (use /sales-newsletter) or managed hosted ad serving without self-hosting (use /sales-adbutler or /sales-epom).
$ install --global
skillsauthnpx skillsauth add sales-skills/sales sales-reviveInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 19, 2026, 2:23 AM35.2s4 files scanned
SKILL.md
- name:
- sales-revive
- description:
- Revive Adserver platform help — free open-source self-hosted ad server for managing display and email newsletter ads across websites, apps, and video players. Use when setting up Revive Adserver on your own server to manage ad campaigns, email newsletter zone only shows one banner and you need multiple ads rotating, ads not displaying after installation or PHP upgrade, geo-targeting rules aren't matching the right countries or cities, XML-RPC API calls failing with authentication errors, campaign statistics not tracking impressions or clicks correctly, trying to decide between self-hosted Revive and hosted alternatives like AdButler or Epom, or need to integrate Revive ad zones into your email newsletter. Do NOT use for general newsletter monetization strategy (use /sales-newsletter) or managed hosted ad serving without self-hosting (use /sales-adbutler or /sales-epom).
- argument-hint:
- [describe your Revive Adserver question or ad serving goal]
- license:
- MIT
- version:
- 1.0.0
- tags:
- [sales, advertising, ad-server, open-source, platform]
- github:
- https://github.com/revive-adserver
Revive Adserver Platform Help
Step 1 — Gather context
If references/learnings.md exists, read it first for accumulated platform knowledge.
-
What are you trying to do?
- A) Install and set up Revive Adserver on my server
- B) Create and manage ad campaigns
- C) Set up email/newsletter ad zones
- D) Configure targeting (geo, frequency, URL, time)
- E) Use the XML-RPC API for automation
- F) Compare Revive to other ad server options
-
Hosting setup:
- A) Self-hosted on my own server
- B) Using the hosted edition (revive-adserver.net)
- C) Haven't decided yet
-
Current version: Revive v4.x, v5.x, or v6.x?
Skip-ahead rule: if the user's prompt already contains enough context, skip to Step 2.
Step 2 — Route or answer directly
| If the question is about... | Route to... |
|---|---|
| Newsletter monetization strategy (subscriptions, pricing models) | /sales-newsletter [question] |
| Managed hosted ad serving (no self-hosting) | /sales-adbutler [question] or /sales-epom [question] |
| Direct-sold ad management for local publishers | /sales-broadstreet [question] |
| Budget ad serving for bloggers (no server required) | /sales-adplugg [question] |
| Email deliverability (SPF/DKIM/DMARC) | /sales-deliverability [question] |
If the question is Revive-specific, continue to Step 3.
Step 3 — Revive Adserver platform reference
Read references/platform-guide.md for the full platform reference — capabilities, pricing, data model, API overview, email zone setup, integration recipes.
Answer the user's question using only the relevant section. Don't dump the full reference.
Step 4 — Actionable guidance
Focus on the user's specific situation:
- First-time setup: Download from revive-adserver.com/download (not GitHub ZIP). Requires PHP 7.2.5+ (v5.x) or PHP 8+ (v6.x), MySQL/MariaDB/PostgreSQL, Apache/Nginx. Run the web installer, create your first advertiser, campaign, banner, and zone.
- Email newsletter ads: Create a zone with type "Email/Newsletter". Only one active banner can serve per email zone (no JavaScript, no cookies). For multiple ads, install the "Multiple Ads in an Email Zone" plugin. Only image banners work in email zones.
- API automation: Built-in XML-RPC v2 API at
/api/v2/xmlrpc/. Auth with base64 user:password. Manage advertisers, campaigns, banners, zones, and pull statistics programmatically. Third-party REST API plugin available for purchase. - Choosing Revive vs alternatives: Revive is best when you need full control, zero platform fees, and can manage your own server. For managed hosting with less ops burden, use AdButler ($179/mo) or Epom ($149/mo). For budget no-code, use AdPlugg (free-$79/mo).
If you discover a gotcha, workaround, or tip not covered in references/learnings.md, append it there.
Gotchas
Best-effort from research — review these, especially items about version compatibility and email zone limitations that may be outdated.
- Email zones support only one active banner — without the paid "Multiple Ads in an Email Zone" plugin, only one banner can be active per email/newsletter zone at a time. No JavaScript or cookies in email.
- PHP version compatibility is strict — v5.x requires PHP 7.2.5+, v6.x requires PHP 8+. Versions before v5.3.0 don't work with PHP 8. Upgrading PHP can break your installation.
- Don't download from GitHub — GitHub ZIP contains development files. Always download releases from revive-adserver.com/download.
- Email zones only support image banners — text banners and HTML banners don't work in email/newsletter zones. Use image creatives only.
- Geo-targeting requires MaxMind GeoLite2 — you must download and configure the GeoLite2 database separately. Requires a free MaxMind account.
Related skills
/sales-newsletter— Newsletter monetization strategy (paid subscriptions, sponsorships, ad sales, pricing)/sales-adbutler— AdButler full-stack ad server (managed hosting, self-serve portal, email ad zones, REST API + MCP)/sales-epom— Epom hosted ad server + white-label DSP (API included, RTB free for publishers, auto-optimization)/sales-broadstreet— Broadstreet ad manager for local/B2B publishers (newsletter ad zones, sponsored content, WordPress plugin)/sales-adplugg— AdPlugg budget ad server (free-$79/mo, WordPress/Ghost plugins, email ad tags)/sales-kevel— Kevel API-first ad server infrastructure (build custom ad platforms, Decision API)/sales-passendo— Passendo email ad server + SSP (programmatic exchange, direct-sold campaigns)/sales-deliverability— Email deliverability strategy (SPF, DKIM, DMARC, warmup)/sales-do— Not sure which skill to use? The router matches any sales objective to the right skill. Install:npx skills add sales-skills/sales --skill sales-do
Examples
Example 1: Installing Revive Adserver for the first time
User says: "I want to set up my own ad server on my VPS to manage newsletter ads. How do I install Revive?" Skill does: Walks through server requirements (PHP 8+, MySQL/MariaDB, Apache/Nginx), downloading from official site, running the web installer, creating the admin account, and setting up the first advertiser/campaign/zone Result: User has a working Revive Adserver installation ready to serve ads
Example 2: Setting up email newsletter ad zones
User says: "How do I add Revive ads to my email newsletter?" Skill does: Explains creating an Email/Newsletter zone type, the one-active-banner limitation, image-only requirement, how to get the zone invocation code, and the Multiple Ads plugin for rotating multiple banners Result: User has email ad zones generating trackable ad tags for their newsletter
Example 3: Automating campaign management via API
User says: "I want to create campaigns and pull stats from Revive programmatically" Skill does: Shows the XML-RPC v2 API at /api/v2/xmlrpc/, authentication with base64 credentials, creating a campaign via ox.addCampaign, pulling daily statistics, and available PHP wrapper packages on Packagist Result: User can programmatically manage their Revive installation
Troubleshooting
Ads not displaying on website
Symptom: Zone invocation code is placed but no ads appear Cause: No active banners linked to the zone, campaign dates haven't started, or delivery rules exclude the current visitor Solution: Check that banners are linked to the zone and campaign dates include today. Test with delivery rules temporarily disabled. Check browser console for JavaScript errors in the zone invocation code.
Email zone shows broken image
Symptom: Email/newsletter zone tag shows a broken image icon in the email client Cause: The Revive server is unreachable from the email client, or the banner URL has changed Solution: Verify the Revive server URL is publicly accessible (not localhost). Check that the banner image still exists. Test the image URL directly in a browser. Ensure your server's SSL certificate is valid — many email clients block mixed content.
Installation fails after PHP upgrade
Symptom: Revive dashboard shows errors or blank page after upgrading PHP Cause: PHP version incompatibility — v5.x doesn't support PHP 8, v6.x requires PHP 8+ Solution: Check the compatibility matrix: Revive v5.3.0+ supports PHP 7.2.5-7.4, Revive v6.x requires PHP 8.0+. Either downgrade PHP or upgrade Revive to a compatible version.
Related Skills
sales-skills/sales-upviral
tools
VerifiedTrustedCommunity
UpViral platform help — viral referral marketing and list-building platform (by Emarky) for viral sweepstakes, giveaway/reward campaigns, pre-launch waiting lists, and milestone referral programs, with REST API (app.upviral.com/api/v1/), callback-URL webhooks, PHP SDK, fraud detection (IP-based suspicious-referral flagging), A/B testing, smart leaderboards, unlockable incentives, and 30+ native ESP/CRM integrations (Mailchimp, ActiveCampaign, ConvertKit, AWeber, HubSpot, Klaviyo, Intercom) plus Zapier/Make/Pipedream/Integrately/Pabbly. Use when UpViral campaigns aren't tracking referral points correctly, deciding between Starter $79/mo annual (10K leads, 1 brand, NO API) vs Business $119/mo (25K, 2 brands, API + webhooks unlocked) vs Premium $319/mo (100K, 5 brands, dedicated account manager), the API returns errors because you're on the Starter tier where API/webhooks are gated, building an UpViral→CRM or UpViral→data-warehouse pipeline with add_contact / get_leads / get_leads_points / add_points / get_custom_fields / lists methods (uvapikey + uvmethod form-encoded POST), interpreting fraud flags where same-IP referrals get marked suspicious and you must manually activate/delete/blacklist, setting up the Callback URL (webhook) to fire on reward-unlock events, Zapier New Lead / New Reward Unlocked triggers not firing, ClickFunnels/Shopify/funnel-builder integration breaking, the drag-and-drop page builder showing broken widgets or limited customization, the setup feeling long and complicated for your first campaign, or picking UpViral over Viral Loops / KickoffLabs / Vyper / Prefinery / Gleam / KingSumo / ShortStack for a viral campaign. Do NOT use for general newsletter audience growth strategy across all platforms (use /sales-audience-growth), newsletter monetization (use /sales-newsletter), KickoffLabs-specific help (use /sales-kickofflabs), no-code merge-tag newsletter referrals (use /sales-referralkit), SparkLoop paid recommendations (use /sales-sparkloop), or full-stack multi-level Level-1/2/3 referral/affiliate tracking (use /sales-referralhero).
39SKILL.mdUpdated Jun 4, 2026
sales-skills/sales-referralhero
development
VerifiedTrustedCommunity
ReferralHero platform help — full-stack referral, affiliate, waitlist, contest, and NPS platform with subscriber API, webhooks, Zapier, Mailchimp/Kit/AWeber/Klaviyo/ActiveCampaign/SendLane connectors, coupon codes, multi-level referral tracking (Level 1/2/3), anti-fraud, and 5,000 calls/hour rate limit. Use when ReferralHero campaigns aren't tracking referrals correctly, deciding between PRO $199/mo (10K members, includes API + webhooks) and PREMIUM $399/mo (50K members, adds ReCaptcha + SMS verification), authentication is failing with no_token or X-API-Key header is being ignored, multi-level referral counts (Level 2/3) aren't appearing for downline subscribers, coupon group endpoints return 404 or coupon arrays max out, hitting the 5,000 calls/hour soft limit and getting too_many_calls 429s, the Mailchimp/Kit native integration is double-adding subscribers, webhook payloads aren't firing on confirmation events, importing Stripe customer IDs through transaction tracking, generating reward fulfillment when subscribers cross milestone thresholds (promote/unlock_promoted_reward), comparing ReferralHero against SparkLoop/ReferralKit/Viral Loops/GrowSurf/KickoffLabs for referral marketing, or routing referral data via add_bulk_transactions (500-transaction batch limit). Do NOT use for general newsletter audience growth strategy (use /sales-audience-growth), general newsletter monetization (use /sales-newsletter), no-code newsletter-only referral with merge-tag insertion (use /sales-referralkit), SparkLoop's paid recommendations or partner network (use /sales-sparkloop), or affiliate program strategy across many platforms (use /sales-affiliate-program).
39SKILL.mdUpdated Jun 4, 2026
sales-skills/sales-kickofflabs
tools
VerifiedTrustedCommunity
KickoffLabs platform help — viral marketing platform for pre-launch waitlists, bonus-entry giveaways, milestone-reward referral programs, leaderboard giveaways, and email opt-in bribes with REST API v1 + v2, server-side webhooks (in/out), KOL.js JavaScript library, AnyForm script for custom pages, fraud detection (duplicate_ip / bounced / duplidate_email flags), SMS verification add-on, native ESP integrations (Klaviyo, Mailchimp, ActiveCampaign, Brevo), website builders (Webflow, Wix, Squarespace, Weebly), Shopify, Facebook Audiences, Slack, Zapier. Use when KickoffLabs viral campaigns aren't tracking referrals correctly, deciding between Hobby $13/mo annual (500 leads/mo no A/B no reward emails) vs Premium $48/mo (2.5K + A/B + reward emails + tracking pixels) vs Business $99/mo (10K + custom email templates + custom domains + advanced reporting + 3 team) vs Enterprise $202/mo (25K + 5 team + SMS included), API key getting rejected because you embedded it in client-side JavaScript instead of server-side, can't decide whether to use v1 /subscribe vs v2 /tags/:TAG_ID/lead for lead creation, webhook payloads firing with `__fraudulent` flag and you need to interpret the duplicate_ip/bounced/duplidate_email reason codes (yes, duplidate is spelled that way in their docs), AnyForm script not posting to KickoffLabs vs native API endpoint, leaderboard endpoint returning more than 50 leads is not allowed, social_id (kid in share URLs) attribution chain breaking between v1 and v2, contest score vs lead count metrics in the webhook payload are confusing, SMS Verification only available on Premium+ as $50/mo add-on (Enterprise includes), per-month lead cap auto-upgrades at $8 per 1000 overage leads, picking between KickoffLabs and Viral Loops / UpViral / Prefinery / ReferralCandy / Voucherify for viral campaign type fit, or rate limit per tier (10-100 calls/minute) is hitting on bulk imports. Do NOT use for general newsletter audience growth strategy (use /sales-audience-growth), general newsletter monetization (use /sales-newsletter), no-code merge-tag-only newsletter referrals (use /sales-referralkit), SparkLoop paid recommendations + partner network (use /sales-sparkloop), or full-stack referral/affiliate with multi-level Level-1/2/3 tracking (use /sales-referralhero).
39SKILL.mdUpdated Jun 4, 2026
sales-skills/sales-do
development
VerifiedTrustedCommunity
Routes any sales, marketing, ad, or GTM objective to the right specialized skill and outputs the install command for that skill plus a ready-to-paste prompt packed with the user's context. Asks clarifying questions when the objective is ambiguous, then hands back a copy-paste-runnable next step. Covers prospecting, outbound cadences, deals, proposals, forecasting, deliverability, enrichment, intent, content, coaching, CRO, SEO, launch directories, newsletters, email/SMS/push marketing, chatbots, influencer marketing, social media, employee advocacy, media relations, reviews, data hygiene, B2B advertising, retargeting, affiliate, loyalty, digital products, memberships, webinars, checkout, and platform-specific help. Use when the user has a sales or marketing question and isn't sure which skill to use, or wants a multi-skill sequence with a batch install command. Do NOT use to solve problems directly — this skill only routes.
39SKILL.mdUpdated Apr 24, 2026