Adds report cards to ClaudeBar that parse local data files and display metrics with comparison deltas.
npx skills add https://github.com/tddworks/ClaudeBar --skill add-report
Please help me install this Agent Skill. Skill: add-report Source: https://github.com/tddworks/ClaudeBar/tree/main/.claude/skills/add-report Command: npx skills add https://github.com/tddworks/ClaudeBar --skill add-report
Adding analytics features to the ClaudeBar macOS app requires coordinating domain models, file parsers, analyzers, and SwiftUI card views across multiple layers, which is error-prone without a consistent pattern. This Skill provides a structured TDD workflow for building report cards that read local data sources, aggregate metrics, and display period-over-period comparisons in the existing glassmorphism UI.
Use the add-report skill to add a weekly token usage report card to ClaudeBar that compares this week against last week.
High-intent search queries and answers about installing and using this skill.
Follow the four-phase workflow: design the architecture and get approval, create domain Stat and Report models with tests, build the parser and analyzer in Infrastructure, then add the card view and wire it through UsageSnapshot and the provider's refresh method.
Create a parser struct in Sources/Infrastructure that reads JSONL files into typed records, then have an analyzer partition records by date and aggregate them. Filter files by modification date first, since scanning thousands of JSONL files is too slow.
Decimal avoids floating-point errors when representing monetary values like API usage costs. The skill requires Decimal for currency, TimeInterval for durations, and the en_US locale for currency formatting without extra spacing.
The Report model holds current and previous Stat models, computing deltas, percentage changes, and progress ratios. Change percent returns nil when the previous value is zero to avoid division by zero, and formatted deltas always include a sign.
It uses Chicago School TDD with Swift Testing, testing state rather than interactions. Write Stat and Report tests first covering formatting, isEmpty, deltas, and edge cases, then implement the models until tests pass.
tddworksImplement ClaudeBar features with architecture-first design, TDD, and Swift 6.2 patterns.
kyldvsBuild native macOS apps in Swift using SwiftUI and AppKit via CLI workflows.
Poorgramer-ZackToggle enable/disable states of existing .local.md Hookify rule files.
MuvonGuide macOS app architecture with SwiftUI-first patterns and AppKit interop.
