budget-tracker
starsforks
How to install budget-tracker?
indranilbanerjee/digital-marketing-pro/budget-tracker
$npx -y skills add indranilbanerjee/digital-marketing-pro --skill budget-trackerTrack budget pacing in real time. Use when: cross-platform spend tracking, overspend alerts, reallocation recommendations.
SKILL.md
| 1 | # /digital-marketing-pro:budget-tracker |
| 2 | |
| 3 | ## Purpose |
| 4 | |
| 5 | Track advertising budget in real-time across all connected ad platforms. Analyze spend pacing against targets, project end-of-period totals, flag overspend risks and underspend inefficiencies, calculate daily burn rates, and recommend budget reallocations to maximize ROI within the remaining budget window. Designed for media buyers and marketing managers who need a single view of where money is going and whether it is being spent effectively. |
| 6 | |
| 7 | ## Input Required |
| 8 | |
| 9 | The user must provide (or will be prompted for): |
| 10 | |
| 11 | - **Budget period**: This month, this quarter, or a custom date range (e.g., "Feb 1 - Mar 31"). |
| 12 | Determines the pacing denominator and projection horizon |
| 13 | - **Ad platforms to include**: All connected platforms or specific ones (e.g., "Google Ads and Meta only"). |
| 14 | Defaults to all connected ad MCPs |
| 15 | - **Budget targets per platform** (optional): Specific spend targets per platform for the period. |
| 16 | If omitted, targets are pulled from `profile.json` budget_range and any saved platform allocations |
| 17 | - **Total budget** (optional): Overall budget cap for the period. |
| 18 | If omitted, pulled from `profile.json` budget_range |
| 19 | - **Alert thresholds** (optional): Custom thresholds for overpace (default: >110% of expected pacing) and |
| 20 | underspend (default: <70% of expected pacing) flags |
| 21 | - **Include efficiency metrics** (optional): Whether to pull CPA, ROAS, and conversion data alongside spend. |
| 22 | Defaults to yes |
| 23 | |
| 24 | ## Process |
| 25 | |
| 26 | 1. **Load brand context**: Read `~/.claude-marketing/brands/_active-brand.json` for the active slug, then load `~/.claude-marketing/brands/{slug}/profile.json`. Apply brand voice, compliance rules for target markets (`skills/context-engine/compliance-rules.md`), and industry context. Also check for guidelines at `~/.claude-marketing/brands/{slug}/guidelines/_manifest.json` — if present, load restrictions. Check for agency SOPs at `~/.claude-marketing/sops/`. If no brand exists, ask: "Set up a brand first (/digital-marketing-pro:brand-setup)?" — or proceed with defaults. |
| 27 | 2. **Extract budget targets**: Pull `budget_range` from `profile.json` and any saved per-platform allocations from |
| 28 | previous budget-optimizer or media-plan runs. If user provided explicit targets, use those as overrides. |
| 29 | Calculate the target daily spend rate for each platform (budget / days in period). |
| 30 | 3. **Pull spend data from connected ad MCPs**: Query each connected advertising platform |
| 31 | (google-ads, meta-marketing, linkedin-marketing, tiktok-ads) for current-period spend — total spend to date, |
| 32 | daily spend breakdown, campaign-level spend distribution, and cost metrics (CPC, CPM, CPA per campaign). |
| 33 | 4. **Calculate pacing per platform**: Execute `python "${CLAUDE_PLUGIN_ROOT}/scripts/ad-budget-pacer.py" --budget {total} --period-days {N} --days-elapsed {N} --spend-to-date {amount}` with spend data |
| 34 | and budget targets to compute days elapsed/remaining, budget consumed vs expected pacing percentage, pacing |
| 35 | ratio (actual / expected), daily burn rate (7-day average), and burn rate trend (accelerating/steady/decelerating). |
| 36 | 5. **Project end-of-period spend**: Extrapolate current daily burn rate to end of period for each platform — |
| 37 | produce best-case (lowest recent daily spend), expected (7-day average), and worst-case (highest recent daily |
| 38 | spend) projections. |
| 39 | 6. **Compare to budget targets**: For each platform, calculate the gap between projected end-of-period spend and |
| 40 | the budget target — express as both dollar amount and percentage variance. |
| 41 | 7. **Flag pacing issues**: Generate alerts — overpace critical (>120%, immediate action: reduce bids, pause |
| 42 | low-performers, set daily caps), overpace warning (110-120%, proactive adjustments this week), underspend |
| 43 | warning (<70%, increase bids or expand targeting or reallocate), underspend info (70-85%, monitor). |
| 44 | 8. **Pull efficiency metrics**: For each platform, retrieve CPA, ROAS, conversion volume, and cost per conversion |
| 45 | so reallocation decisions are performance-informed, not just pacing-based. |
| 46 | 9. **Recommend reallocations**: Execute `python "${CLAUDE_PLUGIN_ROOT}/scripts/budget-optimizer.py"` with current spend |
| 47 | efficiency data to suggest specific dollar-amount shifts from underspending or low-efficiency platforms to |
| 48 | high-performing ones with room to scale. Include rationale for each recommended move. |
| 49 | 10. **Save budget snapshot**: Persist the current pacing snapshot via |
| 50 | `python "${CLAUDE_PLUGIN_ROOT}/scripts/performance-monitor.py" --brand {slug} --action save-snapshot --data '{...pacing metrics...}'` |
| 51 | for historical tracking, trend analysis, and comparison in future budget-tracker runs. |
| 52 | |
| 53 | ## Output |
| 54 | |
| 55 | A structured budget dashboard containing: |
| 56 | |
| 57 | - **Budget summary**: Total budget for the period, total spent to date, total remaining, overall |
People who liked this also viewed
6 picksType
- azure-costAzure cost management: query costs, forecast spending, optimize to reduce waste. WHEN: \"Azure costs\", \"Azure bill\", \"cost breakdown\", \"how much am I spending\", \"forecast spending\", \"optimizSkillsJul 2026
- pricingWhen the user wants help with pricing decisions, packaging, or monetization strategy. Also use when the user mentions 'pricing,' 'pricing tiers,' 'freemium,' 'free trial,' 'packaging,' 'price increaseSkillsJul 2026
- stripe-integrationMulti-harness agentic plugin marketplace for Claude Code, Codex CLI, Cursor, OpenCode, GitHub Copilot, and Gemini CLISkillsJul 2026
- startup-financial-modelingMulti-harness agentic plugin marketplace for Claude Code, Codex CLI, Cursor, OpenCode, GitHub Copilot, and Gemini CLISkillsJul 2026
- tushare-finance专为 Claude Code 设计的 Tushare Pro 金融数据技能包，支持 220+ 个接口，用自然语言获取 A 股行情、财务数据、宏观经济等金融数据。SkillsJul 2026
- azure-pricingFetches real-time Azure retail pricing using the Azure Retail Prices API (prices.azure.com) and estimates Copilot Studio agent credit consumption. Use when the user asks about the cost of any Azure seSkillsJul 2026
