Agent skill

Budget Optimizer

by aaron-he-zhu in aaron-he-zhu/aaron-marketing-skills

A skill your agent uses when the user asks to "allocate my influencer budget", "optimize spend across tiers", or "compare budget scenarios"; produces a tier/platform/content allocation table, ROI…

Apache-2.0Auto-check passedMarketing & SEO

Install Budget Optimizer

skills CLI
$ npx skills add aaron-he-zhu/aaron-marketing-skills --skill budget-optimizer -a claude-code

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

GitHub CLI
$ gh skill install aaron-he-zhu/aaron-marketing-skills budget-optimizer --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/aaron-he-zhu/aaron-marketing-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/influencer/target/budget-optimizer .claude/skills/budget-optimizer && 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
budget-optimizer
GitHub stars
2.9k
Token cost
~3k tokens
SKILL.md length
1,003 words
Files
2 (incl. references)
Skills in repo
119
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when the user asks to "allocate my influencer budget", "optimize spend across tiers", or "compare budget scenarios"; produces a tier/platform/content allocation table, ROI…

  • Works in 3 steps: Allocation sums to 100% of the stated… → Every projected metric includes its… → One recommended scenario is named with…
  • The user asks to allocate my influencer budget
  • SKILL.md covers Quick Start, Skill Contract, Cross-discipline: ad spend… and Data Sources, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Budget Optimizer is an agent skill from aaron-he-zhu/aaron-marketing-skills. Use when the user asks to "allocate my influencer budget", "optimize spend across tiers", or "compare budget scenarios"; produces a tier/platform/content allocation table, ROI and CPM/CPE projections, scenario comparisons, and mid-campaign reallocation moves. Not for building the full campaign plan — use campaign-planner. 达人预算分配/投放预算优化

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/templates.md`). Compatibility notes: Claude Code and compatible agent-skill hosts

It sits in Marketing & SEO, covering Influencer and creator marketing and Paid advertising. The repository describes itself as: 120 marketing skills as an AI marketing staff — plugin, portable skills, or an 8-bot team across 7 disciplines (narrative, SEO/GEO, social, email, paid, influencer, launch) on… The licence is Apache-2.0.

When your agent uses it

  • The user asks to allocate my influencer budget
  • Optimize spend across tiers
  • Compare budget scenarios
  • Produces a tier/platform/content allocation table

Example prompts

  • “allocate my influencer budget”
  • “optimize spend across tiers”
  • “compare budget scenarios”
  • “/budget-optimizer”

Requirements

  • Compatibility (from SKILL.md): Claude Code and compatible agent-skill hosts

Workflow steps

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

  1. Allocation sums to 100% of the stated budget; any contingency amount follows a user rule or a source-dated planning anchor rather than a…
  2. Every projected metric includes its formula, input refs, evidence window, and Measured / User-provided / Estimated label.
  3. One recommended scenario is named with its rationale, or the numerical scenario remains NEEDS_INPUT with an exact evidence-request plan.

What it can do on your machine

Read from SKILL.md and the folder at commit d5529cb. 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 (its code samples are markdown).

    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.

  • Compatibility

    Claude Code and compatible agent-skill hosts

    From compatibility in the SKILL.md frontmatter.

Context cost

Budget Optimizer loads about 3k tokens when it runs, and up to ~5.9k if it reads all its reference files. Until then it costs about 89 tokens; SKILL.md has 1,003 words of instructions outside code blocks.

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

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 aaron-he-zhu/aaron-marketing-skills at commit d5529cb, republished under its Apache-2.0 licence (© aaron-he-zhu). 1,003 words, ~2,951 tokens.

Download SKILL.mdSave it as .claude/skills/budget-optimizer/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
budget-optimizer
description
Use when the user asks to "allocate my influencer budget", "optimize spend across tiers", or "compare budget scenarios"; produces a tier/platform/content allocation table, ROI and CPM/CPE projections, scenario comparisons, and mid-campaign reallocation moves. Not for building the full campaign plan — use campaign-planner. 达人预算分配/投放预算优化
compatibility
Claude Code and compatible agent-skill hosts
slug
budget-optimizer
displayName
Budget Optimizer · 预算优化
summary
跨创作者与层级的预算分配:目标导向的花费拆分与情景对比
version
20.1.0
license
Apache-2.0
homepage
https://github.com/aaron-he-zhu/aaron-marketing-skills
when_to_use
Use when planning budget allocation for a new influencer campaign, splitting spend across nano/micro/macro tiers or platforms, estimating influencer costs and…
argument-hint
<total budget> [platforms] [campaign goal]
metadata.author
aaron-he-zhu
metadata.version
20.1.0

Budget Optimizer

This skill helps you allocate and optimize your influencer marketing budget to maximize return on investment. It considers platform costs, influencer tier economics, and campaign objectives to recommend optimal budget distribution.

Quick Start

Shortest invocation:

Help me allocate a $30,000 budget for an influencer campaign on Instagram and TikTok

Common scenario:

Optimize my influencer budget across micro and macro influencers for a Gen Z product launch — compare a $50K and a $100K scenario

Output: a tier/platform/content allocation table, projected reach + CPM/CPE, 2-3 budget scenarios, and a recommended split.

Skill Contract

  • Reads: total budget, fixed vs influencer-available split, campaign goal, target platforms, tier constraints (max per influencer, minimum count), industry, and — for mid-campaign work — spend-to-date and per-influencer results. Connector data via ~~influencer database / ~~social platform analytics when available.
  • Writes: return the budget allocation recommendation and handoff inline by default; save to memory/influencer/budget-optimizer/YYYY-MM-DD-<topic>.md (or the declared paid path) only with exact WARM-save authorization.
  • Promotes: only with separate exact authorization, promote the approved total budget, chosen scenario, locked tier mix, and spend constraints to memory/hot-cache.md.
  • Done when:
    1. Allocation sums to 100% of the stated budget; any contingency amount follows a user rule or a source-dated planning anchor rather than a repository default.
    2. Every projected metric includes its formula, input refs, evidence window, and Measured / User-provided / Estimated label.
    3. One recommended scenario is named with its rationale, or the numerical scenario remains NEEDS_INPUT with an exact evidence-request plan.
  • Primary next skill: use the readiness-gated Next Best Skill block below; a budget handoff never authorizes outreach or a send.
Handoff Summary

Emit the standard shape from skill-contract.md §Handoff Summary Format.

Cross-discipline: ad spend allocation

This skill also allocates paid-ads spend — the tier/platform tables map to channels/campaigns; use the ROAS profile (direct-response|prospecting|incremental-profit) as the scenario axis and read its declared CPA/payback/contribution constraint instead of substituting CPM/CPE. Scope: this computes the spend-reallocation plan only. It does not read in-flight pacing or issue scale-up/down moves — the live pacing read (pacing vs plan, learning-phase respect) belongs to budget-pacing-monitor, and bid-strategy choice belongs to bid-strategy-planner. paid-measurement-loop reads one shipped change back against a control, and premature scaling is an S guardrail flag in ad-account-auditor, not a separate skill or a veto. Save paid runs under memory/ad/budget-optimizer/.

Data Sources

This family has no required live integration, but numerical rate, multiplier, reach, engagement, revenue, and return projections require a compatible anchor: a user-provided quote or assumption, source-dated market evidence, or comparable first-party history. With only a total budget, platforms, and goal, return an allocation skeleton plus the exact rate-card/forecast queries needed and status NEEDS_INPUT; do not invent a repository rate table or multiplier.

Optional connectors that sharpen the estimates when present:

  • ~~influencer database — real rate cards instead of benchmark ranges.
  • ~~social platform analytics — actual reach, CPM, and engagement to replace estimated projections.
  • ~~CRM — past campaign spend and conversion data for ROI calibration.

Classify evidence field by field, not by connector provenance. Mark a connector value Measured only when it is an observed result for that exact metric, entity, and campaign window (record the source and as-of/window); mark numbers the user states User-provided; and mark benchmarks, forecasts, inferred values, and modeled downstream projections Estimated. A connector-backed input never upgrades an entire row or a projection derived from assumptions to Measured. See CONNECTORS.md for the keyless data recipes.

Show full SKILL.md (491 more words)Show less

Instructions

When a user requests budget optimization, work these steps. Each step's fill-in template and scenario block lives in references/templates.md — copy the matching section and populate it.

  1. Gather budget parameters — campaign goal, audience, timeline, total budget, fixed vs influencer-available split, platform priorities, and constraints (max per influencer, min count). Intake template: §Step 1.
  2. Qualify cost evidence — inventory source-dated, market/platform/tier/deliverable/rights-compatible quotes or first-party history. A rate or multiplier without a compatible source and date stays NEEDS_INPUT; never supply a built-in default. Template: §Step 2.
  3. Create the allocation — split across tier, platform, content type, and other items (gifting, amplification, tools, contingency); sum to 100%. Use a contingency only when the user or a dated planning source supplied the rule. Template: §Step 3.
  4. Project returns — record each formula and input ref. Keep EMV as a separate media-equivalency scenario; never add it to attributed revenue or count it as cash return. Report ROAS = attributed revenue / spend as x:1; report arithmetic ROI as (attributed revenue - spend) / spend × 100%; do not claim profitability or incrementality without the required evidence. Template: §Step 4.
  5. Model scenarios — compare only scenarios supported by declared inputs; otherwise return named scenario shells and the missing-input plan. Template: §Step 5.
  6. Optimization strategies — label savings, concentration, and amplification thresholds as user rules or source-dated assumptions. Do not present unsourced percentages as standard. Detail: §Step 6.
  7. Mid-campaign reallocation — require comparable observed results plus a preregistered readback window and decision rule. Recommend KEEP_TESTING or NEEDS_INPUT when those are absent; a recommendation requires separate action authorization before spend changes. Persist and hand off creators only as creator_ref. Template: §Step 7.

Return the run inline. Offer memory/influencer/budget-optimizer/YYYY-MM-DD-<topic>.md (or memory/ad/budget-optimizer/ for paid-ads runs) for exact WARM-save authorization, and request a separate authorization before promoting the approved total, chosen scenario, or locked tier mix to memory/hot-cache.md.

Example

User: "Optimize a $30,000 budget for a skincare product launch on Instagram and TikTok targeting Gen Z"

Output:

markdown
## Budget Allocation: $30,000 Skincare Launch

**Status**: NEEDS_INPUT

The budget, platforms, audience, and goal are User-provided. No compatible creator quotes, deliverable/rights scope, contingency rule, reach/engagement history, conversion rate, AOV, or attribution basis was supplied, so no creator count, platform split, CPM, revenue, ROAS, ROI, or EMV is fabricated.

### Evidence request

| Needed input | Exact request |
|--------------|---------------|
| Cost basis | Dated creator quotes or first-party rates for the target market, platform, tier, deliverable, usage-rights term, exclusivity, and currency |
| Forecast basis | Comparable reach/engagement observations with source refs and windows |
| Return basis | Approved conversion rate, AOV, attribution window/method, and whether revenue is gross or net |
| Planning rules | User-approved platform/tier constraints, amplification amount, and contingency rule |

Until these arrive, provide only a 100%-summing allocation worksheet with `TBD` cells and no recommended numerical scenario.

Reference Materials

Next Best Skill

Primary: campaign-planner — when no approved execution-ready campaign plan exists, lock objectives, deliverables, rights, measurement, and decision rules before execution.

Alternates (same influencer family):

  • influencer-discovery — when the approved plan exists but a sourced shortlist does not; continue through discovery's documented typed-Fit handoff before treating any creator as selected.
  • outreach-manager — only when the campaign plan is approved, creators are selected after Fit, and contact/consent/channel readiness is documented. The handoff prepares outreach; it does not authorize a send.

Termination: keep a visited-set. If the recommended next skill was already invoked in this session's chain, stop and report chain-complete instead of re-invoking. Default max-depth: 3. When routing is ambiguous, present the options and stop rather than auto-following.

© aaron-he-zhu, 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 1 other file (references) in influencer/target/budget-optimizer of aaron-he-zhu/aaron-marketing-skills.

  • SKILL.md
  • references/templates.md

Open the folder on GitHubat commit d5529cb

Compare with similar skills

Budget Optimizer 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.

Budget Optimizer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Budget Optimizer this skillaaron-he-zhu/aaron-marketing-skills2.9k—~3kAutomated safety check: PassApache-2.0
Paid Ads Creativenowork-studio/notfair-plugin3.9k—~248Automated safety check: PassMIT
Higgsfield Content FactoryDaanKieft/ai-influencer116—~15kAutomated safety check: PassNone
Create Content Campaignopenvetta/open-vetta290—~628Automated safety check: PassApache-2.0
Creator Ugc Marketingappeeky/aso-skills2.2k—~2kAutomated safety check: PassMIT
Riffkitsickn33/agentic-awesome-skills47k1 repos~1.7kAutomated safety check: PassMIT

Similar skills

  • Paid Ads Creative

    nowork-studio/notfair-plugin

    Create grounded paid-media creative concepts, copy angles, refresh hypotheses, and measurable test briefs across advertising platforms.

    3.9k GitHub stars~248 tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Higgsfield Content Factory

    DaanKieft/ai-influencer

    A 5-stage AI content pipeline using Higgsfield MCP, focused on viral UGC content split evenly across 5 formats: UGC Entertainment (challenges), Street Interview, Unboxing, Product Review, ASMR.

    116 GitHub stars~15k tokensUpdated 4 mo ago
    Marketing & SEOAuto-check passed
  • Create Content Campaign

    openvetta/open-vetta

    Plan and build a coherent multi-asset image/video content campaign from a brief, including concept candidates, authority assets, hero selection, derivative assets, shots, and delivery formats.

    290 GitHub stars~628 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Creator Ugc Marketing

    appeeky/aso-skills

    When the user wants to plan, brief, source, or measure organic creator / influencer / UGC marketing for their app — including TikTok creators, Instagram Reels, YouTube Shorts, micro-influencers…

    2.2k GitHub stars~2k tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed
  • Riffkit

    sickn33/agentic-awesome-skills

    Riff a winning TikTok into your own short video — study a proven video's emotion formula and regenerate it with your product, character, and language (9 supported).

    47k GitHub starsUsed in 1 repo~1.7k tokens
    Marketing & SEOAuto-check passed
  • Afa Creative

    afadtc/afa-dtc-skills

    DTC 广告创意生产与测试——创意角度矩阵、Hook 变体、创意疲劳刷新、文案。触发词: 创意, ad creative, hook, 广告素材, 创意测试, 创意疲劳, 文案, video ads, creative testing, ad fatigue, ugc ads。复杂问题先经 afa。

    168 GitHub stars~3.1k tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed

More from aaron-he-zhu/aaron-marketing-skills

All 119 skills in this repo
  • 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
    Auto-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
    Auto-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
    Auto-check passed
  • Bid Strategy Planner

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "pick a bid strategy", "set a tCPA/tROAS target", or "plan the learning-phase entry"; produces a bid-strategy choice (tCPA / tROAS / max-conversions /…

    2.9k GitHub starsUsed in 2 repos~2.6k tokens
    Auto-check passed
  • Conversion Signal QA

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "QA my conversion tracking before launch", "check my UTMs / pixel / event firing", "set up a tracking pre-flight", or "set the dedup rule so Meta and…

    2.9k GitHub starsUsed in 2 repos~2.4k tokens
    Auto-check passed
  • Creator Registry

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks "what did we pay this creator last time" or to "update the creator roster"; curates creator identity, rate, rights, exclusivity, compliance-event, and…

    2.9k GitHub starsUsed in 2 repos~1.6k tokens
    Auto-check passed

Categories

Questions about Budget Optimizer

What does Budget Optimizer do?

A skill your agent uses when the user asks to "allocate my influencer budget", "optimize spend across tiers", or "compare budget scenarios"; produces a tier/platform/content allocation table, ROI…. Budget Optimizer is an agent skill from aaron-he-zhu/aaron-marketing-skills. Use when the user asks to "allocate my influencer budget", "optimize spend across tiers", or "compare budget scenarios"; produces a tier/platform/content allocation table, ROI and CPM/CPE projections, scenario comparisons, and mid-campaign reallocation moves.

When should I use Budget Optimizer?

Budget Optimizer fits situations like: the user asks to allocate my influencer budget; optimize spend across tiers; compare budget scenarios; produces a tier/platform/content allocation table.

How do I install Budget Optimizer in Claude Code?

Run `npx skills add aaron-he-zhu/aaron-marketing-skills --skill budget-optimizer -a claude-code`. Or copy the skill folder (influencer/target/budget-optimizer in aaron-he-zhu/aaron-marketing-skills) into .claude/skills/budget-optimizer in your project. Claude Code loads it when a task matches its description.

How do I install Budget Optimizer in Codex?

Run `npx skills add aaron-he-zhu/aaron-marketing-skills --skill budget-optimizer -a codex`. Or copy the skill folder (influencer/target/budget-optimizer in aaron-he-zhu/aaron-marketing-skills) into .agents/skills/budget-optimizer in your project. Codex loads it when a task matches its description.

Can I use Budget Optimizer 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 aaron-he-zhu/aaron-marketing-skills --skill budget-optimizer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/budget-optimizer, .gemini/skills/budget-optimizer, .github/skills/budget-optimizer and .opencode/skills/budget-optimizer in your project.

What does Budget Optimizer need to run?

SKILL.md names no scripts, command-line tools or credentials: Budget Optimizer is instructions for the agent only. Compatibility (from SKILL.md): Claude Code and compatible agent-skill hosts.

Does Budget Optimizer 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 Budget Optimizer 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 Budget Optimizer use?

Budget Optimizer is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Budget Optimizer use?

About 3k tokens (SKILL.md is roughly 12k 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 2.9k tokens, read only when the agent opens those files.

What are the alternatives to Budget Optimizer?

Skills that share tags, products or a category with Budget Optimizer: Paid Ads Creative (nowork-studio/notfair-plugin, 3.9k stars), Higgsfield Content Factory (DaanKieft/ai-influencer, 116 stars), Create Content Campaign (openvetta/open-vetta, 290 stars) and Creator Ugc Marketing (appeeky/aso-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Budget Optimizer?

aaron-he-zhu (a GitHub user) maintains it in aaron-he-zhu/aaron-marketing-skills, which has 2,898 GitHub stars. The repository holds 119 skills in this directory. The repository was last updated on October 11, 2026.

Source: aaron-he-zhu/aaron-marketing-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.