Agent skill

Roi Calculator

by ZJU-REAL in ZJU-REAL/Easel

计算内容营销 ROI:根据投放数据算出 CTR/CPC/CPM/ROAS 等指标,对比行业基准,支持单活动分析与多活动横向比较。

Apache-2.0Auto-check passedMarketing & SEO

Install Roi Calculator

skills CLI
$ npx skills add ZJU-REAL/Easel --skill roi-calculator -a claude-code

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

GitHub CLI
$ gh skill install ZJU-REAL/Easel roi-calculator --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/ZJU-REAL/Easel.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/openclaw/roi-calculator .claude/skills/roi-calculator && 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
roi-calculator
GitHub stars
3.4k
Token cost
~1.1k tokens
SKILL.md length
329 words
Files
4 (incl. scripts, references)
Skills in repo
114
Repo updated
First seen
Licence
Apache-2.0

At a glance

计算内容营销 ROI:根据投放数据算出 CTR/CPC/CPM/ROAS 等指标,对比行业基准,支持单活动分析与多活动横向比较。

  • Works in 7 steps: 解析输入 — 从用户 prompt 中提取数据字段,识别 Mode… → 调用脚本算指标 — → 加载基准 — 读取 benchmarks.md 获取行业基准数据 → …
  • Tasks that involve Paid advertising
  • SKILL.md covers 输入, 输出, 执行步骤 and 有机内容模式, plus 3 more sections
  • Runs Python scripts from its folder

What it does

Roi Calculator is an agent skill from ZJU-REAL/Easel. 计算内容营销 ROI:根据投放数据算出 CTR/CPC/CPM/ROAS 等指标,对比行业基准,支持单活动分析与多活动横向比较。 当用户说"算ROI""投放效果""CTR/CPC/CPM/ROAS""投产比""广告效果""投放数据分析""活动ROI"时使用。

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `EASEL-META.md`, `references/benchmarks.md` and `scripts/calc.py`).

It sits in Marketing & SEO, covering Paid advertising. The repository describes itself as: An open-source AI agent for social media — discover trends, create content, publish everywhere, and learn what works across Xiaohongshu, Douyin, Zhihu, Bilibili, and more.🎨一个开源的… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Paid advertising

Example prompts

  • “CTR/CPC/CPM/ROAS”
  • “投放数据分析”
  • “/roi-calculator”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. 解析输入 — 从用户 prompt 中提取数据字段,识别 Mode A(单组数据)或 Mode B(多组数据)
  2. 调用脚本算指标 —
  3. 加载基准 — 读取 benchmarks.md 获取行业基准数据
  4. 确定对比基准 —
  5. 基准对比(LLM 解读) — 把脚本输出的每个指标与基准比较,标注 ▲ 高于 / ▼ 低于 / ≈ 持平 / ⚠ 显著偏离
  6. 生成诊断(LLM 解读) — 汇总表现突出项和待优化项,给出可操作的改进建议;转达脚本 warnings
  7. Mode B 追加(LLM 解读) — 基于脚本已排好的 ROI 排名,标注最优/最差,分析差异原因,给出预算分配建议

What it can do on your machine

Read from SKILL.md and the folder at commit ede33b8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

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

  • Network

    No URLs in SKILL.md.

    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.

Context cost

Roi Calculator loads about 1.1k tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 36 tokens; SKILL.md has 329 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~36
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.1k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from ZJU-REAL/Easel at commit ede33b8, republished under its Apache-2.0 licence (© ZJU-REAL). 329 words, ~1,137 tokens.

Download SKILL.mdSave it as .claude/skills/roi-calculator/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
roi-calculator
description
计算内容营销 ROI:根据投放数据算出 CTR/CPC/CPM/ROAS 等指标,对比行业基准,支持单活动分析与多活动横向比较。 当用户说"算ROI""投放效果""CTR/CPC/CPM/ROAS""投产比""广告效果""投放数据分析""活动ROI"时使用。
layer
attribute

内容投放 ROI 计算器

根据用户提供的投放数据,计算标准营销效果指标,对比行业基准,输出结构化分析报告。

输入

用户提供以下字段的任意子集(缺失字段跳过其依赖指标):

字段代号单位必要性
投放费用ad_spendCNY核心(为 0 或缺失时切换有机模式)
曝光量impressions次可选
点击量clicks次可选
互动量engagements次(赞+评+转)可选
转化数conversions次可选
客单价avg_order_valueCNY可选
内容制作成本production_costCNY可选,默认不计

两种模式:

  • Mode A — 单活动分析:一组输入数据,输出完整指标卡片
  • Mode B — 多活动对比:多组数据(表格或逐条),按 ROI 降序排列,横向对比

输出

指标计算(公式表)

以下指标仅在分母数据存在且非零时计算,否则标注"数据不足,已跳过":

指标公式依赖字段
CTR(点击率)clicks / impressionsimpressions, clicks
CPC(单次点击成本)ad_spend / clicksad_spend, clicks
CPM(千次曝光成本)(ad_spend / impressions) * 1000ad_spend, impressions
CPE(单次互动成本)ad_spend / engagementsad_spend, engagements
转化率conversions / clicksconversions, clicks
CPA(单次转化成本)ad_spend / conversionsad_spend, conversions
营收conversions * avg_order_valueconversions, avg_order_value
ROAS(广告支出回报率)revenue / ad_spendrevenue, ad_spend
总成本ad_spend + production_costad_spend(production_cost 缺失按 0)
利润revenue - total_costrevenue, total_cost
ROI(revenue - total_cost) / total_costrevenue, total_cost
输出格式

Mode A — 单活动分析:

## 投放效果报告

### 基础数据
(用户提供的原始字段)

### 计算指标
| 指标 | 值 | 公式 | 基准对比 |
|------|----|------|----------|
| CTR  | x% | clicks/impressions | ▲ 高于行业均值 |
| ...  |    |      |          |

### 基准对比图例
▲ 高于行业均值(表现良好)
▼ 低于行业均值(需关注)
≈ 接近行业均值(正常水平)
⚠ 显著偏离(超出基准 2 倍或低于 50%)

### 诊断
- 表现突出:(列出高于基准的指标及优势分析)
- 待优化:(列出低于基准的指标及具体改进方向)
- 综合评价:(一句话总结本次投放效果)

Mode B — 多活动对比:

## 多活动横向对比(按 ROI 降序)

| 活动 | 花费 | 营收 | ROI | ROAS | CTR | CPC | 综合评价 |
|------|------|------|-----|------|-----|-----|----------|
| ...  |      |      |     |      |     |     |          |

### 最优/最差活动分析
(对比 ROI 最高与最低活动的关键指标差异,找出差距来源)

### 预算分配建议
(基于各活动效率,建议预算向高 ROI 活动倾斜的比例)

### 优化建议
(针对低效活动的具体改进方向)

执行步骤

确定性计算交给脚本,LLM 只做解读。 上表各项指标(含营收/利润派生,有机模式另算互动率)、 有机模式切换、字段校验、Mode B 按 ROI 降序排序,全部由 scripts/calc.py 完成(复用 skills/shared/scripts/social_stats.py 的 safe_div,除零/缺字段一律返回 null,不心算、不猜数)。

  1. 解析输入 — 从用户 prompt 中提取数据字段,识别 Mode A(单组数据)或 Mode B(多组数据)
  2. 调用脚本算指标 —
    • Mode A(单活动):
      bash
      python3 skills/openclaw/roi-calculator/scripts/calc.py single --name "活动名" \
        --ad-spend 5000 --impressions 100000 --clicks 3000 \
        --engagements 8000 --conversions 150 --avg-order-value 200 \
        --production-cost 1000
    • Mode B(多活动,按 ROI 降序):把各活动整理成 JSON 数组文件后
      bash
      python3 skills/openclaw/roi-calculator/scripts/calc.py multi --file campaigns.json

    脚本自动:11 指标逐项计算(分母为 0/缺失返回 null 并视为"数据不足")、 营收→ROAS/利润/ROI 派生、ad_spend 为 0/缺失时切有机模式(跳过成本类指标)、 字段校验(负值 / 曝光<点击 / 转化>点击 写入 warnings)、Mode B 按 roi_pct 降序排序并标 roi_rank。

  3. 加载基准 — 读取 benchmarks.md 获取行业基准数据
  4. 确定对比基准 —
    • 有 Profile:读取 platforms.md 确定主平台,选对应平台基准
    • 无 Profile:使用跨平台均值
  5. 基准对比(LLM 解读) — 把脚本输出的每个指标与基准比较,标注 ▲ 高于 / ▼ 低于 / ≈ 持平 / ⚠ 显著偏离
  6. 生成诊断(LLM 解读) — 汇总表现突出项和待优化项,给出可操作的改进建议;转达脚本 warnings
  7. Mode B 追加(LLM 解读) — 基于脚本已排好的 ROI 排名,标注最优/最差,分析差异原因,给出预算分配建议

有机内容模式

当 ad_spend 为 0 或缺失时,自动切换:

  • 跳过所有成本类指标(CPC/CPM/CPE/CPA/ROAS/ROI/利润)
  • 仅计算:CTR(若有 impressions + clicks)、互动率(engagements / impressions)
  • 报告标题标注"有机内容效果分析"
  • 基准对比使用自然流量基准(通常高于付费流量)

Profile 感知

有 Profile 时:

  • 读取 platforms.md 获取主投放平台,选用平台专属基准区间
  • 读取 audience.md 了解受众特征,为转化率判断提供上下文
  • 对比结论使用平台维度的精确基准

无 Profile 时:

  • 使用跨平台综合均值作为基准
  • 在报告末尾附注:"提供账号 Profile(含平台信息)可获得平台专属基准对比"

规则

  1. 不捏造输入 — 所有指标仅从用户提供的数据计算,缺失字段跳过依赖指标
  2. 公式透明 — 每个指标旁标注计算公式,用户可验证
  3. 基准对比 — 与行业基准比较,明确标注高于/低于/持平
  4. 缺失容忍 — 缺字段不假设数值,跳过并说明"因缺少 X 数据无法计算"
  5. 有机切换 — ad_spend 为 0 或缺失时自动切换有机模式,不报错

自研笔记

基准数据来源(定期更新 references/benchmarks.md):

  • Google Ads / Meta Ads 官方行业基准报告
  • 巨量引擎 / 千川 投放效果白皮书
  • 新榜 / 飞瓜 / 蝉妈妈 行业报告
  • 各平台创作者中心公开数据

迭代方向:

  • 增加时间序列对比(周环比、月同比)
  • 支持自定义基准(用户提供历史均值作为对比基线)
  • 接入真实 API 数据源(巨量引擎 / 小红书聚光 / 微信广告)
  • 漏斗可视化输出(impressions → clicks → conversions 漏斗图)
  • 归因模型支持(首次触达 / 末次触达 / 线性归因)
  • 与 content-postmortem SKILL 联动,投放数据反哺内容策略

基准数据维护规则:

  • 每季度对照最新行业报告校准 benchmarks.md 中的数值区间
  • 标注数据采集时间,过期超过 6 个月的基准加 ⚠ 提示
  • 鼓励用户提供自身历史数据,逐步建立账号级内部基准

© ZJU-REAL, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in skills/openclaw/roi-calculator of ZJU-REAL/Easel.

  • SKILL.md
  • EASEL-META.md
  • references/benchmarks.md
  • scripts/calc.py

Open the folder on GitHubat commit ede33b8

Compare with similar skills

Roi Calculator 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.

Roi Calculator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Roi Calculator this skillZJU-REAL/Easel3.4k—~1.1kAutomated safety check: PassApache-2.0
Ad CreativeLeoYeAI/openclaw-marketing-skills1k8 repos~3.4kAutomated safety check: PassCustom licence
Blog GoogleAgriciDaniel/claude-blog2.3k1 repos~3.3kAutomated safety check: NotesMIT
Ad Account Auditoraaron-he-zhu/aaron-marketing-skills2.9k2 repos~2.2kAutomated safety check: PassApache-2.0
Ad Creative Builderaaron-he-zhu/aaron-marketing-skills2.9k2 repos~2.2kAutomated safety check: PassApache-2.0
Ad Test Designeraaron-he-zhu/aaron-marketing-skills2.9k2 repos~2.8kAutomated safety check: PassApache-2.0

Similar skills

  • Ad Creative

    LeoYeAI/openclaw-marketing-skills

    When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform.

    1k GitHub starsUsed in 8 repos~3.4k tokens
    Marketing & SEOAuto-check passed
  • Blog Google

    AgriciDaniel/claude-blog

    Google API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity…

    2.3k GitHub starsUsed in 1 repo~3.3k tokens
    Marketing & SEOAuto-check: notes
  • Ad Account Auditor

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when auditing a paid ad account for incremental contribution, wasted spend, or measurement integrity before scaling; runs a typed 20-item ROAS profile with verified vetoes…

    2.9k GitHub starsUsed in 2 repos~2.2k tokens
    Marketing & SEOAuto-check passed
  • Ad Creative Builder

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "write ad copy", "generate RSA headlines", or "build ad creative at volume"; produces ad units — RSA headlines/descriptions, hooks, and an angle matrix…

    2.9k GitHub starsUsed in 2 repos~2.2k tokens
    Marketing & SEOAuto-check passed
  • Ad Test Designer

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "design an A/B test", "set up a creative/landing test", "run an incrementality test", or "is this result statistically and practically material?"…

    2.9k GitHub starsUsed in 2 repos~2.8k tokens
    Marketing & SEOAuto-check passed
  • Paid Ads Audit

    AgriciDaniel/claude-ads

    Runs a source-grounded paid advertising audit across up to 12 ad platforms, with parallel platform workers, deterministic scoring and a versioned JSON bundle.

    9.9k GitHub stars~1.5k tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed

More from ZJU-REAL/Easel

All 114 skills in this repo
  • Gzh Design

    ZJU-REAL/Easel

    微信公众号文章排版引擎:把 Markdown / Word(.docx) / PDF / 纯文本转成可直接粘贴进公众号编辑器的 HTML,自动章节编号、关键词标记、引言卡、目录、代码块、图片/GIF、作者签名;主题从 references/theme-index.md…

    3.4k GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • 微信公众号文章自动创作与发布工具。给定参考文章、文字或文档,自动搜索整理全网相关信息、生成图文并茂的公众号文章,并发布到微信公众号草稿箱。特别强调反 AI 检测写作。

    3.4k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Card Design

    ZJU-REAL/Easel

    社媒卡片视觉设计系统:提供配色、中文字体层级、满画幅布局、品类骨架和死空白/密度质检,避免模板化 PPT 与廉价 AI 感。

    3.4k GitHub stars~657 tokensUpdated today
    Auto-check passed
  • Ecom Details Image

    ZJU-REAL/Easel

    生成电商商品视觉方案:主图概念、场景图、详情页视觉方向和 AI 生图 Prompt. An agent skill from ZJU-REAL/Easel.

    3.4k GitHub stars~1.1k tokensUpdated today
    Auto-check: notes
  • Infographic

    ZJU-REAL/Easel

    将数据或文字内容转化为可视化信息图,支持静态(AntV)和动画 GIF 两种模式。当用户需要制作信息图、数据可视化、流程图、对比图、动画图表、GIF 图表、思维导图、SWOT 分析图时调用。本地渲染信息图/GIF 动画;要单张静态图片 URL 用 chart-visualization,要 CSV/JSON→整页报告用 data-report

    3.4k GitHub stars~643 tokensUpdated today
    Auto-check passed
  • Novel Writer

    ZJU-REAL/Easel

    长篇小说/网文连载创作:从世界观、人设和三级大纲写到逐章正文,并用文件化状态维护伏笔、前情和跨章一致性. An agent skill from ZJU-REAL/Easel.

    3.4k GitHub stars~1k tokensUpdated today
    Auto-check passed

Categories

Questions about Roi Calculator

What does Roi Calculator do?

计算内容营销 ROI:根据投放数据算出 CTR/CPC/CPM/ROAS 等指标,对比行业基准,支持单活动分析与多活动横向比较。. Roi Calculator is an agent skill from ZJU-REAL/Easel.

When should I use Roi Calculator?

Roi Calculator fits situations like: tasks that involve Paid advertising.

How do I install Roi Calculator in Claude Code?

Run `npx skills add ZJU-REAL/Easel --skill roi-calculator -a claude-code`. Or copy the skill folder (skills/openclaw/roi-calculator in ZJU-REAL/Easel) into .claude/skills/roi-calculator in your project. Claude Code loads it when a task matches its description.

How do I install Roi Calculator in Codex?

Run `npx skills add ZJU-REAL/Easel --skill roi-calculator -a codex`. Or copy the skill folder (skills/openclaw/roi-calculator in ZJU-REAL/Easel) into .agents/skills/roi-calculator in your project. Codex loads it when a task matches its description.

Can I use Roi Calculator 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 ZJU-REAL/Easel --skill roi-calculator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/roi-calculator, .gemini/skills/roi-calculator, .github/skills/roi-calculator and .opencode/skills/roi-calculator in your project.

What does Roi Calculator need to run?

Going by SKILL.md and its folder, Roi Calculator needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Roi Calculator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Roi Calculator 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Roi Calculator use?

Roi Calculator is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Roi Calculator use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 934 tokens, read only when the agent opens those files.

What are the alternatives to Roi Calculator?

Skills that share tags, products or a category with Roi Calculator: Ad Creative (LeoYeAI/openclaw-marketing-skills, 1k stars), Blog Google (AgriciDaniel/claude-blog, 2.3k stars), Ad Account Auditor (aaron-he-zhu/aaron-marketing-skills, 2.9k stars) and Ad Creative Builder (aaron-he-zhu/aaron-marketing-skills, 2.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Roi Calculator?

ZJU-REAL (a GitHub organization) maintains it in ZJU-REAL/Easel, which has 3,441 GitHub stars. The repository holds 114 skills in this directory. The repository was last updated on October 11, 2026.

Source: ZJU-REAL/Easel on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.