b-open-io/cost-tracking
skills/cost-tracking/SKILL.md
This skill should be used when tracking API spend, analyzing billing data, monitoring service costs, running budget reports, or optimizing agent spend across Anthropic, Vercel, Railway, and other platforms. Invoke when asked about "cost tracking", "billing analysis", "spend report", "API costs", "usage monitoring", "budget vs actual", "cost optimization", or "which agents cost the most".
$ install --global
skillsauthnpx skillsauth add b-open-io/prompts cost-trackingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 29, 2026, 3:51 AM56.5s5 files scanned
SKILL.md
- name:
- cost-tracking
- version:
- 1.0.1
- description:
- >-
Cost Tracking
Unified cost tracking and budget analysis across the bOpen agent organization's service stack.
Supported Platforms
Anthropic (Full API Access)
Usage API: GET /v1/organizations/usage_report/messages
- Auth: Admin API key (
sk-ant-admin...) — org admin required - Time buckets:
1m,1h,1d - Group by: model, workspace, api_key, service_tier, context_window_type, geo
- Data freshness: ~5 min lag
Cost API: GET /v1/organizations/cost_report
- Daily granularity only (
1d), costs in USD as decimal strings - Groups by workspace and description
- Includes token costs, web search, code execution
- Note: Priority Tier costs NOT included — use usage endpoint instead
Quick examples:
# Daily costs for last 7 days
curl -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
"https://api.anthropic.com/v1/organizations/cost_report?start_date=2026-03-07&end_date=2026-03-14&bucket_size=1d"
# Usage by model for last 24h
curl -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
"https://api.anthropic.com/v1/organizations/usage_report/messages?start_date=2026-03-13T00:00:00Z&end_date=2026-03-14T00:00:00Z&bucket_size=1h&group_by=model"
Full parameter reference and response shapes: references/anthropic-api.md.
Vercel (Full API Access)
Billing API: GET /v1/billing/charges
- Auth: Bearer token (same Vercel API token)
- Params:
from,to,teamIdorslug - Response: newline-delimited JSONL, FOCUS v1.3 format
- Granularity: 1-day, max 1 year range
Spend Management Webhooks: fire at 50%/75%/100% of configured budget.
CLI shortcut: vercel usage for current-period spend at a glance.
Full API reference, FOCUS field descriptions, and webhook setup: references/vercel-api.md.
Railway (No API)
Railway has no public billing API. The GraphQL API covers projects, services, and deployments — not costs. Cost data is only available in the Railway dashboard under Settings > Usage.
When asked about Railway costs: instruct the user to open the dashboard and report the numbers manually. Do not attempt to fetch them programmatically.
Vantage MCP (Unified Dashboard)
Optional consolidated view across Anthropic, Vercel, and 30+ other providers.
claude mcp add --transport sse vantage https://mcp.vantage.sh/sse
Connects to Anthropic via Admin API key and to Vercel via a Community Integration with read:billing scope. Railway is NOT supported by Vantage.
Full setup steps: references/vantage-setup.md.
Cost Analysis Patterns
Per-Agent Cost Analysis
Query the Anthropic usage API grouped by api_key or workspace. Correlate workspace/key names with agent roles. Identify which agents burn the most tokens and recommend model tier changes (opus → sonnet → haiku) where quality allows.
Budget vs Actual
Pull cost data for the billing period from the Anthropic cost report and Vercel billing charges. Compare against budgeted amounts. Flag overruns with percentage and absolute delta.
Cost Anomaly Detection
Compare daily spend against the 7-day rolling average. Flag days where spend exceeds 2x the average. Drill into which model, workspace, or agent caused the spike by querying the usage endpoint grouped by model for that day.
Optimization Recommendations
- Identify agents using
claude-opusfor tasks thatclaude-sonnetorclaude-haikucould handle - Flag unused Vercel projects with non-zero spend
- Recommend caching strategies for repeated API calls
- Identify high-volume low-complexity calls suitable for Haiku downgrade
Key Principles
- Railway is manual-only. Never attempt programmatic Railway cost fetching — the API does not expose it.
- Anthropic cost report is daily-only. For hourly or per-minute analysis, use the usage endpoint, not the cost report.
- Priority Tier spend is missing from cost_report. Always note this limitation when reporting Anthropic totals.
- Vantage MCP is optional infrastructure. Useful for teams that want a persistent dashboard; not required for one-off queries.
References
references/anthropic-api.md— Full Anthropic Admin API docs for usage and cost endpointsreferences/vercel-api.md— Vercel Billing API, FOCUS format, and spend management webhooksreferences/vantage-setup.md— Vantage MCP server setup and platform coverage
Related Skills
b-open-io/html-to-pdf
development
VerifiedTrustedCommunity
This skill should be used when the user asks to "design a business card", "make a printable PDF", "render HTML to PDF", "generate a postcard", "build print collateral", "set up an HTML print pipeline", or needs help with bleed, safe areas, font embedding, or QR generation for print. Provides a Playwright-based pipeline with multiple bundled templates and theme variants for business cards (minimal, watercolor light, watercolor dark) and instructions for adding new templates.
12SKILL.mdUpdated May 29, 2026
b-open-io/x-user-timeline
tools
VerifiedTrustedCommunity
Get recent tweets from an X/Twitter user. Use when user asks "what has @username posted", "recent tweets from", "user's X posts", "show timeline for", "what is @user saying". Requires X_BEARER_TOKEN.
12SKILL.mdUpdated Apr 3, 2026
b-open-io/x-user-lookup
data-ai
VerifiedTrustedCommunity
Get X/Twitter user profile by username. Use when user asks "who is @username", "get X profile", "lookup Twitter user", "find X account", "user details", "follower count for". Requires X_BEARER_TOKEN.
12SKILL.mdUpdated Apr 3, 2026
b-open-io/x-tweet-search
data-ai
VerifiedTrustedCommunity
Search recent X/Twitter posts by query. Returns RAW TWEETS (last 7 days). Use when user asks "search X for", "find tweets about", "what are people saying about", "Twitter search", "raw tweets about". For AI summaries/sentiment, use x-research instead. Requires X_BEARER_TOKEN.
12SKILL.mdUpdated Apr 3, 2026