← Back to Skills Marketplace
rijoyai

Affiliate Kol Roi Monitor

by RIJOY-AI · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ✓ Security Clean
269
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install affiliate-kol-roi-monitor
Description
Automate affiliate and KOL reconciliation, attribution, true ROAS, commission math, and renewal strategy. Use when the user has more than ~5 KOL or affiliate...
README (SKILL.md)

Affiliate & KOL ROI Monitor

You replace manual commission runs, order-to-creator matching, and influencer performance reporting with a repeatable workflow: attribution data → net of refunds → profit-aware economics → tiered renewals.

Core workflow (always follow in order)

  1. Extract attribution data — Map each order (or session) to a creator: discount codes, UTM (utm_source, utm_medium, utm_campaign), affiliate platform IDs, first-touch / last-touch rules. State the rule you use.
  2. Exclude refund / chargeback orders — Remove or weight down refunded revenue and reversed commissions for the reporting window. Call out partial refunds.
  3. Compute actual profit (where inputs allow) — Revenue net of refunds × margin (or COGS) minus creator cost (fixed fee + variable commission) = contribution per creator. If margin unknown, show revenue net of refunds and CAC using payout as cost.
  4. Tiered renewal proposals — Rate each creator; propose continue / renegotiate / pause with concrete terms (rate, cap, exclusivity, content minimums).

When NOT to use

  • No order or payout data — only branding or follower counts.
  • Single creator, no reconciliation — simple contract review only.
  • Paid ads (Meta/Google) without affiliate linkage — use ads ROAS skills.

Gather context (infer first; ask gaps)

  1. Platform: Shopify, WooCommerce, Impact, ShareASale, custom spreadsheet?
  2. Attribution: code-only, UTM-only, or hybrid; window (e.g. 7-day click).
  3. Commission model: % of sale, flat per order, hybrid, tiered by volume.
  4. Refund policy: full window for affiliate eligibility; chargebacks.
  5. Gross margin or COGS % (or confirm "use payout as CAC proxy").
  6. Renewal date or campaign end.

For fraud heuristics and renewal rubric detail, read references/affiliate_playbook.md when needed.

Mandatory success output: master table

Every full affiliate reconciliation or ROI report must include this table (one row per creator; use Influencer ID as the stable key — handle, platform ID, or internal code):

Influencer ID Orders attributed Actual revenue CAC Renewal rating

Column definitions

  • Influencer ID: Stable identifier (agree with merchant).
  • Orders attributed: Count of orders matched to this creator in the window, after refund/chargeback exclusion (state rule).
  • Actual revenue: Net revenue attributable to that creator (gross order value minus refunds for attributed orders), same currency.
  • CAC: Customer acquisition cost for that creator’s attributed sales — typically (fixed fees + variable commissions + product/samples allocated) divided by new customers or by attributed orders; if only payout is known, define CAC as total creator cost / attributed orders and label it clearly.
  • Renewal rating: Tier such as A (renew strong), B (renew with caps), C (renegotiate or shorten), D (pause / investigate fraud) — always tie to numbers (conversion, refund rate, traffic quality).

Below the table, add: ROAS proxy (revenue / creator cost), fraud or quality flags if any, and renewal terms per tier.

Pushy deliverables (when user asks vaguely)

If they ask "who should we keep" or "affiliate ROI" without structure, still output: the master table, attribution rule summary, refund-adjusted figures, and at least two renewal scenarios (e.g. same rate vs reduced rate + cap).

Report outline (full run)

  1. Scope — date range, attribution rule, currency.
  2. Master table — required columns above.
  3. Refund / chargeback impact — table or bullets per creator if material.
  4. Profit or contribution — formula stated; margin assumptions if used.
  5. Fraud / low-quality signals — spikes, refund rate, session quality (if data exists).
  6. Renewal playbook — A/B/C/D actions and suggested contract language bullets.

Split with other skills

  • Paid social ads without affiliates → not this skill.
  • Legal contracts → flag for counsel; you provide economic summary only.
Usage Guidance
This skill is an instruction-only workflow that will ask you to provide order exports, refund records, and attribution mapping (discount codes, UTMs, or affiliate IDs). Before using it: (1) provide only the minimum data needed (sanitized CSVs or samples) rather than full production credentials or admin API keys, (2) remove or anonymize any customer PII if you don't want it processed, (3) confirm margin/COGS or accept that the skill will use payout-as-CAC proxies if you don't provide them, and (4) if you plan to add automation scripts later, review any code for networking or credential usage—currently no install or external endpoints are present. If you need legal contract language, treat the skill's output as advisory and have counsel review final terms.
Capability Analysis
Type: OpenClaw Skill Name: affiliate-kol-roi-monitor Version: 0.1.0 The affiliate-kol-roi-monitor skill bundle is a well-structured tool designed for business analytics, specifically for reconciling affiliate commissions and calculating ROI. The instructions in SKILL.md and the logic in references/affiliate_playbook.md are focused entirely on data processing, attribution modeling, and performance reporting without any signs of malicious intent, data exfiltration, or unauthorized execution.
Capability Assessment
Purpose & Capability
Name/description match the instructions: the skill describes attribution, refund-adjusted revenue, CAC/ROAS calculations, fraud heuristics, and renewal proposals and only requires order/payout/attribution data the merchant would reasonably provide. There are no unrelated credential or binary requests.
Instruction Scope
SKILL.md stays on-topic: it asks the agent to extract attribution from orders/sessions, exclude refunds, compute economics, and propose renewals. It recommends reading the included playbook for heuristics. It does not instruct the agent to read arbitrary system files, access unrelated environment variables, or send data to external endpoints.
Install Mechanism
Instruction-only skill with no install spec and no code files to execute. There is a scripts/README noting optional automation, but no actual scripts or download/install steps are present.
Credentials
No environment variables, credentials, or config paths are requested. The workflow expects user-provided data exports (orders, refunds, codes) which is appropriate for the task; there are no disproportionate secret requests.
Persistence & Privilege
Skill is not forced-always and does not request persistent system-wide changes. It is user-invocable and can be invoked autonomously per platform defaults, which is expected for a skill of this type.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install affiliate-kol-roi-monitor
  3. After installation, invoke the skill by name or use /affiliate-kol-roi-monitor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
- Initial release of affiliate-kol-roi-monitor. - Automates reconciliation, attribution, and commission calculations for affiliate and KOL campaigns with more than ~5 partners. - Accurately matches orders to creators using discount codes, UTM parameters, and platform data, with clear attribution rules. - Excludes refunded/chargeback orders and calculates profit and true CAC per creator. - Generates a master table with per-creator metrics and renewal rating, supporting fraud detection and renewal strategy. - Outlines a repeatable workflow, mandatory deliverables, and rules for when to apply or not apply the skill.
Metadata
Slug affiliate-kol-roi-monitor
Version 0.1.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Affiliate Kol Roi Monitor?

Automate affiliate and KOL reconciliation, attribution, true ROAS, commission math, and renewal strategy. Use when the user has more than ~5 KOL or affiliate... It is an AI Agent Skill for Claude Code / OpenClaw, with 269 downloads so far.

How do I install Affiliate Kol Roi Monitor?

Run "/install affiliate-kol-roi-monitor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Affiliate Kol Roi Monitor free?

Yes, Affiliate Kol Roi Monitor is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Affiliate Kol Roi Monitor support?

Affiliate Kol Roi Monitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Affiliate Kol Roi Monitor?

It is built and maintained by RIJOY-AI (@rijoyai); the current version is v0.1.0.

💬 Comments