How do I install the Finfocus Cost skill?

Run npx skillmds@latest add rshade/finfocus-cost in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Finfocus Cost safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Finfocus Cost?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Finfocus Cost free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Finfocus Cost?

rshade (@rshade) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Finfocus Cost by rshade — Agent Skill

Name: Finfocus Cost
Author: rshade

Finfocus Cost

Guide for using FinFocus CLI to analyze cloud infrastructure costs. Use when running projected or actual cost commands, interpreting cost output, configuring Pulumi integration, working with budgets and recommendations, filtering resources, or understanding cost data flows. Triggers on: "run cost analysis", "projected costs", "actual costs", "cost recommendations", "budget health", "Pulumi preview costs", "cross-provider aggregation", "cost filtering", or any task involving finfocus cost estimation and analysis workflows.

rshade eddac94 3 files · 13.0 KB Updated Sep 17, 2026

File contents

FinFocus Cost Analysis

Projected Costs

Estimate future costs from a Pulumi preview:

# From Pulumi JSON
finfocus cost projected --pulumi-json plan.json

# With output format
finfocus cost projected --pulumi-json plan.json --output json

# With specific adapter
finfocus cost projected --pulumi-json plan.json --adapter aws-public

# Auto-detect Pulumi project (searches for Pulumi.yaml)
finfocus cost projected

Generate Pulumi JSON: pulumi preview --json > plan.json

Actual Costs

Fetch historical costs from cloud providers:

# Basic usage
finfocus cost actual --pulumi-json plan.json --from 2024-01-01

# Date range
finfocus cost actual --pulumi-json plan.json --from 2024-01-01 --to 2024-01-31

# With grouping
finfocus cost actual --pulumi-json plan.json --from 2024-01-01 --group-by daily
finfocus cost actual --pulumi-json plan.json --from 2024-01-01 --group-by monthly

# Cross-provider aggregation
finfocus cost actual --group-by daily --from 2024-01-01 --to 2024-01-31

Date formats: 2006-01-02 or RFC3339. --to defaults to now.

Recommendations

Get cost optimization suggestions:

# All recommendations
finfocus cost recommendations --pulumi-json plan.json

# Filter by action type
finfocus cost recommendations --pulumi-json plan.json --action-type RIGHTSIZE,TERMINATE

# Dismiss/undismiss
finfocus cost recommendations dismiss <id>
finfocus cost recommendations undismiss <id>
finfocus cost recommendations history

Valid action types: RIGHTSIZE, TERMINATE, PURCHASE_COMMITMENT, ADJUST_REQUESTS, MODIFY, DELETE_UNUSED, MIGRATE, CONSOLIDATE, SCHEDULE, REFACTOR, INVESTIGATE, OTHER.

Budgets

Monitor cloud spending against budget limits:

# View budgets
finfocus cost budget

# Filter by provider
finfocus cost budget --filter "provider=kubecost"

# Filter by tags
finfocus cost budget --filter "tag:namespace=production"
finfocus cost budget --filter "tag:namespace=prod-*"  # Glob patterns

# Combined filters
finfocus cost budget --filter "provider=aws" --filter "tag:env=staging"

Health statuses: OK (<80%), WARNING (80-89%), CRITICAL (90-100%), EXCEEDED (>100%).

Output Formats

Three formats via --output:

Format	Flag	Use Case
Table	`--output table`	Human-readable (default)
JSON	`--output json`	Programmatic consumption
NDJSON	`--output ndjson`	Streaming large datasets

Pulumi Integration

See references/cli-commands.md for complete flag reference and auto-detection behavior.

Engine Internals

See references/engine-api.md for the cost calculation pipeline, aggregation types, and error handling.

Resource Filtering

Filter patterns for --filter:

provider=aws - By cloud provider
type=ec2 - By service type
service=rds - By extracted service
instanceType=t3.micro - By resource property
id=i-123 - By resource ID

Zero-Click Cost Estimation

Configure in Pulumi.yaml for automatic cost estimation during pulumi preview:

plugins:
  analyzers:
    - path: ./bin/finfocus
      args: ["analyzer", "serve"]

The analyzer runs as a gRPC server, receives resources from Pulumi, and returns ADVISORY diagnostics (never blocks deployments).

Debug Mode

# Enable verbose logging
finfocus cost projected --debug --pulumi-json plan.json

# Or via environment
export FINFOCUS_LOG_LEVEL=debug
export FINFOCUS_LOG_FORMAT=json

---name: finfocus-costdescription: Guide for using FinFocus CLI to analyze cloud infrastructure costs. Use when running projected or actual cost commands, interpreting cost output, configuring Pulumi integration, working with budgets and recommendations, filtering resources, or understanding cost data flows. Triggers on: "run cost analysis", "projected costs", "actual costs", "cost recommendations", "budget health", "Pulumi preview costs", "cross-provider aggregation", "cost filtering", or any task involving finfocus cost estimation and analysis workflows.---# FinFocus Cost Analysis## Projected CostsEstimate future costs from a Pulumi preview:```bash# From Pulumi JSONfinfocus cost projected --pulumi-json plan.json# With output formatfinfocus cost projected --pulumi-json plan.json --output json# With specific adapterfinfocus cost projected --pulumi-json plan.json --adapter aws-public# Auto-detect Pulumi project (searches for Pulumi.yaml)finfocus cost projected```Generate Pulumi JSON: `pulumi preview --json > plan.json`## Actual CostsFetch historical costs from cloud providers:```bash# Basic usagefinfocus cost actual --pulumi-json plan.json --from 2024-01-01# Date rangefinfocus cost actual --pulumi-json plan.json --from 2024-01-01 --to 2024-01-31# With groupingfinfocus cost actual --pulumi-json plan.json --from 2024-01-01 --group-by dailyfinfocus cost actual --pulumi-json plan.json --from 2024-01-01 --group-by monthly# Cross-provider aggregationfinfocus cost actual --group-by daily --from 2024-01-01 --to 2024-01-31```Date formats: `2006-01-02` or RFC3339. `--to` defaults to now.## RecommendationsGet cost optimization suggestions:```bash# All recommendationsfinfocus cost recommendations --pulumi-json plan.json# Filter by action typefinfocus cost recommendations --pulumi-json plan.json --action-type RIGHTSIZE,TERMINATE# Dismiss/undismissfinfocus cost recommendations dismiss <id>finfocus cost recommendations undismiss <id>finfocus cost recommendations history```Valid action types: RIGHTSIZE, TERMINATE, PURCHASE_COMMITMENT, ADJUST_REQUESTS,MODIFY, DELETE_UNUSED, MIGRATE, CONSOLIDATE, SCHEDULE, REFACTOR, INVESTIGATE, OTHER.## BudgetsMonitor cloud spending against budget limits:```bash# View budgetsfinfocus cost budget# Filter by providerfinfocus cost budget --filter "provider=kubecost"# Filter by tagsfinfocus cost budget --filter "tag:namespace=production"finfocus cost budget --filter "tag:namespace=prod-*" # Glob patterns# Combined filtersfinfocus cost budget --filter "provider=aws" --filter "tag:env=staging"```Health statuses: OK (<80%), WARNING (80-89%), CRITICAL (90-100%), EXCEEDED (>100%).## Output FormatsThree formats via `--output`:| Format | Flag | Use Case ||--------|------|----------|| Table | `--output table` | Human-readable (default) || JSON | `--output json` | Programmatic consumption || NDJSON | `--output ndjson` | Streaming large datasets |## Pulumi IntegrationSee [references/cli-commands.md](references/cli-commands.md) for complete flagreference and auto-detection behavior.## Engine InternalsSee [references/engine-api.md](references/engine-api.md) for the cost calculationpipeline, aggregation types, and error handling.## Resource FilteringFilter patterns for `--filter`:- `provider=aws` - By cloud provider- `type=ec2` - By service type- `service=rds` - By extracted service- `instanceType=t3.micro` - By resource property- `id=i-123` - By resource ID## Zero-Click Cost EstimationConfigure in `Pulumi.yaml` for automatic cost estimation during `pulumi preview`:```yamlplugins: analyzers: - path: ./bin/finfocus args: ["analyzer", "serve"]```The analyzer runs as a gRPC server, receives resources from Pulumi, and returnsADVISORY diagnostics (never blocks deployments).## Debug Mode```bash# Enable verbose loggingfinfocus cost projected --debug --pulumi-json plan.json# Or via environmentexport FINFOCUS_LOG_LEVEL=debugexport FINFOCUS_LOG_FORMAT=json```

Frequently asked questions