worklin-retention

Runs read-only Shopify and Klaviyo retention audits and generates draft campaign packages for DTC brands.

1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Logarn/Worklin-ai --skill worklin-retention-logarn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: worklin-retention
Source: https://github.com/Logarn/Worklin-ai/tree/main/assistant/src/config/bundled-skills/worklin-retention
Command: npx skills add https://github.com/Logarn/Worklin-ai --skill worklin-retention-logarn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? DTC brands struggle to understand why customers churn, which lifecycle gaps cost revenue, and which campaigns to run next, because retention data is scattered across Shopify and Klaviyo. This Skill connects those sources read-only, builds a Brand Brain, runs deep retention audits, and produces review-only campaign packages with human approval gates. ## Core Features & Use Cases - Deep Retention Audits: Runs a Klaviyo-only L365 account audit or a full Shopify + Klaviyo commerce audit covering campaign cadence, flows, lifecycle coverage, cohorts, LTV, replenishment, and an opportunity backlog, with visible audit reasoning and PDF-ready artifacts. - Brand Brain & Onboarding: Learns a brand conversationally from its website and public research, capturing voice, positioning, offers, products, and rules before any campaign work begins. - Customer Intelligence & Campaigns: Resolves unified customer identities, scores churn and winback readiness, builds versioned Worklin audience definitions, and generates per-recipient draft campaign packages that never send without explicit human approval. - Use Case: An ecommerce operator connects a Klaviyo API key through the secure prompt, asks "audit my retention", and receives a read-only L365 audit with the top opportunities, an editable document, and a draft-only campaign backlog. ## Quick Start Connect my Klaviyo account and run a deep retention audit of the last 365 days, then show me the top opportunities.

Frequently Asked Questions about worklin-retention

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a Klaviyo retention audit with Worklin?▼

Connect a Klaviyo account through the secure key prompt, then ask for an audit in plain language such as "audit my retention". The skill checks readiness with retention_audit_status and runs retention_deep_audit, producing a Klaviyo-only L365 audit or a full Shopify + Klaviyo audit depending on connected sources.

How do I connect a Klaviyo API key for recurring audits?▼

Call retention_connect_klaviyo, which opens Worklin's secure key prompt, validates the key with GET-only Klaviyo API calls, and stores one credential per account. The raw key never enters chat, and saved connections can be listed with retention_list_klaviyo_accounts.

Can this skill send emails or activate Klaviyo flows?▼

No. Sending, scheduling, flow activation, profile mutation, and segment mutation are blocked by kill switches, and Klaviyo draft creation fails closed while the credential adapter is disabled. All campaign output is draft-only and requires explicit human approval on a separate control-plane surface.

Does the retention audit work without a Shopify connection?▼

Yes. A saved Klaviyo connection alone supports the Klaviyo-only L365 delivery audit covering cadence, flows, forms, and audience posture. Shopify is required only for commerce-truth claims such as product performance, LTV, AOV, replenishment, and revenue reconciliation.

Why does the audit return live_data_required instead of results?▼

The skill forbids fixture or sample data in production, so it returns live_data_required when live connectors are absent or incomplete. It then explains the missing source coverage and offers the next connection or setup step instead of inventing metrics.

How long does a deep retention audit take?▼

A first full deep audit on a real Klaviyo account typically takes about 15-45 minutes depending on account size, API limits, and history depth. Weekly opportunity scans are shorter at roughly 5-15 minutes, and progress is shown through visible task progress labels.