How do I install the Fireworks Billing skill?

Run npx skillmds@latest add sandipb/fireworks-billing in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Fireworks Billing safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Fireworks Billing?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Fireworks Billing free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Fireworks Billing?

sandipb (@sandipb) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Fireworks Billing by sandipb — Agent Skill

Name: Fireworks Billing
Author: sandipb

Fireworks Billing

Export and summarize Fireworks AI billing usage by date range, model, and usage type with the official firectl CLI. Use for Fireworks billing metrics, token usage, accelerator usage, or spend-related investigation. This reports usage rather than currency charges.

sandipb afd899f 5 files · 14.5 KB Updated Sep 17, 2026

File contents

Fireworks AI billing usage

Use the bundled script to export Fireworks billing metrics and summarize prompt tokens, completion tokens, accelerator seconds, models, and usage types. Do not describe these usage totals as currency spend.

Prerequisites

firectl installed using the official instructions
uv installed to run the bundled Python script
An authenticated Fireworks profile; use firectl signin

Never ask the user to paste an API key into chat or place one directly on a command line. Let firectl use its authenticated profile.

Workflow

Run the bundled fireworks-billing.py from this skill directory.
Use usage for a billing-usage summary. spend remains as a compatibility alias, but the result contains usage quantities, not dollar costs.
Explain that start dates are inclusive and end dates are exclusive.
Split ranges longer than 31 days into separate calls.
For credit balance or monetary charges, direct the user to the Fireworks billing dashboard; the documented CLI does not expose a stable balance query.

Commands

# Previous UTC calendar day
./fireworks-billing.py usage

# Explicit inclusive-start/exclusive-end range
./fireworks-billing.py usage \
  --start-time 2026-02-17 \
  --end-time 2026-02-18

The script exports into a private temporary directory, validates the current CSV schema, summarizes it, and removes the temporary data. It does not retain raw billing records.

Troubleshooting

Missing firectl: follow the official installation instructions.
Authentication failure: run firectl signin, then retry.
Missing CSV columns: update firectl and this skill before trusting results.
No rows: report that no usage was recorded for the requested interval.
More than 31 days: split the interval; Fireworks limits each export to 31 days.

Current skill version: 1.1.0.

---name: fireworks-billingdescription: Export and summarize Fireworks AI billing usage by date range, model, and usage type with the official firectl CLI. Use for Fireworks billing metrics, token usage, accelerator usage, or spend-related investigation. This reports usage rather than currency charges.---# Fireworks AI billing usageUse the bundled script to export Fireworks billing metrics and summarize prompttokens, completion tokens, accelerator seconds, models, and usage types. Do notdescribe these usage totals as currency spend.## Prerequisites- `firectl` installed using the [official instructions](https://docs.fireworks.ai/tools-sdks/firectl/firectl)- `uv` installed to run the bundled Python script- An authenticated Fireworks profile; use `firectl signin`Never ask the user to paste an API key into chat or place one directly on acommand line. Let `firectl` use its authenticated profile.## Workflow1. Run the bundled `fireworks-billing.py` from this skill directory.2. Use `usage` for a billing-usage summary. `spend` remains as a compatibility alias, but the result contains usage quantities, not dollar costs.3. Explain that start dates are inclusive and end dates are exclusive.4. Split ranges longer than 31 days into separate calls.5. For credit balance or monetary charges, direct the user to the Fireworks billing dashboard; the documented CLI does not expose a stable balance query.## Commands```bash# Previous UTC calendar day./fireworks-billing.py usage# Explicit inclusive-start/exclusive-end range./fireworks-billing.py usage \ --start-time 2026-02-17 \ --end-time 2026-02-18```The script exports into a private temporary directory, validates the current CSVschema, summarizes it, and removes the temporary data. It does not retain rawbilling records.## Troubleshooting- Missing `firectl`: follow the official installation instructions.- Authentication failure: run `firectl signin`, then retry.- Missing CSV columns: update `firectl` and this skill before trusting results.- No rows: report that no usage was recorded for the requested interval.- More than 31 days: split the interval; Fireworks limits each export to 31 days.Current skill version: 1.1.0.

Frequently asked questions