Skip to content

rshade/finfocus / agent-skills/cost-drift

cost-drift

Unverified

Compare 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".

FileKindSize
SKILL.mdskill md5.3 KB
cost-drift.skillbinary9.8 KB
references/cli-contract.mdmarkdown3.2 KB
references/drift-explanations.mdmarkdown4.6 KB
references/failure-modes.mdmarkdown2.3 KB
references/report-template.mdmarkdown1.9 KB
references/thresholds.mdmarkdown2.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`.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall