rshade/finfocus / agent-skills/cost-drift
cost-drift
UnverifiedCompare actual and projected spend for a Pulumi stack with the FinFocus CLI, flag drifting resources against thresholds in .cost-check.yml, explain likely causes, track the trend, and write a COST_DRIFT.md report. Reads machine-readable JSON, checks the CLI version, and names what to do when the CLI, a billing plugin, credentials, or a Pulumi preview is missing. Use when investigating a cost overrun, validating projections against reality, or watching spend drift in CI. Triggers on: "cost drift", "actual vs projected", "why is spend higher than expected", "drift report", "COST_DRIFT.md".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.3 KB |
| cost-drift.skill | binary | 9.8 KB |
| references/cli-contract.md | markdown | 3.2 KB |
| references/drift-explanations.md | markdown | 4.6 KB |
| references/failure-modes.md | markdown | 2.3 KB |
| references/report-template.md | markdown | 1.9 KB |
| references/thresholds.md | markdown | 2.6 KB |
references/report-template.md
View on GitHub<!-- Copyright 2025-2026 Richard Shade. Licensed under Apache-2.0. -->
<!-- SPDX-License-Identifier: Apache-2.0 -->
# COST_DRIFT.md template
````markdown
# Cost Drift Report
Generated: YYYY-MM-DD
IaC: Pulumi
Tool: finfocus vX.Y.Z (required vX.Y.Z)
Stack: [metadata.stackName]
Period: [metadata.timeWindow.start] to [metadata.timeWindow.end]
## Summary
| Metric | Value |
| --- | --- |
| Total actual (window) | X,XXX.XX CUR |
| Total projected (month) | X,XXX.XX CUR |
| Drifting resources | N |
| Resources with actuals | N |
| Trend | better / worse / stable / none |
| Billing verification | unavailable (actuals may include runtime estimates) |
Result: PASS | DRIFTING | ERROR (kind)
## Drifting Resources
### [Resource name] ([resource type])
| Metric | Value |
| --- | --- |
| Actual (extrapolated month) | XXX.XX CUR |
| Projected | XXX.XX CUR |
| Delta | +/- XX.XX CUR |
| Drift | +/- X.X% |
**Likely cause:** [from drift-explanations.md]
**Investigate:** [next step]
[Order by absolute drift percentage.]
## Other Resources
| Resource | Type | Actual (window) | Projected | Drift |
| --- | --- | --- | --- | --- |
Drift reads `within 10%`, `new or deleted`, or `insufficient data`.
## Errors
[Every `errors[]` entry, or "none".]
## Thresholds Used
| Key | Value |
| --- | --- |
Source: .cost-check.yml drift section | defaults
## Trend
| Metric | Previous | Current | Direction |
| --- | --- | --- | --- |
[Omit when there is no previous COST_DRIFT.md.]
## Caveats
- Actuals can lag the billing source by 24 to 48 hours.
- [Version unverified, a drift_pct below 10, partial data.]
````
## Quality checklist
- Every flagged resource shows actual, projected, delta, and drift.
- Explanations match the resource type and the direction of the drift.
- Amounts carry two decimals and the currency code.
- The thresholds section shows the values actually applied.
- The tool version comes from `finfocus --version`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |