gk-ledger

Generates an HTML cost report from project JSON history files.

1|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/gkganesh12/gk-stack --skill gk-ledger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gk-ledger
Source: https://github.com/gkganesh12/gk-stack/tree/main/skills-extra/gk-ledger
Command: npx skills add https://github.com/gkganesh12/gk-stack --skill gk-ledger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill solves the lack of visibility into AI-assisted development costs by transforming raw JSON cost logs into a readable, visual, and actionable HTML report.

Core Features & Use Cases

  • Visual Cost Reporting: Generates a self-contained HTML dashboard showing spend by session, task, and phase.
  • Efficiency Analysis: Identifies token waste patterns and provides advice on how to optimize your prompt budget.
  • Use Case: After a long day of coding, use this skill to see exactly which tasks were the most expensive and whether your current session is trending over budget.

Quick Start

Run the ledger skill to generate and open the latest cost report in your default browser.

Frequently Asked Questions about gk-ledger

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a visual cost report for AI token usage?

This skill generates a visual cost report by analyzing project-specific JSON history files to create a self-contained HTML dashboard showing token usage and task-level expenditures.

Can I track which specific development tasks are consuming the most AI budget?

Yes, the generated HTML report analyzes session-based token usage and project-wide efficiency metrics to pinpoint exactly which tasks are the most expensive.

Do I need any external libraries to analyze JSON cost logs and render performance dashboards?

No external libraries are required. You only need standard Python libraries to process cost data from JSON files and render the visual performance dashboards.

What is the best way to identify token waste patterns in my AI-assisted development?

The best way to identify token waste is to run this skill, which performs efficiency analysis on your JSON history files and provides actionable advice on how to optimize your prompt budget.

When do I need to process project-specific JSON history files for financial insights?

You need to process project-specific JSON history files when you lack visibility into AI-assisted development costs and want to transform raw cost logs into a readable, visual HTML report.

How do I see if my current coding session is trending over budget?

To see if your session is trending over budget, run the ledger skill to generate and open the latest cost report in your default browser, showing spend by session, task, and phase.