rshade/finfocus / agent-skills/finfocus-analyzer-setup
finfocus-analyzer-setup
UnverifiedInstall and configure FinFocus as a Pulumi Analyzer for inline cost estimation during pulumi preview. Use when setting up the analyzer, configuring the policy pack, debugging analyzer issues, or enabling zero-click cost estimates in Pulumi workflows. Triggers on: "set up analyzer", "configure analyzer", "install analyzer", "Pulumi preview costs", "inline cost estimates", "policy pack setup", "analyzer integration", "zero-click cost estimation", "analyzer check", or any task involving finfocus Pulumi Analyzer configuration.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.7 KB |
| finfocus-analyzer-setup.skill | binary | 3.7 KB |
| references/troubleshooting.md | markdown | 4.2 KB |
SKILL.md
View on GitHub---
name: finfocus-analyzer-setup
description: >
Install and configure FinFocus as a Pulumi Analyzer for inline cost estimation
during pulumi preview. Use when setting up the analyzer, configuring the policy
pack, debugging analyzer issues, or enabling zero-click cost estimates in Pulumi
workflows. Triggers on: "set up analyzer", "configure analyzer", "install analyzer",
"Pulumi preview costs", "inline cost estimates", "policy pack setup",
"analyzer integration", "zero-click cost estimation", "analyzer check",
or any task involving finfocus Pulumi Analyzer configuration.
---
<!-- Copyright 2025-2026 Richard Shade. Licensed under Apache-2.0. -->
<!-- SPDX-License-Identifier: Apache-2.0 -->
# FinFocus Analyzer Setup
Inline cost estimation during `pulumi preview` via the Pulumi Analyzer protocol.
All diagnostics are ADVISORY — never blocks deployments.
## Prerequisites
```bash
finfocus --version # FinFocus CLI installed
pulumi version # Pulumi CLI installed
finfocus plugin list # At least one cost plugin installed
```
## Quick Setup
```bash
finfocus analyzer install # Install + create policy pack
finfocus analyzer check # Verify all 4 checks pass
# Add to PATH (required for Pulumi to discover the binary)
export PATH="$HOME/.finfocus/analyzer:$PATH"
# Run preview with costs
pulumi preview --policy-pack ~/.finfocus/analyzer
```
For persistent PATH, add the export to `~/.bashrc` or `~/.zshrc`.
**Windows (PowerShell):** Add to your PowerShell profile (`$PROFILE`):
```powershell
$env:PATH = "$env:USERPROFILE\.finfocus\analyzer;$env:PATH"
```
Restart PowerShell for changes to take effect.
## What `analyzer install` Does
1. Creates `~/.pulumi/plugins/analyzer-finfocus-v{VERSION}/pulumi-analyzer-finfocus`
(symlink on Unix, copy on Windows)
2. Creates `~/.finfocus/analyzer/PulumiPolicy.yaml` (runtime: finfocus)
3. Creates `~/.finfocus/analyzer/pulumi-analyzer-policy-finfocus` (Pulumi before
3.270.0)
4. Creates `~/.finfocus/analyzer/pulumi-language-finfocus` (Pulumi 3.270.0 and
later)
On Windows both pack entries end in `.exe`. Running `finfocus analyzer install`
again adds `pulumi-language-finfocus` to a pack that has only the older entry.
Use `--force` to reinstall after upgrading finfocus. Use `--target-dir` to
override the Pulumi plugin directory.
## Verification
```bash
finfocus analyzer check # Table output
finfocus analyzer check --output json # JSON for CI
```
Runs 4 sequential checks (later checks skip if earlier ones fail):
| Check | Verifies |
|-------|----------|
| `policy_pack_dir` | `~/.finfocus/analyzer/` exists |
| `pulumi_policy_yaml` | `PulumiPolicy.yaml` has `runtime: finfocus` |
| `binary_in_path` | `pulumi-analyzer-policy-finfocus` on PATH |
| `grpc_smoke_test` | `analyzer serve` starts and responds to RPC |
## Expected Output
```text
Policies:
finfocus@v0.3.3 (local: ~/.finfocus/analyzer)
- [advisory] cost-estimate (aws:ec2/instance:Instance: my-instance)
Estimated Monthly Cost: $7.50 USD (source: finfocus-plugin-aws)
- [advisory] stack-cost-summary (pulumi:pulumi:Stack: my-stack)
Total Estimated Monthly Cost: $7.50 USD (1 resources analyzed)
```
## CI/CD Usage
Pulumi has no environment variable that selects a local policy pack, so CI
passes the flag too:
```bash
export PATH="$HOME/.finfocus/analyzer:$PATH"
pulumi preview --policy-pack "$HOME/.finfocus/analyzer"
```
## Troubleshooting
See [references/troubleshooting.md](references/troubleshooting.md) for common
failure modes, PATH issues, version mismatches, plugin isolation, and config
tuning.
## Uninstall
```bash
finfocus analyzer uninstall # Remove from Pulumi plugin dir
finfocus analyzer uninstall --target-dir /custom/path
```
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 |