- Home
- Skills
- Research & Analysis
- AI Agency Client ROI & Unit-Cost Reporter
Works with the AI Agents you already use
AI Agency Client ROI & Unit-Cost Reporter
Convert AI agent usage and outcome CSV/JSON exports into transparent API unit-cost metrics and a printable HTML report. Identify unknown costs, duplicate calls and incomplete data without inventing financial ROI.
$9.99
AI Agency Client ROI & Unit-Cost Reporter
Example session with this skill installed
Analyze the synthetic AI agent usage records in examples/synthetic-usage.csv and the business outcomes in examples/synthetic-outcomes.csv using AI Agency Client ROI & Unit-Cost Reporter v1.0.4.
Calculate total AI API costs, token usage, cost per conversation and cost per confirmed business outcome.
Check for duplicate records, missing costs and incomplete data. Clearly distinguish buyer-supplied costs from estimates.
Generate an evidence-based financial report in text format. Do not invent revenue, profit or business ROI.
- Read your context and instructions
- Compiled the ai agency client
AI Agency Client ROI & Unit-Cost Reporter v1.0.4
Evidence coverage: COMPLETE_FOR_SUPPLIED_DATA
Conversations: 6; unique API calls: 8
Input tokens: 177000; cached input: 9000; output tokens: 15400
AI API cost (USD): 0.46 (complete for supplied calls, not provider-verified)
Cost provenance: Buyer-supplied per-call API costs; not independently reconciled against a provider invoice.
Cost source counts: buyer-supplied=8; rate-derived estimates=0; unpriced=0
Average AI cost per conversation (USD): 0.08
Reported business outcomes (buyer-supplied):
- booked: 2
- handoff: 1
- qualified: 1
- resolved: 1
- unresolved: 1
All-workload AI spend per confirmed outcome:
- cost per booked: USD 0.23
- cost per qualified: USD 0.46
- cost per resolved: USD 0.46
Per-conversation breakdown (hashed IDs; incomplete if noted):
Rounding note: Total cost is calculated from unrounded call amounts. Per-conversation values are independently rounded to cents and may not add to the rounded total.
- e8de016fbd70 | calls=2 | input=65000 | cached_input=5000 | output=7000 | USD 0.18 | unresolved | basis=buyer-supplied amount
- 856b6b7faff0 | calls=1 | input=60000 | cached_input=0 | output=4500 | USD 0.16 | handoff | basis=buyer-supplied amount
- 18824f024f41 | calls=1 | input=22000 | cached_input=0 | output=2000 | USD 0.06 | booked | basis=buyer-supplied amount
- fa57a52dbf08 | calls=2 | input=15000 | cached_input=1000 | output=1400 | USD 0.04 | booked | basis=buyer-supplied amount
- 9e518076ab40 | calls=1 | input=12000 | cached_input=3000 | output=300 | USD 0.02 | qualified | basis=buyer-supplied amount
- 219885bcf6b7 | calls=1 | input=3000 | cached_input=0 | output=200 | USD 0.01 | resolved | basis=buyer-supplied amount
Limitations
- No connection to provider APIs, WhatsApp, CRM or billing systems.
- Prices and usage come only from buyer supplied records; no built-in current model tariff claims.
- Business unit cost = all observed workload AI spend / count of confirmed outcomes, not just successful-session spend.
- Does not measure WhatsApp fees, automation software, hosting, taxes or staff time.
- An outcome label is supplied by the buyer and is not authenticated by this script.
- Use anonymized conversation IDs; never upload customer PII or credentials.
Connects securely to your tools. The creator never sees your data.
About this skill
Understand what your AI agents actually cost, and explain it clearly to your clients.
AI Agency Client ROI & Unit-Cost Reporter helps automation agencies, AI developers and consultants transform technical usage records into clear financial reports for business owners.
Instead of presenting confusing token counts or unsupported return-on-investment claims, this skill provides evidence-based AI operating cost metrics, with transparent calculations and explicit data limitations.
What it calculates:
- Total AI API calls and conversations using stable identifiers.
- Input, cached-input and output token consumption.
- AI API costs from buyer-provided records.
- Estimated costs using explicitly supplied token pricing.
- Average AI API cost per conversation when sufficient evidence is available.
- AI API cost per buyer-labeled booking, qualified lead or resolved conversation.
- Per-conversation usage and cost breakdowns.
- Cost coverage and data completeness indicators.
Built-in data quality protections:
- Detects and deduplicates identical API call records.
- Rejects conflicting duplicate records, including conflicting cost sources.
- Identifies missing conversation identifiers.
- Distinguishes unknown costs from verified zero values.
- Prevents incomplete data from producing misleading averages.
- Separates buyer-supplied costs from rate-derived estimates.
- Handles monetary rounding transparently.
- Rejects malformed token counts and invalid monetary values.
- Uses pseudonymized identifiers in reports.
What you receive:
A structured financial analysis available in text, JSON and printable HTML formats.
Reports include cost summaries, token usage, business outcome counts, unit-cost indicators, evidence coverage, calculation notes and limitations.
The package includes a deterministic Python analysis script, data contracts, reporting templates, synthetic examples and automated tests.
How it works:
- Export your AI agent usage records in CSV or JSON format.
- Provide matching conversation outcomes when available.
- Optionally supply your model pricing information.
- Run the included offline Python checker.
- Review the generated financial report and its evidence limitations.
No external API connections, paid services or proprietary infrastructure are required.
Why it matters:
Agencies often need to explain AI operating costs to clients who do not understand tokens, model pricing or API usage.
This skill helps translate those records into practical unit-cost information while avoiding unsupported financial claims.
Important limitations:
Despite its name, this tool does not calculate actual business ROI, revenue, profit or financial returns.
It measures AI API costs based on buyer-provided records. Pricing-based calculations are labeled as estimates, and supplied costs are not independently verified against provider invoices.
Business outcomes are supplied by the buyer and are not automatically confirmed against CRM or booking systems.
WhatsApp charges, automation subscriptions, hosting, staff expenses, taxes and other operational costs are excluded.
Incomplete or inconsistent data may prevent reliable unit-cost calculations.
The skill does not connect to production systems, retrieve credentials or modify business records.
Compatibility:
Designed for AI coding agents supporting SKILL.md instructions.
Includes an offline Python 3.9+ script using only the standard library. Independently tested with OpenAI Codex on Windows 11.
Built by Tecérale AI Skills.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Research & Analysis.
This skill analyzes buyer-supplied CSV and JSON records. It does not connect to live LLM providers, CRM systems, WhatsApp, billing platforms or external APIs.
It calculates AI API usage costs and unit-cost indicators, not actual business ROI, revenue, profit or investment returns.
Buyer-supplied costs and business outcomes are not independently verified. Costs calculated from supplied token rates are explicitly labeled as estimates.
Missing prices, incomplete outcomes, unmatched records or unreliable conversation identifiers may prevent accurate unit-cost calculations. Conflicting duplicate records are rejected.
The analysis excludes WhatsApp fees, hosting, automation subscriptions, staff expenses, taxes and other operational costs.
Python 3.9+ is optional for running the included offline analysis script. Reports depend on the quality and completeness of the supplied records. The skill does not modify production systems or retrieve private account data.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 6 days ago
Nothing to install. It runs in your AI agent.
- Optional
Python 3.9 or later
Python 3.9+ is optional for running the local financial analysis script. Provide sanitized CSV or JSON usage records, with conversation outcomes and pricing data when available. Reports depend on the completeness of supplied data and do not calculate actual business ROI.
Permissions
File Scopes
Terminal access runs the included offline Python reporting script. Read Files access is limited to authorized CSV/JSON usage records, outcome data, optional pricing files and skill documentation. The checker does not require network access, credentials or automatic file modifications. Saving an HTML report requires separate user approval.