Roi Calculator
Use when the user asks to "calculate influencer ROI", "prove campaign value", or "what was our ROAS"; produces direct ROI/ROAS, earned media value, attributi... Skill: Roi Calculator Owner: aaron-he-zhu Summary: Use when the user asks to "calculate influencer ROI", "prove campaign value", or "what was our ROAS"; produces direct ROI/ROAS, earned media value, attributi... Tags: latest:19.0.0 Version history: v19.0.0 | 2026-07-24T15:07:03.940Z | auto **roi-calculator 19.0.0 Changelog** - Added distribution-manifest.json file for new distribution/configuration support. - Updated
Rank
62
Safety
84
Downloads
1.2k
Updated
Oct 11, 2026
Version
19.0.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.2K downloadsadoption · observed Oct 11, 2026
- Latest release
- 19.0.0release · observed Jul 24, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17e1tg8pjra8dn1dvtq21sahx83hrxj:roi-calculator- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-aaron-he-zhu-roi-calculator/snapshot"
Documentation
CLAWHUB
145,492 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: roi-calculator
slug: aaron-roi-calculator
displayName: "ROI Calculator · ROI 计算"
summary: "活动投入产出核算:成本归集、收益口径与 ROI 及 STAR 回报(R)证据汇总"
description: 'Use when the user asks to "calculate influencer ROI", "prove campaign value", or "what was our ROAS"; produces direct ROI/ROAS, earned media value, attribution-modeled revenue, LTV-based ROI, and a stakeholder-ready summary. Not for building the full slide/written report — use report-generator. 达人营销ROI计算/投资回报测算'
version: "19.0.0"
license: Apache-2.0
compatibility: "Claude Code and compatible agent-skill hosts"
homepage: "https://github.com/aaron-he-zhu/aaron-marketing-skills"
when_to_use: "Use when measuring or projecting influencer campaign ROI, justifying or defending budgets, comparing ROI across campaigns or channels, evaluating individual influencer or tier value, or preparing executive-level ROI numbers. Activate when the user supplies spend and results data and wants ROI, ROAS, EMV, CPA/CAC, attribution, or LTV impact computed."
argument-hint: "<campaign name or spend> [revenue] [results data]"
metadata: {"author": "aaron-he-zhu", "version": "19.0.0", "discipline": "influencer", "phase": "report", "geo-relevance": "low", "hermes": {"tags": ["marketing", "influencer", "report"], "category": "influencer"}, "openclaw": {"emoji": "📣", "homepage": "https://github.com/aaron-he-zhu/aaron-marketing-skills"}}
---
# ROI Calculator
This skill helps you calculate and communicate the return on investment for influencer marketing campaigns using various methodologies appropriate for your goals and available data.
> **Cross-discipline (paid ads):** this is the shared **return-math engine** for paid ads — [paid-measurement-loop](../../../ad/scale/paid-measurement-loop/SKILL.md), [attribution-reconciler](../../../ad/scale/attribution-reconciler/SKILL.md), and budget-optimizer delegate ROAS/CPA/payback ratios here rather than recomputing them. Save paid runs under `memory/ad/roi-calculator/`.
## Quick Start
Shortest invocation:
```
Calculate ROI for our influencer campaign: $25K spend, $72K revenue, 2.1M reach
```
Common scenario — compare methods before reporting:
```
What's the ROI of our campaign using direct revenue, EMV, and LTV-based methods?
```
## Skill Contract
- **Reads**: campaign spend breakdown, results data (reach, impressions, engagements, clicks, conversions, revenue, new customers), AOV and repeat-rate data if LTV is in scope, any prior performance output from `performance-analyzer`.
- **Writes**: ROI calculation file at `memory/influencer/roi-calculator/YYYY-MM-DD-<topic>.md` containing direct ROI/ROAS, EMV, cost-efficiency metrics, attribution-modeled revenue, LTV-based ROI, by-influencer ROI, and a summary report block.
- **Promotes**: only with separate authorization, durable headline numbers with their attribution window, source, and uncertainty; a calculation request alone does not authorize hot-cache writes.
- **Done when**:
1. At least one ROI methodology is compute_meta.json
{
"ownerId": "kn73qjxwmbna25qq8q051epqt980sys5",
"slug": "roi-calculator",
"version": "19.0.0",
"publishedAt": 1784905623940
}references/roi-templates.md
# ROI Calculator — Templates & Benchmark Inputs Fill-in templates for each methodology in [../SKILL.md](../SKILL.md) Instructions, plus the worked example and benchmark-evidence contract. Each block maps to a numbered step. ## Step 1 — ROI Calculation Inputs ```markdown ### ROI Calculation Inputs **Campaign Details**: - Campaign: [name] - Duration: [dates] - Objective: [awareness/consideration/conversion] **Investment (Total Spend)**: | Category | Amount | |----------|--------| | Influencer fees | $[X] | | Product/Gifting | $[X] | | Production costs | $[X] | | Paid amplification | $[X] | | Agency/Tools | $[X] | | **Total Investment** | **$[X]** | **Results Data**: | Metric | Value | |--------|-------| | Total Reach | [X] | | Total Impressions | [X] | | Total Engagements | [X] | | Video Views | [X] | | Link Clicks | [X] | | Conversions/Sales | [X] | | Revenue | $[X] | | New Customers | [X] | ``` ## Step 2 — Direct ROI Calculation ```markdown ## Direct ROI Calculation ### Simple ROI **Formula**: (Revenue - Investment) / Investment × 100 ``` Revenue: $[X] Investment: $[X] Profit: $[X] ROI = ($[Revenue] - $[Investment]) / $[Investment] × 100 ROI = [X]% ``` ### Return on Ad Spend (ROAS) **Formula**: Revenue / Investment ``` ROAS = $[Revenue] / $[Investment] ROAS = [X]:1 Interpretation: For every $1 spent, generated $[X] in revenue ``` ### Direct ROI Summary | Metric | Value | Declared target (source/date) | Comparison | |--------|-------|-------------------------------|------------| | ROI % | [X]% | [X]% ([source], [date]) | [above/below/equal/pending] | | ROAS | [X]:1 | [X]:1 ([source], [date]) | [above/below/equal/pending] | | Profit | $[X] | Not applicable | Descriptive | **Assessment**: [Profitable/Break-even/Loss] ``` ## Step 3 — Earned Media Value (EMV) ```markdown ## Earned Media Value Calculation ### EMV Methodology EMV estimates the equivalent paid media cost to achieve the same results. ### Impression-Based EMV **Formula**: Impressions × declared comparable CPM / 1000 | Platform | Impressions | CPM | EMV | |----------|-------------|-----|-----| | Instagram | [X] | $[X] | $[X] | | TikTok | [X] | $[X] | $[X] | | YouTube | [X] | $[X] | $[X] | | **Total** | **[X]** | - | **$[X]** | ### Engagement-Based EMV **Formula**: Engagements × Cost per Engagement | Engagement Type | Volume | CPE | EMV | |-----------------|--------|-----|-----| | Likes | [X] | $[X] | $[X] | | Comments | [X] | $[X] | $[X] | | Shares | [X] | $[X] | $[X] | | Saves | [X] | $[X] | $[X] | | Video Views | [X] | $[X] | $[X] | | **Total** | - | - | **$[X]** | ### Combined EMV | Method | Value | |--------|-------| | Impression EMV | $[X] | | Engagement EMV | $[X] | | **Average EMV** | **$[X]** | ### EMV ROI ``` EMV Generated: $[X] Investment: $[X] EMV Multiple: [X]x For every $1 spent, earned $[X] in equivalent media value ``` ### EMV Caveats ⚠️ **Note**: EMV is an estimate and varies by methodology. Use for directional comparison, no
skill-card.md
## Description: Calculates influencer campaign ROI and ROAS, earned media value, attribution-modeled revenue, LTV-based ROI, and stakeholder-ready summaries from supplied campaign performance data. This skill is ready for commercial/non-commercial use. ## Publisher: [aaron-he-zhu](https://clawhub.ai/user/aaron-he-zhu) ### License/Terms of Use: Apache-2.0 ## Use Case: Marketing teams, creators, and operators use this skill to calculate or project influencer campaign returns, compare ROI methods, evaluate individual creators or tiers, and prepare numbers for budget justification or reporting. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Campaign, ecommerce, analytics, or CRM inputs may contain sensitive business performance information. Mitigation: Review supplied data before use and authorize memory saves or connector-backed pulls only when those numbers may be reused for future campaign analysis. Risk: ROI, attribution, or benchmark comparisons may overstate campaign performance when conversions, targets, or comparison baselines are unverified. Mitigation: Use source-dated targets and attribution windows, label each figure as measured, user-provided, calculated, or estimated, and avoid attributable-return claims when conversions are unverified. Risk: Earned media value is directional and can vary by methodology. Mitigation: Present EMV as an estimate, disclose the CPM or engagement assumptions used, and avoid treating EMV as absolute revenue. ## Reference(s): - [ROI templates and benchmark inputs](references/roi-templates.md) - [ClawHub skill page](https://clawhub.ai/aaron-he-zhu/skills/roi-calculator) - [Project homepage](https://github.com/aaron-he-zhu/aaron-marketing-skills) ## Skill Output: **Output Type(s):** [text, markdown, files, guidance] **Output Format:** [Markdown calculation summaries and optional memory files] **Output Parameters:** [1D] **Other Properties Related to Output:** [May save ROI calculation files only after user authorization; can use connector-backed campaign data when available.] ## Skill Version(s): 19.0.0 (source: frontmatter and release metadata) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
distribution-manifest.json
{
"capabilities": [
"inline-delivery",
"canonical-state-read"
],
"capability_ceiling": "lite",
"catalog_sha256": "6f0256cf52710f2916ecebaea0f3110c9313099ec4a69a11cac72ba9b2f3b940",
"files": [
{
"bytes": 11428,
"mode": "0644",
"path": "SKILL.md",
"sha256": "67510ab1308579d799525c21277cdb6ec6f3962dcb00463d4e1f7a640cf80311"
},
{
"bytes": 12637,
"mode": "0644",
"path": "references/roi-templates.md",
"sha256": "2f58cf3247a96e888243d286f153a1d854a29d6916c27e047d171da97562cf14"
}
],
"files_sha256": "5c32d263a53936794c87e0c24680f95bd8983d4d38d17f06aebd012f75f087d9",
"hash_algorithm": "sha256",
"kind": "standalone-skill",
"manifest_excludes": [
"distribution-manifest.json"
],
"manifest_path": "distribution-manifest.json",
"package_ceiling": {
"max_bytes": 1000000,
"max_files": 64
},
"profile": "lite",
"profile_definition_sha256": "4598e1f7bba667ef928ea2a60a6252ad9348086e9eecab29437db442df2a568e",
"schema_version": "1.1",
"source": {
"commit": "f552620c278afddcb25d09637a0cfcc1ce48faf4",
"repository": "aaron-he-zhu/aaron-marketing-skills"
}
}AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/aaron-he-zhu/skills/roi-calculator",
"sourceUrl": "https://clawhub.ai/aaron-he-zhu/skills/roi-calculator",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T03:32:47.787Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-aaron-he-zhu-roi-calculator/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-aaron-he-zhu-roi-calculator/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T03:32:47.787Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.2K downloads",
"href": "https://clawhub.ai/aaron-he-zhu/roi-calculator",
"sourceUrl": "https://clawhub.ai/aaron-he-zhu/roi-calculator",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T03:32:47.787Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "19.0.0",
"href": "https://clawhub.ai/aaron-he-zhu/roi-calculator",
"sourceUrl": "https://clawhub.ai/aaron-he-zhu/roi-calculator",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-24T15:07:03.940Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-aaron-he-zhu-roi-calculator/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-aaron-he-zhu-roi-calculator/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 19.0.0",
"description": "**roi-calculator 19.0.0 Changelog** - Added `distribution-manifest.json` file for new distribution/configuration support. - Updated SKILL.md: improved bilingual clarity in description (added Chinese summary), version incremented, and metadata revised. - Removed `skill-card.md` file to streamline documentation.",
"href": "https://clawhub.ai/aaron-he-zhu/roi-calculator",
"sourceUrl": "https://clawhub.ai/aaron-he-zhu/roi-calculator",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-24T15:07:03.940Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
