Agent skill

Ads Math

by AgriciDaniel in AgriciDaniel/claude-ads

Calculate and model paid-media CPA, CPL, CPC, CPM, ROAS, MER, break-even targets, contribution margin, LTV:CAC, impression-share opportunity, budgets, forecasts, and experiment economics.

MITAuto-check passedMarketing & SEO

Install Ads Math

skills CLI
$ npx skills add AgriciDaniel/claude-ads --skill ads-math -a claude-code

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

GitHub CLI
$ gh skill install AgriciDaniel/claude-ads ads-math --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/AgriciDaniel/claude-ads.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ads-math .claude/skills/ads-math && 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
ads-math
GitHub stars
9.8k
Token cost
~275 tokens
SKILL.md length
96 words
Files
1
Skills in repo
32
Repo updated
First seen
Licence
MIT

At a glance

Calculate and model paid-media CPA, CPL, CPC, CPM, ROAS, MER, break-even targets, contribution margin, LTV:CAC, impression-share opportunity, budgets, forecasts, and experiment economics.

  • Works in 6 steps: Identify the decision and collect units,… → Show the formula and map every input to… → Validate denominators, sign, missing… → …
  • Break-even analysis
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • ROAS calculator

What it does

Ads Math is an agent skill from AgriciDaniel/claude-ads. Calculate and model paid-media CPA, CPL, CPC, CPM, ROAS, MER, break-even targets, contribution margin, LTV:CAC, impression-share opportunity, budgets, forecasts, and experiment economics. Use for PPC math, ad calculator, break-even analysis, ROAS calculator, CPA calculator, budget forecast, LTV CAC, or MER.

Its SKILL.md is about 280 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Paid advertising. The repository describes itself as: Claude-first paid-media operations skill for Claude Code across 12 ad platforms (Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat… The licence is MIT.

When your agent uses it

  • Break-even analysis
  • ROAS calculator
  • Budget forecast

Example prompts

  • “/ads-math”

Workflow steps

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

  1. Identify the decision and collect units, currency, period, tax/refund treatment,
  2. Show the formula and map every input to an operator value or cited artifact.
  3. Validate denominators, sign, missing values, incompatible windows, and unit
  4. Calculate base, downside, and upside cases where uncertainty affects the decision.
  5. Keep platform-attributed revenue, blended business revenue, cash flow, and
  6. Return machine-readable inputs, formulas, outputs, sensitivities, and decision

What it can do on your machine

Read from SKILL.md and the folder at commit ac21644. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Ads Math loads about 275 tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 96 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~79
When it runs · the whole SKILL.md, loaded when a task matches
~275

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from AgriciDaniel/claude-ads at commit ac21644, republished under its MIT licence (© AgriciDaniel). 96 words, ~275 tokens.

Download SKILL.mdSave it as .claude/skills/ads-math/SKILL.md (or your agent's skills folder).
name
ads-math
description
Calculate and model paid-media CPA, CPL, CPC, CPM, ROAS, MER, break-even targets, contribution margin, LTV:CAC, impression-share opportunity, budgets, forecasts, and experiment economics. Use for PPC math, ad calculator, break-even analysis, ROAS calculator, CPA calculator, budget forecast, LTV CAC, or MER.

Paid Media Financial Model

  1. Identify the decision and collect units, currency, period, tax/refund treatment, margin, attribution basis, and uncertainty.
  2. Show the formula and map every input to an operator value or cited artifact.
  3. Validate denominators, sign, missing values, incompatible windows, and unit conversions.
  4. Calculate base, downside, and upside cases where uncertainty affects the decision.
  5. Keep platform-attributed revenue, blended business revenue, cash flow, and contribution margin distinct.
  6. Return machine-readable inputs, formulas, outputs, sensitivities, and decision implications.

Never fabricate missing financial inputs, hide division-by-zero, or present a point forecast without its assumptions.

© AgriciDaniel, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/ads-math of AgriciDaniel/claude-ads.

Open the folder on GitHubat commit ac21644

Compare with similar skills

Ads Math 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.

Ads Math compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ads Math this skillAgriciDaniel/claude-ads9.8k—~275Automated safety check: PassMIT
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
  • Marketing Os

    Yuzzyuk/marketing-os

    A complete marketing department in one skill. An agent skill from Yuzzyuk/marketing-os.

    536 GitHub stars~2.5k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed

More from AgriciDaniel/claude-ads

All 32 skills in this repo
  • 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.8k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Amazon Ads Audit

    AgriciDaniel/claude-ads

    Audits an Amazon Ads account across Sponsored Products, Brands, Display and DSP, producing evidence-based findings, prioritized recommendations and draft-only changes.

    9.8k GitHub stars~531 tokensUpdated today
    Auto-check passed
  • Apple Ads Audit

    AgriciDaniel/claude-ads

    Audits Apple Ads accounts across measurement, campaign and keyword structure, bidding, budgets and policy, and returns evidence-based findings as schema-valid JSON.

    9.8k GitHub stars~532 tokensUpdated today
    Auto-check passed
  • Google Ads Audit

    AgriciDaniel/claude-ads

    Audits a Google Ads account across measurement, search terms, structure, creative, bidding, budgets and policy, and keeps every change as a draft.

    9.8k GitHub stars~799 tokensUpdated today
    Auto-check passed
  • LinkedIn Ads Audit

    AgriciDaniel/claude-ads

    Audits a LinkedIn Ads account across measurement, professional audiences, lead generation, ABM, creative, bidding, pacing, automation and policy, returning findings as validated JSON.

    9.8k GitHub stars~510 tokensUpdated today
    Auto-check passed
  • Meta Ads Audit

    AgriciDaniel/claude-ads

    Audits a Meta Ads account across Pixel and Conversions API, attribution, creative, audiences, placements, budgets and policy, and reports evidence-backed findings.

    9.8k GitHub stars~906 tokensUpdated today
    Auto-check passed

Categories

Questions about Ads Math

What does Ads Math do?

Calculate and model paid-media CPA, CPL, CPC, CPM, ROAS, MER, break-even targets, contribution margin, LTV:CAC, impression-share opportunity, budgets, forecasts, and experiment economics. Ads Math is an agent skill from AgriciDaniel/claude-ads. Calculate and model paid-media CPA, CPL, CPC, CPM, ROAS, MER, break-even targets, contribution margin, LTV:CAC, impression-share opportunity, budgets, forecasts, and experiment economics.

When should I use Ads Math?

Ads Math fits situations like: break-even analysis; ROAS calculator; budget forecast.

How do I install Ads Math in Claude Code?

Run `npx skills add AgriciDaniel/claude-ads --skill ads-math -a claude-code`. Or copy the skill folder (skills/ads-math in AgriciDaniel/claude-ads) into .claude/skills/ads-math in your project. Claude Code loads it when a task matches its description.

How do I install Ads Math in Codex?

Run `npx skills add AgriciDaniel/claude-ads --skill ads-math -a codex`. Or copy the skill folder (skills/ads-math in AgriciDaniel/claude-ads) into .agents/skills/ads-math in your project. Codex loads it when a task matches its description.

Can I use Ads Math 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 AgriciDaniel/claude-ads --skill ads-math -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ads-math, .gemini/skills/ads-math, .github/skills/ads-math and .opencode/skills/ads-math in your project.

What does Ads Math need to run?

SKILL.md names no scripts, command-line tools or credentials: Ads Math is instructions for the agent only.

Does Ads Math 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 Ads Math 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. Review the folder before installing.

What licence does Ads Math use?

Ads Math is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ads Math use?

About 275 tokens (SKILL.md is roughly 1.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ads Math?

Skills that share tags, products or a category with Ads Math: 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 Ads Math?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/claude-ads, which has 9,791 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on October 7, 2026.

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