baseline-data-honesty

Author JSON baseline-data artifacts with foreign-origin disclosure and exact token rollup accounting.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/NarenKarthikBM/specseyal --skill baseline-data-honesty-narenkarthikbm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: baseline-data-honesty
Source: https://github.com/NarenKarthikBM/specseyal/tree/main/.claude/skills/baseline-data-honesty
Command: npx skills add https://github.com/NarenKarthikBM/specseyal --skill baseline-data-honesty-narenkarthikbm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Baseline metrics exported from one repository are often reused as fallback figures in another project, silently hiding their foreign origin and masking thin or missing data behind confident-looking totals. This Skill enforces honest reporting rules whenever you author, update, or render such a JSON baseline-data artifact. ## Core Features & Use Cases - Foreign-Origin Disclosure: Every table, chart caption, CLI print, or report section that surfaces the data states plainly that the figures come from a different repository than the one being reported on. - Exact Rollup Accounting: Aggregates use the precise formula tokens_billable(r) = tokens.input + tokens.output + tokens.cache_creation, always excluding cache_read, and treat null token records as exact zero contribution with no interpolation or backfilling. - Sample-Size Transparency: Every aggregate is paired with its contributing record count and the count of records excluded because capture_method was "unavailable", reported per tier or segment rather than collapsed into one repo-wide total. - Use Case: When generating a baseline.json of LLM token costs from one project to serve as fallback estimates in another, this Skill ensures consumers see where the data came from and how thin each tier's sample really is. ## Quick Start Use the baseline-data-honesty skill to update baseline.json so every aggregate shows its sample size, unavailable-record count, and foreign-repository origin.

Frequently Asked Questions about baseline-data-honesty

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

FAQPage Schema
How do I report baseline token costs from another repository honestly?

Mark the foreign origin at every use site where the figures appear, not just once in a header. Pair each aggregate with its contributing sample size and the count of excluded unavailable records, reported per tier or segment.

How should token usage aggregates be computed for cost reporting?

Use the exact rollup tokens_billable(r) = tokens.input + tokens.output + tokens.cache_creation, and always exclude cache_read since it represents savings rather than spend. Records with null tokens contribute exactly zero.

What should I do when token data is missing or null?

Treat null tokens as an exact zero contribution and never average, extrapolate, or backfill missing values. Count those records separately as unavailable and report that count beside every aggregate.

When does a baseline aggregate carry no meaningful signal?

When the unavailable-record count equals or nearly equals the sample size for a tier, state outright that the sum carries no signal for that tier rather than presenting it as a routine lower bound.

What JSON format constraints apply to baseline data files?

The emitted JSON must be parseable by Python's standard library json module alone, with no trailing commas, comments, or non-JSON extensions, so any consumer can load it without new dependencies.