Agent skill · data analytics · affaan-m
cost-tracking
ローカルのコスト追跡データベースからClaude Codeのトークン使用量、支出、予算を追跡・レポートします。コスト、支出、使用量、トークン、予算、またはプロジェクト、ツール、セッション、日付によるコスト内訳について質問する場合に使用します。
Why this skill is useful
Provides specific SQL queries for analyzing cost and usage data from a local SQLite database that the AI wouldn't generate on its own.
What it needs
Requires sqlite3 installed locally. About 1k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
コスト追跡 このスキルを使用して、ローカルSQLiteデータベースからClaude Codeのコストと使用履歴を分析します。これは、~/.claude-cost-tracker/usage.dbに使用行を書き込むコスト追跡フックまたはプラグインをすでに持っているユーザーを対象としています。 出典: MayurBhavsarによるコミュニティのPR #1304から救済されました。 使用時期 ユーザーが「いくら使いましたか？」「このセッションのコストは？」「トークン使用量は？」と尋ねる場合 ユーザーが予算、支出制限、超過、またはコスト管理について言及する場合 ユーザーがプロジェクト、ツール、セッション、モデル、または日付ごとのコスト内訳を求める場合 ユーザーが今日と昨日を比較したい、または最近のトレンドを確認したい場合 ユーザーが最近の使用記録のCSVエクスポートを求める場合 動作方法 まず前提条件を確認します： データベースが見つからない場合、使用データを作成しません。ユーザーにコスト追跡が設定されていないことを伝え、信頼できるローカルコスト追跡フック/プラグインのインストールまたは有効化を提案します。 期待されるusageテーブルには通常、ツール呼び出しまたはモデルインタラクションごとに1行が含まれます。列名はトラッカーによって異なりますが、以下の例では次のように仮定します： 列 意味 --- --- timestamp 使用イベントのISOタイムスタンプ project プロジェクトまたはリポジトリ名 toolname ツールまたはイベント名 inputtokens 記録された場合の入力トークン数 outputtokens 記録された場合の出力トークン数 costusd USDで事前計算されたコスト sessionid Claude Codeセッション識別子 model イベントに使用されたモデル costusdを使用して手動で価格計算するよりも優先します。モデルの価格とキャッシュ価格は時間とともに変化し、トラッカーが各行の価格設定の信頼できる情報源であるべきです。 例 クイックサマリー プロジェクト別コスト ツール別コスト 過去7日間 セッション詳細 レポートガイダンス コストデータを表示する場合、以下を含めます： 1. 今日の支出と昨日の比較。 2. 追跡されたデータベース全体の合計支出。 3. コスト順にランク付けされた上位プロジェクト。 4. コスト順にランク付けされた上位ツール。 5. 十分なデータがある場合のセッション数とセッションごとの平均コスト。 少額の場合、通貨を小数点4桁でフォーマットします。大きな金額には2桁で十分です。 アンチパターン costusdが存在する場合に生のトークン数からコストを推定しないこと。 確認せずにデータベースが存在すると仮定しないこと。 大規模なデータベースで無制限のSELECT エクスポートを実行しないこと。 ユーザー向けの回答で現在のモデル価格をハードコードしないこと。 任意のコードを実行する未審査のフックやプラグインのインストールを推奨しないこと。 関連 /cost-report - 同じデータベースを使用するコマンド形式のレポート。 cost-aware-llm-pipeline - モデルルーティングと予算設計のパターン。 token-budget-advisor - コンテキストとトークン予算の計画。 strategic-compact - 繰り返しのトークン支出を削減するためのコンテキスト圧縮。
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/cost-tracking--f77299