ruvnet/ruflo683 installs

cost-summary

Q: How do I install this agent skill?

Run npx skills add https://github.com/ruvnet/ruflo --skill cost-summary.

Q: Is this agent skill safe to install?

Review the displayed partner audits, complete source, permissions, dependencies, and exact revision before installing.

Single-shot programmatic dump of all cost data — total spend, per-tier, top session, budget status, federation aggregate. JSON or markdown.

How do I install this agent skill?

npx skills add https://github.com/ruvnet/ruflo --skill cost-summary

view source ↗

Is this agent skill safe to install?

Gen Agent Trust Hubpass
This skill is safe to use. It provides instructions to run a local script to retrieve a programmatic cost summary without performing any external downloads, network requests, or privileged operations.
Socketpass
No alerts
Snykpass
Risk: LOW · No issues

What does this agent skill do?

Cost Summary

A stable single-call interface that other plugins / scripts / dashboards can shell out to and parse. ADR-0002 considered exposing cost_report / cost_summary as proper MCP tools but deferred that — adding MCP tools requires modifying @claude-flow/cli source, out of scope for plugin-local work. This script is the equivalent: same data, exposed via a stdout JSON contract.

When to use

Another plugin needs a snapshot of cost state — it shells out to summary.mjs --format json and parses.
A dashboard / Slackbot fetches a one-line cost rollup.
Quick "where am I right now?" view that pulls from every cost-tracker source (cost-tracking + federation-spend).

Output contract (JSON, stable)

{
  "exportedAt": "<ISO>",
  "total_cost_usd": 1546.36,
  "sessionCount": 1,
  "conversationCount": 1,
  "byTier": { "haiku": 0, "sonnet": 0, "opus": 1546.36, "unknown": 0 },
  "byModel": {
    "claude-opus-4-7": {
      "tier": "opus",
      "cost_usd": 1546.36,
      "messages": 1597,
      "input_tokens": 3090,
      "output_tokens": 3295940,
      "cache_creation_input_tokens": 10659599,
      "cache_read_input_tokens": 732833690
    }
  },
  "topSession": {
    "sessionId": "1dba3b8c-...",
    "total_cost_usd": 1546.36,
    "messageCount": 1597
  },
  "budget": {
    "budget_usd": 2500.00,
    "setAt": "<ISO>",
    "spent_usd": 1546.36,
    "utilization": 0.6185,
    "level": "INFO"
  },
  "federation": {
    "eventCount": 0,
    "peerCount": 0,
    "totalUsd24h": 0
  }
}

Steps

# Markdown (default)
node plugins/ruflo-cost-tracker/scripts/summary.mjs

# JSON for programmatic consumption
node plugins/ruflo-cost-tracker/scripts/summary.mjs --format json

Optional env: SUMMARY_NAMESPACE=cost-tracking, SUMMARY_FED_NAMESPACE=federation-spend, SUMMARY_FORMAT=json.

Cross-references

cost-report — narrative report (per-agent / per-model lens; uses same data)
cost-export — pushes to Prometheus / webhook (this skill is pull-style; export is push-style)
ADR-0002 §"Decision" — explicitly defers proper MCP-tool registration to a future ADR

How can the creator link this skill?

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/ruvnet/ruflo/cost-summary">View cost-summary on skillZs</a>